appium连接android手机

<think>我们正在回答用户关于如何使用Appium连接Android设备的问题。根据用户提供的引用资料，我们可以整合出一个详细的配置教程。步骤包括：安装必要的软件（Python、JDK、AndroidStudio、Appium等），配置环境变量，以及编写和运行测试脚本。由于用户特别提到要连接Android设备，我们将包括真机和模拟器两种情况的连接方法。注意：引用[1]、[2]、[3]提供了部分步骤，我们将综合这些信息，并确保步骤清晰。注意：以下步骤基于macOS系统，但大部分步骤在Windows和Linux上类似（环境变量配置方式可能不同）。</think>### 如何使用 Appium 连接 Android 设备配置教程 #### 一、环境准备 1. **安装 Python** - 官网下载 Python（macOS 选择 `.dmg` 文件） - 配置环境变量： ```bash # 编辑配置文件 open ~/.bash_profile # 添加 Python 路径 PATH="/Library/Frameworks/Python.framework/Versions/3.10/bin:${PATH}" export PATH ``` [^3] 2. **安装 JDK** - 检查是否安装：`java -version` - 配置环境变量： ```bash JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-11.0.16.jdk/Contents/Home PATH=$PATH:$JAVA_HOME/bin export JAVA_HOME ``` [^3] 3. **安装 Android Studio** - 下载地址：[Android Studio 官网](https://developer.android.com/studio) - 配置环境变量： ```bash export ANDROID_HOME=/Users/你的用户名/Library/Android/sdk export PATH=$PATH:$ANDROID_HOME/tools export PATH=$PATH:$ANDROID_HOME/platform-tools ``` [^3] #### 二、安装 Appium 1. **Appium Desktop** - 下载地址：[Appium Releases](https://github.com/appium/appium-desktop/releases) - 建议选择稳定版本（如 1.17.1）[^2] - 安装后打开，点击 `Edit Configurations` 验证 `JAVA_HOME` 和 `ANDROID_HOME` 是否配置成功 2. **Appium Inspector** - 用于定位页面元素（新版本已拆分为独立应用）[^2] 3. **安装 Python 客户端库** ```bash pip3 install appium-python-client ``` [^1] #### 三、连接 Android 设备 1. **真机连接** - 开启手机开发者模式（设置 → 关于手机 → 连点版本号） - 启用 USB 调试（设置 → 开发者选项） - 通过 USB 连接电脑 2. **模拟器连接** - 在 Android Studio 中创建 AVD（Android Virtual Device） - 启动模拟器 #### 四、编写测试脚本 ```python from appium import webdriver desired_caps = { 'platformName': 'Android', 'platformVersion': '11', # 设备系统版本 'deviceName': 'Pixel_3a', # 设备名称（adb devices 查看） 'appPackage': 'com.android.calculator2', # 被测 App 包名 'appActivity': '.Calculator' # 启动 Activity } driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps) # 示例：点击计算器按钮 driver.find_element_by_id("digit_5").click() driver.quit() ``` #### 五、启动测试 1. 打开 Appium Desktop 点击 `Start Server` 2. 运行 Python 脚本 3. 在 Appium Inspector 中检查元素定位（需配置相同的 `desired_capabilities`）[^2] #### 六、常见问题解决 - **设备未识别**：执行 `adb devices` 检查设备 ID - **环境变量失效**：终端执行 `source ~/.bash_profile` - **端口冲突**：确保 Appium 默认端口 `4723` 未被占用 > 配置完成后，即可通过 Appium 实现 Android 设备的自动化操作，适用于 UI 测试、数据采集等场景[^1][^3]。