Skip to content

Appium环境安装与使用

环境安装与使用

简介

下面是 Appium 服务安装及后续代码测试所需基本环境的具体安装步骤。

JDK 环境 在 Appium 中，UiAutomator2 通过 Java 编写与 Android 应用程序进行交互，因此需要配置 JDK 环境。可以参考安装教程贴进行安装。

Android SDK 环境 Appium 使用 Android SDK 与 Android 设备通信、管理模拟器或物理设备，并执行 App 自动化测试。为了测试 Android 应用程序，需要安装 Android SDK，并确保在测试环境中正确配置了相应的路径和环境变量。

Node.js 环境 安装命令行版本的 Appium Server 需要 Node.js 环境。建议使用版本 14.17.0、16.13.0 或不小于 18.0.0。确保正确安装 Node.js 以便启动 Appium 服务。

Appium 服务 在 2.x 版本之前，Appium 提供了命令行版本和图形化版本两种安装方式，但在 2.x 更新后，只提供了命令行版本。用户可以选择其中一种进行安装。

Appium Inspector 环境 在测试过程中，使用 Appium Inspector 工具辅助元素定位。确保安装并配置 Appium Inspector，以便在测试过程中准确定位 App 的元素。

Appium 客户端环境 根据选择的编程语言，需要安装相应的 Appium 客户端库。这些库提供了与 Appium 服务器进行通信的 API 和方法，以便于编写测试脚本。

移动设备平台工具 在测试过程中，可以选择使用真机或模拟器。确保配置和优化所选平台的工具，以便进行有效的测试。

安装步骤

以下是上述所需环境的具体安装步骤。

Android SDK

安装 Android SDK
方式一：直接安装 SDK

直接下载 SDK 压缩包，可能会有版本不兼容的问题，不推荐。

  • SDK Manager -> SDK Tools
  • 解压好的 sdk 其实就是一个文件夹，配置好环境变量就可以直接使用

方式二：使用 Android Studio 安装 Android SDK

可以选择 SDK 工具的版本，推荐方式。

通过官网下载 Android Studio 对应版本后，直接安装：官网下载地址。

安装时会进行环境的初始化，使用标准安装即可。

在 AndroidStudio 欢迎界面打开 SDKmanager ，在 SDK Tools 目录下安装如下进行安装：

配置 Android 环境变量

Windows 配置 Android 环境

  • 新增 ANDROID_HOME 系统变量
    • 变量名：ANDROID_HOME
    • 变量值：D:\adt-bundle-mac-x86\*.64-20140702\sdk（SDK 安装的根目录）

  • 修改 Path 变量
    • %ANDROID_HOME%\emulator
    • %ANDROID_HOME%\platform-tools
    • %ANDROID_HOME%\tools
    • %ANDROID_HOME%\tools\bin

MacOS 配置 Android 环境

修改 .bash_profile：

# .bash_profile

# Setting PATH for ANDROID_HOME
export ANDROID_HOME=/Users/mac/Library/Android/sdk
export PATH=$ANDROID_HOME/emulator:$PATH
export PATH=$ANDROID_HOME/platform-tools:$PATH
export PATH=$ANDROID_HOME/tools:$PATH
export PATH=$ANDROID_HOME/tools/bin:$PATH
export PATH=$ANDROID_HOME/build-tools/29.0.1:$PATH
Android 环境验证
  • 进入命令行
  • 输入 adb --version
  • 输出版本号信息即成功

Node.js

安装
  • 官网下载地址
  • 网盘地址
  • 安装过程中在如下图的界面需要选择 Add to PATH 选项（点击选项，蓝色高亮），选中会自动配置环境变量。

环境验证

命令行输入以下两条命令，成功出现如图所示的版本号即为安装成功。

  • node -v
  • npm -v

Appium 服务端

Appium 服务端有 GUI 版本，也有命令行版本。目前 GUI 版本官方已经停止更新，对应的是 Appium 1.x 版本的服务端。

Appium 命令行版本的服务端目前官方已经更新到了 2.x 版本，以下会以 2.x 版本为例介绍命令行版本服务端的安装方式。

无论是 GUI 版本还是命令行版本，都是 Appium 服务端。使用时，二选一即可。

Appium GUI

Appium Server
Appium Server 2.x 安装
  • 命令行输入 npm install -g appium
  • 安装后输入 appium，成功启动会显示如下内容：[Appium] Welcome to Appium v2.0.0
