个人笔记-踩坑实录【 Appium + Python 自动化环境搭建与启动成功指南】

Appium Python 自动化环境搭建与启动成功指南适用版本Appium 3.5.2 / Python 3.11 / UiAutomator2 / Android 模拟器最后更新2026-07-16状态✅ 已验证成功成功启动com.android.settings 一、环境依赖清单提前装好组件版本要求检查命令备注Node.js≥ 20.19 或 22.12 LTSnode -v使用 nvm 管理Appium Server3.xappium --version通过 npm 全局安装Android SDK含 platform-toolsadb version设置ANDROID_HOMEJava JDK11 或 21java -version设置JAVA_HOMEPython3.8python --version建议 3.11Appium-Python-Client3.xpip show Appium-Python-Client使用新版 API 二、关键配置步骤按顺序执行1. 启动 Appium 服务器必须保持运行打开一个CMD窗口执行appium看到[Appium] Appium REST http interface listener started on http://0.0.0.0:4723即为成功。此窗口不要关闭最小化即可。2. 启动 Android 模拟器或连接真机模拟器通过 Android Studio AVD Manager 启动或命令行启动。真机开启 USB 调试通过adb devices确认设备在线。验证执行adb devices应看到类似emulator-5554 device。3. 编写 Python 启动脚本最终成功版创建start_settings.py粘贴以下代码importtimefromappiumimportwebdriverfromappium.options.commonimportAppiumOptions# 1. 配置参数注意加 appium: 前缀caps{platformName:Android,appium:platformVersion:15,# 改成你的真实版本appium:deviceName:emulator-5554,# 你的设备名appium:automationName:UiAutomator2,# 必须指定appium:appPackage:com.android.settings,appium:appActivity:com.android.settings.Settings,# 主界面避免权限问题appium:noReset:True,# 不重置应用数据}# 2. 创建驱动新版标准写法optionsAppiumOptions()options.load_capabilities(caps)driverwebdriver.Remote(command_executorhttp://127.0.0.1:4723,# 注意没有 /wd/huboptionsoptions)# 3. 等待3秒观察模拟器是否打开“设置”time.sleep(3)# 4. 关闭会话driver.quit()4. 运行脚本在 CMD 中切换到脚本目录执行python start_settings.py成功标志模拟器自动打开“设置”主界面。终端打印无错误最后输出进程已结束退出代码 0。Appium 服务器日志显示[HTTP] -- POST /session 200。⚠️ 三、常见错误及解决方法我遇到过的坑错误现象原因解决方案ConnectionRefusedErrorAppium 服务未启动启动appium并保持运行automationName is required缺少该参数在 caps 中添加appium:automationName:UiAutomator2missing 1 required keyword-only argument: options客户端版本太新不支持旧式传参改用optionsAppiumOptions()方式SecurityException: Permission Denial ... not exportedActivity 未导出改用主界面com.android.settings.SettingsNo such device设备名不匹配用adb devices查看真实名称并修改 四、最终项目文件结构建议app_automation/ ├── start_settings.py # 主启动脚本 ├── requirements.txt # 依赖列表 └── README.md # 本文档requirements.txt内容Appium-Python-Client3.0.0 selenium4.0.0 五、核心知识点总结面试/理解用Desired Capabilities告诉 Appium 要测什么设备、什么应用、用什么驱动。UiAutomator2Android 平台现代驱动Appium 2.x/3.x 强制指定。W3C 标准新版要求参数加appium:前缀连接地址去掉/wd/hub。exported属性只有导出的 Activity 才能被外部启动系统子页面常有限制。驱动与客户端版本匹配Appium Server 3.x Python Client 3.x 必须用新 API。✅ 六、下一步学习建议学习元素定位使用AppiumBy类ID,XPATH,ACCESSIBILITY_ID等。学习显式等待WebDriverWait配合expected_conditions。学习Page Object 模式将页面元素和操作封装成类。尝试启动自己的 App替换appPackage和appActivity。