Appium：修订间差异

2022年9月22日 (四) 04:05的最新版本

Appium是一个开源的应用测试自动化框架，支iOS、Android和Windows平台上的应用，包括原生应用、移动Web应用和混合应用。

简介

时间轴

原理

了解更多 >> Appium 中文文档：Appium 介绍

安装

Appium可以通过npm安装或下载Appium Desktop安装桌面版。

Appium Desktop

https://github.com/appium/appium-desktop/releases 页面下载最新Appium桌面版。
点击安装。
启动Appium，点击启动服务即可。

了解更多 >> Appium 文档：Appium 介绍

使用npm安装

$ npm install -g appium
$ appium

了解更多 >> Appium 文档：Appium 介绍

不同语言客户端

根据使用的语言安装Appium客户端，用于连接操作Appium。

语言 / 框架	安装	Github 仓库
Python	`pip install Appium-Python-Client`	https://github.com/appium/python-client
Java		https://github.com/appium/java-client
C# (.NET)		https://github.com/appium/appium-dotnet-driver
Ruby		https://github.com/appium/ruby_lib, https://github.com/appium/ruby_lib_core

驱动

名称	描述	网站
Uiautomator2




WinAppDriver

辅助工具

名称	描述	官网
Appium Inspector	UI分析软件，查看和定位手机应用或windows软件的元素的信息。安装：https://github.com/appium/appium-inspector/releases 页面下载最新版本安装	https://github.com/appium/appium-inspector
Inspect	UI分析软件，查看windows软件的元素的信息。Inspect.exe包含在Windows SDK中。安装或在C:\Program Files (x86)\Windows Kits\10\bin目录中搜索inspect，选择对应平台的inspect.exe打开即可。	https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/ https://learn.microsoft.com/en-us/windows/win32/winauto/inspect-objects
Accessibility Insights

快速入门

测试Android应用

测试iOS应用

测试Windows应用

以Python语言示例。安装好以下软件：

Appium（已经附带WinAppDriver）
Appium-Python-Client
Selenium (软件)

打开一个记事本，输入hello，world

1.启动Appium服务器
2.新建一个text.pyw文件，输入如下代码，并运行。

from appium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.common.keys import Keys

desired_caps = {}
desired_caps['app'] = r"C:\Windows\System32\notepad.exe"
desired_caps['platformName'] = "Windows"
driver = webdriver.Remote(
    command_executor='http://127.0.0.1:4723/wd/hub',
    desired_capabilities=desired_caps)
driver.find_element(By.NAME, '文本编辑器').send_keys("hello, world").send_keys(Keys.ENTER)

常见错误：

Message: The requested resource could not be found, or a request was received using an HTTP method that is not supported by the mapped resource

Appium默认监听地址为http://127.0.0.1:4723/wd/hub，如果Python中输入的是http://127.0.0.1:4723或http://127.0.0.1:4723/wd/hub/就会出现上面错误。

Message: Bad capabilities. Specify either app or appTopLevelWindow to create a session

如果直接使用微软的WinAppDriver监听，Appium-Python-Client 2 的生成capabilities增加了"appium:，与WinAppDriver的capabilities格式不一致，如：{"capabilities": {"firstMatch": [{}], "alwaysMatch": {"appium:app": .......。解决办法，直接使用appium服务器（自带WinAppDriver）或者安装Appium-Python-Client 1。

资源

官网

Appium 官网： http://appium.io/
Appium 文档：https://appium.io/docs/en/about-appium/intro/
Appium 中文文档：https://appium.io/docs/cn/about-appium/intro/
Appium 源代码：https://github.com/appium/appium
Appium Desktop 源代码：https://github.com/appium/appium-desktop
Appium Inspector 源代码：https://github.com/appium/appium-inspector

@@ 第4行： / 第4行： @@
 ===时间轴===
