查看“Appium”的源代码

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

==简介==
===时间轴===

===原理===
{{#drawio:Appium原理}}
{{了解更多
|[https://appium.io/docs/cn/about-appium/intro/ Appium 中文文档：Appium 介绍]
}}
===安装===
Appium可以通过[[npm]]安装或下载Appium Desktop安装桌面版。

==== Appium Desktop ====
*https://github.com/appium/appium-desktop/releases 页面下载最新Appium桌面版。
*点击安装。
*启动Appium，点击启动服务即可。 
{{了解更多
|[https://appium.io/docs/en/about-appium/getting-started/index.html Appium 文档：Appium 介绍]
}}

====使用npm安装====
<syntaxhighlight lang="bash" >
$ npm install -g appium
$ appium
</syntaxhighlight>
{{了解更多
|[https://appium.io/docs/en/about-appium/getting-started/index.html Appium 文档：Appium 介绍]
}}

====不同语言客户端====
根据使用的语言安装Appium客户端，用于连接操作Appium。
{| class="wikitable" 
|-
! 语言 / 框架
! 安装
! Github 仓库
|-
| Python
| <code>pip install Appium-Python-Client</code>
| 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
|}

{{了解更多
|[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
| 
| 
|}

==快速入门==
===测试Android应用===

===测试iOS应用===

===测试Windows应用===
以[[Python]]语言示例。安装好以下软件：
*Appium（已经附带[[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一起使用]
|[https://github.com/microsoft/WinAppDriver/tree/master/Samples/Python WinAppDriver 示例： Python/CalculatorTest]
}}

==资源==
===官网===
*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

===网站===