IT评测·应用市场-qidao123.com技术社区

标题: Android移动端自动化测试入门指南（保姆级教程，包学会的） [打印本页]

作者: 火影 时间: 2025-4-20 19:57
标题: Android移动端自动化测试入门指南（保姆级教程，包学会的）
目次

第一步：搭建基础环境
1. 安装 Android Studio
2. 设置环境变量
3. 假如你已经安装了Android studio，只是没有设置，可以按下面的步骤
1). 打开 Android Studio 的 SDK Manager
Windows/macOS：
Linux（无 Android Studio GUI）：使用命令行工具 sdkmanager（位于 /cmdline-tools/latest/bin）：
2). 安装缺失的组件
安装Android SDK：
安装Android Emulator：
安装Platform Tools（含 ADB）：
3). 验证组件是否安装成功
(1) 查抄安装路径
(2) 命令行验证
4)设置环境变量（关键步骤）
5). 创建模拟器（AVD）
第二步：创建 Android 虚拟设备（AVD）
1. 使用 Android Studio 创建模拟器
2. 通过命令行启动模拟器
第三步：安装 Appium（详细步骤）
1. 安装 Node.js和npm
2. 安装 Appium Server
3. 安装 Appium 客户端库（以 Python 为例）
4. 安装 Appium Desktop（可选）
5.安装 Appium Doctor（环境验证工具）
6.启动 Appium Server
1. 命令行启动
若提示 Could not start REST http interface listener，可能是端口冲突，可指定其他端口：
2. Appium Desktop 启动
第四步：预备待测应用
1. 获取 APK 文件
第五步：编写第一个自动化测试脚本
1. 启动 Appium Server
2. 编写 Python 测试脚本
3. 运行脚本
第六步：定位元素
1. 使用 Appium Inspector
2. 常用定位方式
第七步：处理常见标题
1. 设备未毗连
2. 元素定位失败
3. 真机测试
第八步：集成到 CI/CD（可选）
1. 使用 GitHub Actions
2. 使用云测试平台
学习资源推荐

第一步：搭建基础环境

1. 安装 Android Studio

作用：获取 Android SDK、模拟器（Emulator）和开发工具。
步骤：
- 访问 Android Studio 官网下载安装包。
- 安装时勾选以下组件：
  - Android SDK
  - Android Emulator
  - Platform Tools（包含 ADB 工具）
- 安装完成后，打开 Android Studio，进入 More Actions → SDK Manager，确保安装以下内容：
  - Android 版本：选择你的应用支持的 Android 版本（如 Android 13）。
  - SDK Tools：勾选 Android SDK Command-line Tools 和 Google USB Driver（用于真机调试）。

2. 设置环境变量

作用：让系统命令行能辨认 adb、emulator 等工具。
步骤：
- 找到 Android SDK 的安装路径（默认路径）：
  - Windows: C:\Users\<用户名>\AppData\Local\Android\Sdk
  - macOS/Linux: ~/Library/Android/sdk 或 /usr/local/android/sdk
- 将以下路径添加到系统环境变量 PATH 中：
  1. # Android 平台工具
  2. <SDK路径>/platform-tools
  3. # Android 模拟器
  4. <SDK路径>/emulator
  5. # Android 命令行工具
  6. <SDK路径>/cmdline-tools/latest/bin
  复制代码
- 验证设置是否成功：
  1. adb devices # 查看连接的设备
  2. emulator -list-avds # 查看已安装的模拟器
  复制代码

3. 假如你已经安装了Android studio，只是没有设置，可以按下面的步骤

1). 打开 Android Studio 的 SDK Manager

Windows/macOS：
- 打开 Android Studio。
- 点击顶部菜单栏的 Tools → SDK Manager。
- 进入 SDK Platforms 和 SDK Tools 标签页安装所需组件。
Linux（无 Android Studio GUI）：
使用命令行工具 sdkmanager（位于 <SDK路径>/cmdline-tools/latest/bin）：
1. # 列出已安装和可安装的包
2. sdkmanager --list
3. # 安装缺失组件
4. sdkmanager "platform-tools" "emulator" "platforms;android-33"
复制代码
2). 安装缺失的组件
安装Android SDK：
步骤：
- 在 SDK Manager 的 SDK Platforms 标签页：
  - 勾选你需要的 Android 版本（比方 Android 13 (Tiramisu) API Level 33）。
  - 确保勾选下方的 Show Package Details，并选中 Android SDK Platform 和 Sources for Android 33。
