Android移动端自动化测试入门指南（保姆级教程，包学会的）

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

2. 配置环境变量

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

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

1). 打开 Android Studio 的 SDK Manager

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

# 检查 adb 是否可用
adb --version
# 输出示例：Android Debug Bridge version 1.0.41

# 检查 emulator 是否可用
emulator -list-avds
# 输出已创建的模拟器列表（如果尚未创建则为空）

# 检查 Android SDK 版本
sdkmanager --list | findstr "platforms;android-33"
# 应显示已安装的 Android 33 SDK

4)配置环境变量（关键步骤）

为了让系统全局识别 adb、emulator 等命令，需将它们的路径添加到系统环境变量中。
(1) 找到组件路径

假设你的 Android SDK 安装在默认路径：

Windows：

C:\Users\YourUsername\AppData\Local\Android\Sdk

macOS/Linux：

~/Library/Android/sdk  # 或自定义路径

(2) 添加环境变量
Windows：
1. 右键点击 此电脑 → 属性 → 高级系统设置 → 环境变量。
2. 在 系统变量 中找到 Path，点击编辑。
3. 添加以下路径（替换为你的实际路径）：
```
C:\Users\YourUsername\AppData\Local\Android\Sdk\platform-tools
C:\Users\YourUsername\AppData\Local\Android\Sdk\emulator
```

macOS/Linux：
编辑 ~/.bashrc 或 ~/.zshrc 文件，添加：

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/emulator

然后运行：

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 创建模拟器

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

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

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

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

1. 安装 Node.js和npm

作用：Appium 是基于 Node.js 开发的，需先安装 Node.js 环境。
步骤：
1. 访问 Node.js 官网下载 LTS 版本并安装。
2. 验证安装,打开命令行终端（CMD/PowerShell/Terminal），运行：
```
node -v  # 输出版本号（如 v18.x）
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 从手机中提取：

adb shell pm list packages  # 列出所有应用包名
adb shell pm path <包名>     # 获取 APK 路径
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 结构，检查元素是否存在。

添加隐式等待：

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：查看应用日志。
（可以到下一篇去看如何进行简单的自动化测试！