+===原理===
+{{#drawio:Appium原理}}
+{{了解更多
+|[https://appium.io/docs/cn/about-appium/intro/ Appium 中文文档：Appium 介绍]
+}}
 ===安装===
 Appium可以通过[[npm]]安装或下载Appium Desktop安装桌面版。
@@ 第52行： / 第57行： @@
 |[https://appium.io/docs/cn/about-appium/appium-clients/ Appium 中文文档：支持 Appium 服务器的客户端程序库列表]
 }}
+=== 驱动 ===
+{| class="wikitable"
+! 名称
+! 描述
+! 网站
+|-
+| [[Uiautomator2]]
+|
+|
+|-
+|
+|
+|
+|-
+|
+|
+|
+|-
+|
+|
+|
+|-
+|
+|
+|
+|-
+| [[WinAppDriver]]
+|
+|
+|}
+===辅助工具===
+{| class="wikitable"
+! 名称
+! 描述
+! 官网
+|-
+| Appium Inspector
+| UI分析软件，查看和定位手机应用或windows软件的元素的信息。  <br />安装：https://github.com/appium/appium-inspector/releases 页面下载最新版本安装
+| https://github.com/appium/appium-inspector
+|-
+| Inspect
+|  UI分析软件，查看windows软件的元素的信息。Inspect.exe包含在Windows SDK中。安装或在C:\Program Files (x86)\Windows Kits\10\bin目录中搜索inspect，选择对应平台的inspect.exe打开即可。
+| https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/  https://learn.microsoft.com/en-us/windows/win32/winauto/inspect-objects
+|-
+| Accessibility Insights
+|
+|
+|}
 ==快速入门==
@@ 第60行： / 第115行： @@
 ===测试Windows应用===
 以[[Python]]语言示例。安装好以下软件：
-*Appium
+*Appium（已经附带[[WinAppDriver]]）
-*[[WinAppDriver]]
 *Appium-Python-Client
 *[[Selenium (软件)]]
+打开一个记事本，输入hello，world
+*1.启动Appium服务器
+*2.新建一个text.pyw文件，输入如下代码，并运行。
+<syntaxhighlight lang="python" >
+from appium import webdriver
+from selenium.webdriver.common.by import By
+from selenium.webdriver.common.keys import Keys
+desired_caps = {}
+desired_caps['app'] = r"C:\Windows\System32\notepad.exe"
+desired_caps['platformName'] = "Windows"
+driver = webdriver.Remote(
+    command_executor='http://127.0.0.1:4723/wd/hub',
+    desired_capabilities=desired_caps)
+driver.find_element(By.NAME, '文本编辑器').send_keys("hello, world").send_keys(Keys.ENTER)
+</syntaxhighlight>
+常见错误：
+<syntaxhighlight lang="text" >
+Message: The requested resource could not be found, or a request was received using an HTTP method that is not supported by the mapped resource
+</syntaxhighlight>
+Appium默认监听地址为<code><nowiki>http://127.0.0.1:4723/wd/hub</nowiki></code>，如果Python中输入的是<code><nowiki>http://127.0.0.1:4723</nowiki></code>或<code><nowiki>http://127.0.0.1:4723/wd/hub/</nowiki></code>就会出现上面错误。
+<syntaxhighlight lang="text" >
+Message: Bad capabilities. Specify either app or appTopLevelWindow to create a session
+</syntaxhighlight>
+如果直接使用微软的WinAppDriver监听，Appium-Python-Client 2 的生成capabilities增加了<code>"appium:</code>，与WinAppDriver的capabilities格式不一致，如：<code>{"capabilities": {"firstMatch": [{}], "alwaysMatch": {"appium:app": .......</code>。解决办法，直接使用appium服务器（自带WinAppDriver）或者安装Appium-Python-Client 1。
 {{了解更多
+|[https://appium.io/docs/en/drivers/windows/  Appium 文档：Windows]
 |[https://appium.io/docs/cn/writing-running-appium/running-tests/#appium-windows Appium 中文文档：运行测试\使用 Appium 运行你的测试程序（Windows）]
 |[https://github.com/microsoft/WinAppDriver/blob/master/Docs/UsingAppium.md WinAppDriver 文档：您可以单独使用WinAppDriver ，也可以与Appium一起使用]
@@ 第80行： / 第161行： @@
 *Appium 源代码：https://github.com/appium/appium
 *Appium Desktop 源代码：https://github.com/appium/appium-desktop
+*Appium Inspector 源代码：https://github.com/appium/appium-inspector
 ===网站===