- 点击 Apply 开始安装。
安装Android Emulator：
步骤：
- 切换到 SDK Tools 标签页。
- 勾选 Android Emulator（假如未安装，右侧会表现 "Not installed"）。
- 点击 Apply 安装。
安装Platform Tools（含 ADB）：
步骤：
- 在 SDK Tools 标签页：
  - 勾选 Android SDK Platform-Tools（包含 adb, fastboot 等工具）。
- 点击 Apply 安装。
3). 验证组件是否安装成功

(1) 查抄安装路径
默认路径：
- Android SDK 根目次：
  - Windows: C:\Users\<用户名>\AppData\Local\Android\Sdk
  - macOS: ~/Library/Android/sdk
  - Linux: ~/Android/Sdk
- 关键子目次：
  - platform-tools/：包含 adb、fastboot。
  - emulator/：包含 emulator 可执行文件。
  - platforms/android-33/：Android 13 SDK。
(2) 命令行验证

打开终端（Windows 用 CMD/PowerShell），运行以下命令：
1. # 检查 adb 是否可用
2. adb --version
3. # 输出示例：Android Debug Bridge version 1.0.41
5. # 检查 emulator 是否可用
6. emulator -list-avds
7. # 输出已创建的模拟器列表（如果尚未创建则为空）
9. # 检查 Android SDK 版本
10. sdkmanager --list | findstr "platforms;android-33"
11. # 应显示已安装的 Android 33 SDK
复制代码
4)设置环境变量（关键步骤）
为了让系统全局辨认 adb、emulator 等命令，需将它们的路径添加到系统环境变量中。
(1) 找到组件路径
假设你的 Android SDK 安装在默认路径：
Windows：
1. C:\Users\YourUsername\AppData\Local\Android\Sdk
复制代码
macOS/Linux：
1. ~/Library/Android/sdk # 或自定义路径
复制代码
(2) 添加环境变量
Windows：
- 右键点击 此电脑 → 属性 → 高级系统设置 → 环境变量。
- 在 系统变量 中找到 Path，点击编辑。
- 添加以下路径（替换为你的现实路径）：
  1. C:\Users\YourUsername\AppData\Local\Android\Sdk\platform-tools
  2. C:\Users\YourUsername\AppData\Local\Android\Sdk\emulator
  复制代码
macOS/Linux：
编辑 ~/.bashrc 或 ~/.zshrc 文件，添加：
1. export ANDROID_HOME=$HOME/Library/Android/sdk
2. export PATH=$PATH:$ANDROID_HOME/platform-tools
3. export PATH=$PATH:$ANDROID_HOME/emulator
复制代码
然后运行：
1. source ~/.bashrc # 或 source ~/.zshrc
复制代码
5). 创建模拟器（AVD）

假如尚未创建 Android 虚拟设备（AVD），需增补此步骤：
打开 Android Studio → Tools → Device Manager。
点击 Create Device，选择一个设备模板（如 Pixel 5）。
选择已安装的 Android 版本（如 Android 13）。
完成设置后启动模拟器。

第二步：创建 Android 虚拟设备（AVD）

1. 使用 Android Studio 创建模拟器

步骤：
- 打开 Android Studio，进入 More Actions → Virtual Device Manager。
- 点击 Create Device，选择一个设备型号（如 Pixel 5）。
- 选择系统镜像（推荐最新版 Android，如 Android 13）。
- 完成设置后，点击 Finish。
- 启动模拟器：在设备列表中点击绿色三角按钮。

2. 通过命令行启动模拟器

emulator -avd <模拟器名称> # 例如：emulator -avd Pixel_5_API_33

复制代码

第三步：安装 Appium（详细步骤）

1. 安装 Node.js和npm

作用：Appium 是基于 Node.js 开发的，需先安装 Node.js 环境。
步骤：
- 访问 Node.js 官网下载 LTS 版本并安装。
- 验证安装,打开命令行终端（CMD/PowerShell/Terminal），运行：
  1. node -v # 输出版本号（如 v18.x）
  2. npm -v # 输出版本号（如 9.x）
  复制代码

2. 安装 Appium Server

npm install -g appium # 全局安装 Appium

复制代码

验证安装：

appium -v # 输出版本号（如 2.x）

复制代码

3. 安装 Appium 客户端库（以 Python 为例）

pip install Appium-Python-Client # Python 客户端库

复制代码

4. 安装 Appium Desktop（可选）

