要使用 Python3 结合 Appium 和安卓模拟器实现 APP 自动化测试并生成 HTML 报告，你需要完成环境搭建、脚本编写和报告生成三个核心步骤。以下是详细的实现方案。 ### 一、 环境搭建与配置 这是自动化测试的基础，需要按顺序安装并配置好所有必要的软件和工具。 | 序号 | 组件名称 | 作用 | 安装/配置要点 | 参考来源 | | :--- | :--- | :--- | :--- | :--- | | 1 | Python3 | 主要的编程语言环境 | 从官网下载安装，注意添加环境变量。 | [ref_1] | | 2 | Appium-Python-Client | Python 操作 Appium 的客户端库 | 在命令行使用 `pip install Appium-Python-Client` 安装。 | [ref_1] | | 3 | JDK (Java Development Kit) | 运行 Appium Server 所必需 | 建议安装 JDK 8，配置 `JAVA_HOME` 环境变量。 | [ref_1], [ref_4] | | 4 | Android SDK | 提供 adb 等安卓调试工具 | 可通过安装 Android Studio 来获取，设置 `ANDROID_HOME` 环境变量。 | [ref_1], [ref_4] | | 5 | Appium Server | 移动端自动化测试服务器 | 从官网或 GitHub 下载桌面版，启动服务监听默认端口 `4723`。 | [ref_1], [ref_4] | | 6 | 安卓模拟器 (如夜神) | 用于运行被测试的 APP | 安装后，需用 Android SDK 的 `adb.exe` 替换模拟器自带的，并连接。 | [ref_1] | **关键配置步骤（以夜神模拟器为例）**： 1. 找到 Android SDK 的 `adb.exe`（通常在 `platform-tools` 目录下）。 2. 将其复制到夜神模拟器的 `bin` 目录（如 `D:\Nox\bin`），覆盖原有文件。 3. 删除原目录下的 `nox_adb.exe`，再将复制过来的 `adb.exe` 重命名为 `nox_adb.exe`。 4. 在 `bin` 目录打开命令行，执行 `nox_adb.exe connect 127.0.0.1:62001` 连接模拟器 [ref_1]。 5. 执行 `adb devices`，确认设备列表中出现了 `127.0.0.1:62001` 设备，表示连接成功 [ref_1]。 ### 二、 编写自动化测试脚本 使用 Python 的 `unittest` 框架和 `appium` 库来编写测试用例。以下是一个完整的示例脚本，测试一个计算器 APP。 ```python # test_app.py - 测试用例脚本 import time import unittest from appium import webdriver class CalculatorTest(unittest.TestCase): """计算器APP自动化测试用例""" def setUp(self): """每个测试方法执行前运行，用于初始化驱动和会话""" # 定义Desired Capabilities，用于告知Appium Server要启动的会话属性 [ref_1][ref_4] desired_caps = { 'platformName': 'Android', # 平台为安卓 'platformVersion': '7.1.2', # 模拟器的安卓版本号 'deviceName': '127.0.0.1:62001', # 连接的设备地址（夜神模拟器默认） 'appPackage': 'com.youdao.calculator', # 被测APP的包名 'appActivity': 'com.youdao.calculator.activities.MainActivity', # 启动的Activity 'noReset': True, # 不重置APP状态 'automationName': 'UiAutomator2' # 自动化引擎 } # 连接至本地启动的Appium Server [ref_1] self.driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps) self.driver.implicitly_wait(10) # 设置隐式等待，方便元素定位 [ref_6] def test_addition(self): """测试加法功能：7 + 8""" # 使用XPath定位数字按钮并点击 [ref_1] btn_xpath = '/hierarchy/android.widget.FrameLayout/android.widget.LinearLayout/android.widget.FrameLayout/android.widget.LinearLayout/android.widget.FrameLayout/android.widget.FrameLayout/android.support.v4.widget.DrawerLayout/android.widget.LinearLayout/android.widget.FrameLayout/android.widget.RelativeLayout/android.widget.LinearLayout[2]/android.widget.LinearLayout/android.widget.LinearLayout[3]/android.view.View/android.widget.GridView/android.widget.FrameLayout[{0}]/android.widget.FrameLayout' self.driver.find_element_by_xpath(btn_xpath.format(7)).click() # 点击数字7 self.driver.find_element_by_xpath(btn_xpath.format(10)).click() # 点击加号(+) self.driver.find_element_by_xpath(btn_xpath.format(8)).click() # 点击数字8 self.driver.find_element_by_xpath(btn_xpath.format(12)).click() # 点击等号(=) # 此处可添加断言，验证结果是否正确 # result = self.driver.find_element_by_id('com.youdao.calculator:id/result').text # self.assertEqual(result, '15') time.sleep(2) # 等待结果展示 def tearDown(self): """每个测试方法执行后运行，用于清理环境""" if self.driver: self.driver.quit() # 关闭驱动，结束会话 [ref_1] if __name__ == '__main__': unittest.main() ``` **脚本关键点说明**： * **`desired_caps`**：这是 Appium 会话的核心配置字典，必须根据你的被测 APP 和设备信息进行修改 [ref_4]。包名 (`appPackage`) 和启动 Activity (`appActivity`) 可以通过 Android SDK 的 `aapt` 工具分析 APK 文件获取，命令为 `aapt dump badging your_app.apk` [ref_1]。 * **元素定位**：示例中使用了 `find_element_by_xpath`，这是定位元素的方法之一。Appium 还支持通过 ID、 Accessibility ID、 Class Name 等多种方式定位，应根据 APP 的实际情况选择最稳定高效的方式 [ref_6]。 * **测试结构**：遵循 `unittest` 框架的 `setUp` -> `test_*` -> `tearDown` 结构，保证测试的独立性和可重复性 [ref_5]。 ### 三、 生成 HTML 测试报告 为了生成美观的 HTML 测试报告，我们可以使用修改后支持 Python3 的 `HTMLTestRunner` 模块。你需要先下载该模块文件（可从 [ref_1] 末尾提供的 GitHub 项目链接获取），并将其放在你的项目目录中。 然后，创建一个主运行脚本 `run.py`，用于发现并执行所有测试用例，然后生成报告。 ```python # run.py - 主运行脚本，用于生成HTML测试报告 import os import time import unittest from HTMLTestRunner import HTMLTestRunner # 导入HTMLTestRunner模块 [ref_1] # 1. 定义测试用例的发现目录 test_dir = './testcase' # 假设你的所有测试脚本都放在`testcase`目录下 # 2. 使用TestLoader自动发现测试用例 # pattern参数指定匹配`test`开头的Python文件 [ref_5] discover = unittest.defaultTestLoader.discover(start_dir=test_dir, pattern='test*.py') if __name__ == "__main__": # 3. 创建报告存放目录 report_dir = './test_report' os.makedirs(report_dir, exist_ok=True) # 如果目录不存在则创建 # 4. 生成带时间戳的报告文件名 now = time.strftime("%Y-%m-%d %H-%M-%S") report_name = f'{report_dir}/{now}_TestReport.html' # 5. 运行测试并生成HTML报告 with open(report_name, 'wb') as f: # 以二进制写模式打开文件 runner = HTMLTestRunner( stream=f, title='APP自动化测试报告', # 报告标题 description='本次测试覆盖了计算器APP的核心功能', # 报告描述 verbosity=2 # 日志详细程度 ) runner.run(discover) # 执行测试套件 print(f'测试完成，报告已生成: {report_name}') ``` **执行与查看报告**： 1. 确保 Appium Server 已启动并在监听 `4723` 端口。 2. 确保安卓模拟器已启动并成功连接 (`adb devices` 可见)。 3. 在命令行中运行 `python run.py`。 4. 执行完毕后，在 `test_report` 目录下会生成一个以时间戳命名的 HTML 文件（如 `2023-10-27 14-30-00_TestReport.html`）。 5. 用浏览器打开该 HTML 文件，即可看到包含测试用例执行情况、通过率、耗时等详细信息的可视化报告 [ref_1]。 通过以上三个部分的完整实施，你就建立了一个从环境准备、脚本开发到报告生成的完整 APP 自动化测试流程。这个流程具有很强的可扩展性，你可以通过编写更多的 `test_*` 方法来覆盖更全面的功能测试，也可以集成到持续集成 (CI) 工具中，实现自动化测试的常态化运行 [ref_5]。