Python+Appium环境搭建与自动化教程

以下是保姆级教程，手把手教你搭建 Python + Appium 环境并实现简单的 APP 自动化测试：

一、环境搭建（Windows系统）

1. 安装Python

1. 访问 Python官网 下载最新版（建议3.8+）。
2. 安装时勾选 Add Python to PATH，完成后验证：

bash

python --version

pip --version

2. 安装Node.js

Appium 依赖 Node.js 环境：

1. 访问 Node.js官网 下载 LTS 版本并安装。
2. 验证安装：

bash

node -v

npm -v

3. 安装JDK（Java Development Kit）

Android 工具链依赖 Java 环境：

1. 访问 Oracle JDK官网 下载 JDK 8+。
2. 配置环境变量：

O 新增 JAVA_HOME：指向 JDK 安装路径（如 C:\Program Files\Java\jdk1.8.0_301）。

O 添加 %JAVA_HOME%\bin 到 Path。

3. 验证：

bash

java -version

4. 安装Android SDK

1. 推荐方式：安装 Android Studio：

O 安装时勾选 Android SDK 和 Android SDK Platform-Tools。

2. 或手动安装：

O 下载 SDK Tools。

O 解压后运行 sdkmanager 安装必要组件：

bash

sdkmanager "platform-tools" "build-tools;30.0.3" "platforms;android-30"

3. 配置环境变量：

O 新增 ANDROID_HOME：指向 SDK 安装路径（如 C:\Users\YourName\AppData\Local\Android\Sdk）。

O 添加 %ANDROID_HOME%\platform-tools 到 Path。

4. 验证：

bash

adb version

5. 安装Appium

两种方式任选其一：

1. Appium Desktop（推荐新手）：

O 下载 Appium Desktop 并安装。

2. 命令行安装：

bash

npm install -g appium

验证：

bash

appium -v

二、连接设备

1. 连接真实手机

1. 开启手机开发者模式（连续点击“设置-关于手机-版本号”）。
2. 启用 USB 调试模式。
3. 连接电脑，输入命令查看设备：

bash

adb devices

出现设备ID即表示连接成功。

2. 使用模拟器

1. 通过 Android Studio 创建虚拟设备（AVD）。
2. 启动模拟器后，同样用 adb devices 验证。

三、安装Python库

安装 Appium-Python 客户端：

bash

pip install Appium-Python-Client selenium

四、编写第一个自动化脚本

1. 准备测试APK

• 下载测试应用（如 ApiDemos.apk）。
• 记录 APK 路径（如 C:\Users\YourName\Downloads\ApiDemos-debug.apk）。

2. 编写Python脚本

python

from appium import webdriver

# 定义设备参数

desired_caps = {

"platformName": "Android", # 系统平台

"platformVersion": "11", # 安卓版本（需与设备一致）

"deviceName": "emulator-5554", # 设备名称（通过adb devices获取）

"app": "C:\\path\\to\\ApiDemos-debug.apk", # APK路径

"automationName": "UiAutomator2", # 自动化引擎

"noReset": True # 不重置应用状态

}

# 连接Appium服务器（默认端口4723）

driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)

# 执行操作：点击"Accessibility"选项

driver.find_element_by_accessibility_id("Accessibility").click()

# 关闭会话

driver.quit()

五、运行测试

1. 启动 Appium 服务器：

O Appium Desktop：点击 Start Server。

O 命令行：直接输入 appium。

2. 确保设备已连接（adb devices 可见）。
3. 运行 Python 脚本：

bash

python your_script.py

六、常见问题

1. 设备未识别：

O 检查 USB 调试是否开启。

O 安装手机厂商的 USB 驱动。

2. Appium启动失败：

O 确保端口 4723 未被占用。

3. 元素定位失败：

O 使用 uiautomatorviewer（Android SDK 自带）查看元素属性。

七、进阶学习

1. 元素定位方式：

O ID、XPath、Accessibility ID、Class Name 等。

2. 操作API：

O 滑动、长按、输入文本等。

3. 框架整合：

O 结合 pytest 或 unittest 管理测试用例。

按照以上步骤，你已成功搭建环境并实现基础自动化操作！