作用：图形化工具，用于调试元素定位。
下载地址：Appium Desktop Releases
下载对应系统的安装包（如 Appium-Server-GUI-windows-<版本>.exe）。
安装后打开 Appium Desktop

5.安装 Appium Doctor（环境验证工具）

Appium Doctor 可以查抄环境是否完备。

npm install -g appium-doctor
# 运行检查
appium-doctor --android # 仅检查 Android 环境

复制代码

确保全部 ✅ 均为绿色，若有 ❌ 需按提示修复。

6.启动 Appium Server

1. 命令行启动

appium # 默认使用端口 4723

复制代码

若提示 Could not start REST http interface listener，可能是端口冲突，可指定其他端口：

appium -p 4724

复制代码

2. Appium Desktop 启动

打开 Appium Desktop，点击 Start Server。
默认端口 4723，界面会表现日志输出。

————————————————————————————————
手动分界线，到这里假如本身没有apk文件的话，可以直接转到下一篇去看怎样进行简单的自动化测试！（Android studio+python+appium）
————————————————————————————————

第四步：预备待测应用

1. 获取 APK 文件

假如是本身开发的应用：
- 通过 Android Studio 天生 app-debug.apk（路径：app/build/outputs/apk/debug）。
假如是第三方应用：
- 使用 adb 从手机中提取：
  1. adb shell pm list packages # 列出所有应用包名
  2. adb shell pm path <包名> # 获取 APK 路径
  3. adb pull <APK路径> # 下载到电脑
  复制代码

第五步：编写第一个自动化测试脚本

1. 启动 Appium Server

appium # 默认启动在 http://localhost:4723

复制代码

2. 编写 Python 测试脚本

from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
# 配置 Capabilities
desired_caps = {
"platformName": "Android",
"deviceName": "Pixel_5_API_33", # 与模拟器名称一致
"app": "/path/to/your/app.apk", # APK 文件路径
"automationName": "UiAutomator2", # Android 默认驱动
"newCommandTimeout": 300 # 超时时间
}
# 连接 Appium Server
driver = webdriver.Remote("http://localhost:4723", desired_caps)
# 示例操作：点击登录按钮
login_button = driver.find_element(AppiumBy.ID, "com.example:id/login_button")
login_button.click()
# 关闭会话
driver.quit()

复制代码

3. 运行脚本

python your_script.py

复制代码

第六步：定位元素

1. 使用 Appium Inspector

启动 Appium Desktop，点击 Start Server。
点击 Start Inspector Session，输入 desired_caps 设置。
毗连设备后，可以实时检察界面元素并获取属性（如 resource-id、text）。

2. 常用定位方式

# 通过 ID 定位
driver.find_element(AppiumBy.ID, "com.example:id/username")
# 通过文本定位
driver.find_element(AppiumBy.XPATH, "//*[@text='登录']")
# 通过 Accessibility ID（content-desc）
driver.find_element(AppiumBy.ACCESSIBILITY_ID, "description")

复制代码

第七步：处理常见标题

1. 设备未毗连

adb devices # 检查设备是否列出
adb kill-server && adb start-server # 重启 ADB

复制代码

2. 元素定位失败

使用 driver.page_source 打印页面 XML 结构，查抄元素是否存在。
添加隐式等待：
1. driver.implicitly_wait(10) # 最多等待 10 秒
复制代码

3. 真机测试

手机开启开发者模式（连续点击系统版本号）。
启用 USB 调试。
通过 USB 毗连电脑，运行 adb devices 确认设备已辨认。

第八步：集成到 CI/CD（可选）

1. 使用 GitHub Actions

jobs:
test:
runs-on: ubuntu-latest
steps:
- name: Run Android Emulator
uses: reactivecircus/android-emulator-runner@v2
with:
api-level: 33
script: python your_script.py

复制代码

2. 使用云测试平台

Firebase Test Lab：上传 APK，在多设备上并行测试。
AWS Device Farm：雷同功能，支持自界说脚本。

学习资源推荐

官方文档：
- Appium 官方文档
- UiAutomator2 驱动文档
实战项目：
- GitHub 搜索 appium-android-example 参考开源项目。
调试工具：
- Android Studio 的 Layout Inspector：分析 UI 层级。
- adb logcat：检察应用日志。
（可以到下一篇去看怎样进行简单的自动化测试！

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

欢迎光临 IT评测·应用市场-qidao123.com技术社区 (https://dis.qidao123.com/)