简介
Appium是一个开源的、跨平台的自动化测试工具,用于自动化移动应用程序的测试。它支持iOS、Android和Windows应用的测试。Appium的目标是提供一个测试框架,允许测试者在不同的平台上使用相同的API执行自动化测试,从而实现“一次编写,到处运行”的测试脚本。
核心特点
开源与跨平台: Appium是完全开源的,并且支持iOS、Android和Windows平台,通过使用WebDriver协议提供了一种统一的接口来与这些平台进行交互。
支持多种编程语言: 由于遵循了WebDriver协议,Appium支持所有实现了WebDriver的客户端库的编程语言,包括Java、Python、Ruby、JavaScript (Node.js)、C#等。
本地应用、混合应用和网页应用的测试: Appium不仅可以用于原生应用的测试,而且还支持移动Web应用和混合应用(即应用内嵌有Web视图的应用)的自动化测试。
无需修改应用: 测试移动应用时,无需对应用进行任何修改或重新编译即可进行测试。
工作原理
Appium工作原理基于客户端-服务器架构。Appium服务器是核心,它接受来自客户端(即编写测试脚本的环境)的连接,并与移动设备或模拟器上的应用进行交互进行测试。
服务端-appium server: Appium本身作为一个服务器运行,该服务器实现了WebDriver和Mobile JSON Wire Protocol标准。它接收来自客户端的连接和命令,处理这些命令,并将其转换为适合目标平台(iOS、Android或Windows)的动作。
客户端: 客户端是使用支持WebDriver库的任何语言编写的测试脚本。测式人员通过编写测试脚本并将其发送到Appium服务器来执行测试动作。
移动设备/模拟器: 测试可以在真实设备、模拟器或者仿真器上执行。Appium转换命令并与设备上的应用交互。
使用Appium进行自动化测试的一般步骤
环境设置: 安装Appium服务器和客户端库,配置测试环境。
启动Appium服务: 通过命令行或Appium Desktop启动Appium服务。
编写测试脚本: 使用支持的编程语言编写自动化测试脚本,脚本中包含测试逻辑。
运行测试脚本: 测试脚本连接到Appium服务器并开始执行测试,Appium服务器将命令转换为具体的设备动作。
获取测试结果: 脚本执行完毕后,通过检测应用的状态或获取屏幕截图等方式来验证测试结果。
环境设置
无线自动化需要安装android sdk,可按照文档操作: Android SDK安装无脑操作文档
安装和启动Appium Server
使用Node.js和npm安装Appium Server:
- 安装Node.js:
首先确保你已经安装了Node.js。你可以访问 Node.js 官方网站(https://nodejs.org/)并根据你的操作系统下载并安装相应版本的 Node.js。Node.js 的安装会包括 npm (Node package manager),它是用来管理 Node.js 包的工具。
也可以安装nvm,然后由nvm来管理node的版本:
nvm list
v8.9.1
v12.18.4
v14.17.5
v16.20.0
v18.12.0
-> v18.16.0
v18.17.1
我使用的是v18.16.0版本。
- 通过npm安装Appium:
打开命令行或终端,然后使用以下命令安装Appium:
npm install -g appium
-g 选项是用来全局安装Appium,这样你就可以从命令行的任意位置启动它。
启动Appium Server:
Appium安装完成后,可以通过以下命令启动Appium Server:
命令行启动
appium
默认情况下,Appium Server在 0.0.0.0:4723 的主机和端口上监听连接。
会输出如下日志:
[Appium] Welcome to Appium v2.5.1 (REV 9600617c52d0d2e48493424c529ac6c945d2775b)
[Appium] The autodetected Appium home path: /Users/tester/.appium
[Appium] Attempting to load driver xcuitest...
[Appium] Attempting to load driver uiautomator2...
[Appium] Requiring driver at /Users/tester/.appium/node_modules/appium-uiautomator2-driver/build/index.js
[Appium] Requiring driver at /Users/tester/.appium/node_modules/appium-xcuitest-driver/build/index.js
reusing global emitter
[Appium] AndroidUiautomator2Driver has been successfully loaded in 3.464s
[Appium] XCUITestDriver has been successfully loaded in 3.465s
[Appium] Appium REST http interface listener started on http://0.0.0.0:4723
[Appium] You can provide the following URLs in your client code to connect to this server:
[Appium] http://127.0.0.1:4723/ (only accessible from the same host)
[Appium] http://192.168.1.34:4723/
[Appium] http://30.13.154.42:4723/
[Appium] Available drivers:
[Appium] - xcuitest@4.26.0 (automationName 'XCUITest')
[Appium] - uiautomator2@2.24.0 (automationName 'UiAutomator2')
[Appium] Available plugins:
[Appium] - execute-driver@3.0.12
[Appium] - images@2.0.10
[Appium] - relaxed-caps@1.0.5
[Appium] - universal-xml@1.0.8
[Appium] - device-farm@7.3.0
[Appium] - ocr@0.1.3
[Appium] - appium-reporter-plugin@1.1.0-beta.01
[Appium] No plugins activated. Use the --use-plugins flag with names of plugins to activate
使用Appium Desktop安装和启动Appium Server:
Appium Desktop 是一个包含Appium Server和图形用户界面的应用程序,它可以让你更方便地启动、管理和监控Appium Server。如果你不想使用appium在命令行启动appium server,也可以使用Appium Desktop来启动server,以下是具体步骤:
下载Appium Desktop:
访问Appium Desktop的发布页面(https://github.com/appium/appium-desktop/releases/),下载最新版本的Appium Desktop,适应于你的操作系统(Windows、macOS或Linux)。安装Appium Desktop:
下载完成后,根据你的操作系统进行安装。
在Windows上,运行安装程序并按照指示完成安装。
在macOS上,通常是将下载的 .dmg 文件拖动到 Applications 文件夹中。
在Linux上,可能需要调整文件权限使得其可执行,并且根据发行版不同操作也有所不同。启动Appium Desktop:
打开Appium Desktop应用程序,并且点击"Start Server"按钮来启动Appium Server。你也可以指定不同的主机和端口以及其它高级设置。连接到Appium Server:
当Appium Server启动后,你可以通过Appium的客户端库连接到它,并运行你的自动化测试脚本。
无论使用命令行还是Appium Desktop,一旦Appium Server启动,你都需要确保已经设置好正确的环境,比如为Android测试正确地配置了ANDROID_HOME环境变量,为iOS测试安装了Xcode等,然后你就可以开始使用Appium进行自动化测试了。
使用代码启动appium server
appium java-client提供了一种可以使用代码启动appium server的方法:
AppiumDriverLocalService service = AppiumDriverLocalService.buildDefaultService();
service.start();
try {
// do stuff with drivers
} finally {
service.stop();
}
查看AppiumDriverLocalService#start方法,本质上是另外启动了一个nodejs进程
public void start() throws AppiumServerHasNotBeenStartedLocallyException {
// 其他代码
try {
ExternalProcess.Builder processBuilder = ExternalProcess.builder().command(this.nodeJSExec.getCanonicalPath(), this.nodeJSArgs).copyOutputTo(this.stream);
Map var10000 = this.nodeJSEnvironment;
Objects.requireNonNull(processBuilder);
var10000.forEach(processBuilder::environment);
this.process = processBuilder.start();
} catch (IOException var18) {
throw new AppiumServerHasNotBeenStartedLocallyException(var18);
}
//其他代码
}
编写测试代码
我们还是先以java代码来编写测试代码
测试工程的代码依赖
<dependency>
<groupId>io.appium</groupId>
<artifactId>java-client</artifactId>
<version>9.2.2</version>
</dependency>
<dependency>
<groupId>org.seleniumhq.selenium</groupId>
<artifactId>selenium-remote-driver</artifactId>
<version>4.19.1</version>
</dependency>
<dependency>
<groupId>org.seleniumhq.selenium</groupId>
<artifactId>selenium-api</artifactId>
<version>4.19.1</version>
</dependency>
<dependency>
<groupId>org.seleniumhq.selenium</groupId>
<artifactId>selenium-http</artifactId>
<version>4.19.1</version>
</dependency>
同时pom文件添加如下仓库配置
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
java测试代码
以下代码是一段对android手机进行滑动的代码片段:
package com.namedlock;
import com.namedlock.hsf.NamedThreadFactory;
import io.appium.java_client.TouchAction;
import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.android.options.UiAutomator2Options;
import org.openqa.selenium.Dimension;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.LinkedBlockingQueue;
import java.util.concurrent.ThreadPoolExecutor;
import java.util.concurrent.TimeUnit;
import static io.appium.java_client.touch.WaitOptions.waitOptions;
import static io.appium.java_client.touch.offset.PointOption.point;
import static java.time.Duration.ofMillis;
public class TestAppium {
static private ExecutorService executorService = new ThreadPoolExecutor(100, 1000, 60L, TimeUnit.SECONDS,
new LinkedBlockingQueue<Runnable>(100), new NamedThreadFactory("YunBeiDeviceExecutors"), new ThreadPoolExecutor.AbortPolicy());
public static void main(String[] args) throws MalformedURLException {
UiAutomator2Options options = new UiAutomator2Options()
.setUdid("YJL4C18A22009669");
// .setApp("/home/myapp.apk");
AndroidDriver driver = new AndroidDriver(
// The default URL in Appium 1 is http://127.0.0.1:4723/wd/hub
new URL("http://127.0.0.1:4723"), options
);
long start = System.currentTimeMillis();
// executorService.execute(() -> {
// verticalSwipeByPercentages(driver, 0.6, 0.2, 0.5);
// });
verticalSwipeByPercentages(driver, 0.6, 0.3, 0.1);
long last = System.currentTimeMillis();
System.out.println("Time: " + (last - start) + "ms");
verticalSwipeByPercentages(driver, 0.6, 0.3, 0.1);
System.out.println("Time: " + (System.currentTimeMillis() - last) + "ms");
last = System.currentTimeMillis();
verticalSwipeByPercentages(driver, 0.6, 0.3, 0.1);
System.out.println("Time: " + (System.currentTimeMillis() - last) + "ms");
last = System.currentTimeMillis();
verticalSwipeByPercentages(driver, 0.6, 0.3, 0.1);
System.out.println("Time: " + (System.currentTimeMillis() - last) + "ms");
}
static public void verticalSwipeByPercentages(AndroidDriver driver, double startPercentage, double endPercentage, double anchorPercentage) {
Dimension size = driver.manage().window().getSize();
int anchor = (int) (size.width * anchorPercentage);
int startPoint = (int) (size.height * startPercentage);
int endPoint = (int) (size.height * endPercentage);
new TouchAction(driver)
.press(point(anchor, startPoint))
.waitAction(waitOptions(ofMillis(100)))
.moveTo(point(anchor, endPoint))
.release().perform();
}
}
扩展内容:WebDriver协议
WebDriver 协议是一个由 W3C (World Wide Web Consortium) 标准化的 Web 测试接口,它定义了浏览器或其他自动化测试工具中使用的一系列 HTTP 请求,这些工具可以通过这些 HTTP 请求来控制浏览器和查询其状态。最初由 Selenium 项目提出并开发,WebDriver 后来成为了 W3C 的一个正式推荐标准。
WebDriver 协议允许用户使用各种编程语言编写自动化测试脚本来模拟用户与网页的交云动,如点击按钮、填写表单、获取页面元素信息等。通过 WebDriver,可以自动执行这些模拟的用户动作,而且是在真实的浏览器环境中进行。
WebDriver 协议主要特点:
与浏览器无关:WebDriver 协议旨在对所有支持的浏览器提供一致的接口。
语言无关性:虽然 WebDriver 本身是一个HTTP RESTful API,但通过对应的客户端库(Selenium WebDriver),几乎所有流行的编程语言都可以与 WebDriver 协议进行交云动,包括 Java、Python、C#、Ruby、JavaScript 等。
支持多种浏览器驱动:为了支持各种主流浏览器(如 Chrome、Firefox、Safari 和 Edge),WebDriver 协议由各种浏览器的专有驱动来实现,例如 Chromedriver、Geckodriver、Safaridriver 和 Edgedriver。
WebDriver 协议基本元素:
- Session:一个测试会话的创建、管理和删除。一次自动化测试任务通常只有一个会话。
- Element:指在页面中可被云动化的对象(通常是 DOM 元素)。
- Commands:一系列动作,比如 ‘navigate to’, ‘click’, ‘sendKeys’。
- Capabilities:在启动浏览器会话时定义的所需的浏览器特性(如浏览器类型、版本和一些行为特性)。
WebDriver 协议工作流程:
客户端测试脚本调用 WebDriver 客户端库来创建一个新的浏览器会话,并且定义所需的浏览器特性。
客户端库将这个请求作为 HTTP POST 请求发送到 WebDriver server (对应的浏览器驱动)。
WebDriver server 接收并处理请求,创建一个新的浏览器实例,该实例的特性符合请求中的 capabilities,并且将 session id 返回给客户端。
客户端使用 session id 将后续的命令发送到 WebDriver server,比如导航到一个 URL 或者点击页面上的元素。
WebDriver server 转译客户端发送的命令,将其转化成浏览器能够理解并执行的动作。
浏览器执行这些动作后,WebDriver server 会将结果返回给客户端。
测试结束时,客户端会发送一个请求关闭会话,WebDriver server 会关闭浏览器实例并释放资源。
WebDriver 的在不同编程语言的实现被称为“绑定(bindings)”,而这些绑定与 WebDriver 协议进行交云动,使得写出的自动化脚本不用担心具体细节,可以直接向 WebDriver server 发送命令。这种设计使 WebDriver 协议成为了自动化 Web 测试领域的事实标准,被广大测试工程师接受和采用。
参考资料及文档
Appium是一个非常流行的移动自动化测试框架,如果您希望深入学习Appium或仅仅是希望了解关于它的更多信息,以下是一些非常有用的资源和文档:
官方资源
- Appium官网: http://appium.io/
Appium的官方网站提供最基本的介绍、安装指南以及官方的文档链接。 - Appium文档: https://appium.io/docs/en/about-appium/intro/
这里是Appium官方的文档,涵盖了从基本的安装、设置到高级主题如平台特定的配置等。 - Appium GitHub存储库: https://github.com/appium/appium
在GitHub上,您找到Appium的源代码,以及关于正在开发的功能、bug修复和版本发布信息。
学习资源和教程
- Test Automation University - Appium课程(https://testautomationu.applitools.com/appium-tutorial/)
提供免费的Appium课程,从基础知识到进阶使用都有详细介绍。 - Appium Pro(https://appiumpro.com)
由Appium的一些核心贡献者运行,提供了一系列的专业文章和技巧。
视频教程
YouTube上的Appium教程
YouTube 上有许多关于Appium的免费视频教程,涵盖不同的主题和难易程度。
社区和支持
6. Appium讨论论坛: https://discuss.appium.io/
Appium的官方社区,可以提问、分享经验和跟进最新的Appium动态。
7. Stack Overflow
使用appium标签的问题和回答区,您可以在这里提出具体的问题,或者帮助他人解答。
不同资源有不同的侧重点,在开始学习Appium的旅程时,建议多方位尝试,找到最适合自己学习方式的资源。随着对Appium的更深入了解,参与社区讨论和贡献也是提升技能的好方法。