安装驱动
  • 注意：Appium Server 2.x 版本必须单独安装
  • 命令行输入：appium driver install uiautomator2
  • 再次启动 appium，成功安装会显示如下内容：
Attempting to find and install driver 'uiautomator2'
✔ Installing 'uiautomator2' using NPM install spec 'appium-uiautomator2-driver'
Driver uiautomator2@2.0.5 successfully installed
- automationName: UiAutomator2
- platformNames: ["Android"]
安装 appium-doctor（可选）
  • 注意：可选，用来验证 appium 环境
  • 命令行输入：npm install -g appium-doctor
  • 安装后输入：appium-doctor，成功显示如下内容并且所需环境前方为 "√"，即为安装成功。

Appium Server 1.x 和 2.x 的版本差异
  1. 默认服务器基本路径

Appium 1 默认接受 http://localhost:4723/wd/hub 的命令，仅是 Selenium1 迁移到 Selenium2 时遗留下来的约定，并且不再和 Selenium 强绑定的关系。因此，Appium2 的默认基本路径现在是 /。

  1. 单独安装驱动程序

Appium 1 所有可用的驱动程序与主 Appium 服务同时安装。

Appium 2 将驱动程序拆出 Appium 的安装，这样 Appium 的服务安装会更加的轻便。用户可根据自己的需求安装相应的驱动程序。安装有两种方式：

  • 和 Appium 分开安装
appium driver install uiautomator2
appium driver install xcuitest@4.12.2
  • 和 Appium 一起安装
npm i -g appium --dirvers=xuitest,uiautomator2
  1. 驱动安装路径
  • Appium 1，驱动程序与 Appium 服务器同时安装，位于 /path/to/appium/node_modules
  • Appium 2，在 APPIUM_HOME 环境变量定义的路径中安装此类依赖项，默认路径是 ~/.appium
  1. capability 需要加前缀

capabilities 之前称为 desired capabilities ，和之前最大的区别是任何非标准功能都需要供应商前缀，标准功能是在 WebDriver 协议中给出的。常用的有 browserName 和 platformName 等。

其它的功能名称中需要包含 供应商前缀，前缀的格式是 前缀: ，例如 Appium:。Appium 中的大多数 capabilities 都超出了标准的 W3C 功能，例如：

  • appium:app
  • appium:noReset
  • appium:deviceName
  1. 图像分析功能移至插件

Appium2 的设计目标之一是将非核心功能拆离到插件中，这使得 Appium Server 的安装变得更加的容易，用户可根据所需要的功能选择是否下载对应的插件。Appium 各种和图像相关的功能已经移至 images 的插件中。

使用这个插件需要安装并启动时运行该插件：

  • 安装插件：appium plugin install images
  • 运行插件：appium --use-plugins=images
  1. 支持配置文件

Appium2 不仅支持命令行参数，新版本的更新也增加了对配置文件的支持。配置文件可以是 JSON、JS 或 YAML 格式。

Appium 会从当前工作路径的根路径下搜索配置文件，可以指定自定义：appium --config-file /path/to/config/file

Appium Inspector

推荐安装 2022 年 6 月的版本。

Appium 客户端

python 客户端安装
pip install Appium-Python-Client
java 客户端安装
<dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>8.0.0-beta</version>
</dependency>

安装移动设备平台工具

需要根据要测试的移动设备平台（如 Android 或 iOS），安装相应的平台工具和驱动程序。

  • Android 平台：安装 Android SDK，并使用 Android SDK Manager 安装所需的平台版本和工具。
  • iOS 平台：对于 iOS 设备测试，需要安装 Xcode，并配置所需的 iOS 模拟器或真机设备。

确保平台工具和驱动程序已正确安装并配置，以便与 Appium 进行通信和控制。

Andriod 模拟器 mumu
  • 官网：https://mumu.163.com/
  • 网盘地址
  • 下载后直接安装即可使用，下载成功后打开如图所示

  • 目前模拟器呈现的界面并不是希望的手机界面，通过以下设置，把它调整成手机大小，找到界面右上角进入设置中心

  • 通过界面设置 选择 1280*720 就是手机屏幕的大小，选择后进行保存即可，保存后需要重启即可边更改为手机大小。

总结

完成以上步骤后，Appium 环境就安装好了。可以启动 Appium 服务器，并使用相应的客户端库编写和执行自动化测试脚本。