Skip to content

环境安装与使用

简介

下面是 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 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

{.hidden .audio .subtitle}

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

{.hidden .audio .subtitle}

Android 环境验证

  • 进入命令行
  • 输入 adb --version
  • 输出版本号信息即成功

{.hidden .audio .subtitle}

Node.js

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

{.hidden .audio .subtitle}

环境验证

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

  • node -v
  • npm -v

{.hidden .audio .subtitle}

Appium 服务端

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

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

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

{.hidden .audio .subtitle}

Appium GUI

{.hidden .audio .subtitle}

Appium Server

Appium Server 2.x 安装

  • 命令行输入 npm install -g appium
  • 安装后输入 appium，成功启动会显示如下内容：[Appium] Welcome to Appium v2.0.0

{.hidden .audio .subtitle}

安装驱动

  • 注意：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"]

{.hidden .audio .subtitle}

安装 appium-doctor（可选）

  • 注意：可选，用来验证 appium 环境
  • 命令行输入：npm install -g appium-doctor
  • 安装后输入：appium-doctor，成功显示如下内容并且所需环境前方为 "√"，即为安装成功。

{.hidden .audio .subtitle}

Appium Server 1.x 和 2.x 的版本差异

  1. 默认服务器基本路径：Appium 1 默认接受 http://localhost:4723/wd/hub 的命令，仅是 Selenium1 迁移到 Selenium2 时遗留下来的约定，并且不再和 Selenium 强绑定的关系。因此，Appium2 的默认基本路径现在是 /。
  2. 单独安装驱动程序：Appium 1 所有可用的驱动程序与主 Appium 服务同时安装。

{.hidden .audio .subtitle}

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

  • 和 Appium 分开安装：
    appium driver install uiautomator2
    appium driver install xcuitest@4.12.2
  • 和 Appium 一起安装：
    npm i -g appium --dirvers=xuitest,uiautomator2

{.hidden .audio .subtitle}

  1. 驱动安装路径

  2. Appium 1，驱动程序与 Appium 服务器同时安装，位于 /path/to/appium/node_modules

  3. Appium 2，在 APPIUM_HOME 环境变量定义的路径中安装此类依赖项，默认路径是 ~/.appium

{.hidden .audio .subtitle}

  1. capability 需要加前缀

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

{.hidden .audio .subtitle}

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

  • appium:app
  • appium:noReset
  • appium:deviceName

{.hidden .audio .subtitle}

  1. 图像分析功能移至插件

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

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

  • 安装插件：appium plugin install images
  • 运行插件：appium --use-plugins=images

{.hidden .audio .subtitle}

  1. 支持配置文件

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

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

{.hidden .audio .subtitle}

Appium Inspector

{.hidden .audio .subtitle}

Appium 客户端

python 客户端安装

pip install Appium-Python-Client

{.hidden .audio .subtitle}

java 客户端安装

<dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>8.0.0-beta</version>
</dependency>

{.hidden .audio .subtitle}

安装移动设备平台工具

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

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

  • Android 平台：安装 Android SDK，并使用 Android SDK Manager 安装所需的平台版本和工具。

  • iOS 平台：对于 iOS 设备测试，需要安装 Xcode，并配置所需的 iOS 模拟器或真机设备。

{.hidden .audio .subtitle}

Andriod 模拟器 mumu

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

{.hidden .audio .subtitle}

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

{.hidden .audio .subtitle}

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

{.hidden .audio .subtitle}

总结

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

{.hidden .audio .subtitle}