Appium自动化测试：使用Wi-Fi连接手机

Appium自动化测试：使用Wi-Fi连接手机

本教程将详细指导你通过Wi-Fi连接Android手机进行Appium自动化测试环境基于Windows系统（Mac/Linux可调整路径命令）。

---

1. 环境准备

1.1 安装基础工具

• Node.js：运行Appium服务

  choco install nodejs  # Windows使用Chocolatey
  

• Android SDK：配置ANDROID_HOME环境变量

  setx ANDROID_HOME "C:\Android\Sdk"  # Windows示例路径
  

• Appium安装：

  npm install -g appium  # 全局安装Appium服务
  npm install -g appium-doctor  # 环境验证工具
  

1.2 检查环境

appium-doctor --android  # 确保所有✅通过

---

2. 手机端配置

2.1 开启开发者选项

1. 进入手机设置 > 关于手机 > 连点7次"版本号"激活开发者模式
2. 返回设置 > 开发者选项 > 开启 USB调试 和 USB调试（安全设置）

2.2 获取设备信息

adb devices  # 连接USB线，确认设备ID（如：emulator-5554）

2.3 切换为Wi-Fi连接

adb tcpip 5555  # 开启5555端口（任意未占用端口）
adb connect <手机IP>:5555  # 例：adb connect 192.168.1.100:5555
adb devices     # 验证设备已显示（无需USB线）

⚠️ 注意：手机与电脑需在同一局域网，IP可通过设置 > WLAN详情查看。

---

3. 配置Appium Capabilities

创建config.json文件，指定Wi-Fi连接参数：

{
  "platformName": "Android",
  "platformVersion": "13",        // 手机系统版本
  "deviceName": "<设备IP>:5555",   // 例：192.168.1.100:5555
  "automationName": "UiAutomator2",
  "app": "/path/to/your_app.apk"  // 待测APP路径
}

---

4. 编写测试脚本（Python示例）

4.1 安装依赖

pip install Appium-Python-Client

4.2 创建测试脚本wifi_test.py

from appium import webdriver
import json

# 加载配置文件
with open('config.json') as f:
    caps = json.load(f)

# 启动会话（Appium默认服务地址：http://localhost:4723）
driver = webdriver.Remote("http://localhost:4723/wd/hub", caps)

# 示例：点击登录按钮
login_btn = driver.find_element("id", "com.example:id/login")
login_btn.click()

# 结束测试
driver.quit()

---

5. 启动测试

5.1 启动Appium服务

appium  # 默认监听4723端口

5.2 运行脚本

python wifi_test.py

---

6. 常见问题排查

• 连接超时：
  • 检查手机与电脑的Wi-Fi是否同网段
  • 重启adb服务：

    adb kill-server && adb start-server
    

• 元素定位失败：
  • 使用uiautomatorviewer（Android SDK工具）检查元素ID
• 端口占用：

  netstat -ano | findstr :5555  # Windows查看端口占用
  

✅ 成功标志：手机自动安装待测APP并执行操作，无USB线束缚！

---

进阶技巧

• 多设备并发测试：为每台手机分配不同端口（5555/5556/…）
• 动态IP管理：使用脚本自动获取手机IP：

  import subprocess
  ip = subprocess.check_output("adb shell ip route | awk '{print $9}'", shell=True).decode().strip()