如何用Python实现安卓手机App自动化操作_借助Appium与ADB命令

Appium 启动失败需检查 adb 可用性、设备授权及配置：确保 adb devices 显示 device 状态，platformName 为 "Android"，deviceName 为设备 ID 或非空字符串，补全 appPackage 和 appActivity；优先使用 accessibility_id 定位元素，输入前加显式等待；ADB 可兜底执行杀进程、模拟按键、截屏等操作，与 Appium 分层协作保障稳定性。

Appium 启动失败：检查 adb 是否可用且设备已授权

Appium 本质依赖 ADB 与手机通信，启动前必须确保 adb 可执行、设备在线且处于调试授权状态。常见现象是 Appium 日志卡在 Waiting for device 或报错 device unauthorized。

• 在终端运行 adb devices，确认输出中设备 ID 后显示 device（而非 unauthorized 或空白）
• 若为 unauthorized，拔插 USB 线，在手机弹出“允许 USB 调试”对话框时勾选“始终允许”，再重试
• Windows 用户需确认 adb 在系统 PATH 中；Mac/Linux 用户建议用 which adb 验证路径，避免 Appium 启动时找不到二进制文件
• 部分厂商（如华为、小米）需额外开启“USB 调试（安全设置）”或关闭“MIUI 优化”

Python 脚本连不上 Appium Server：检查 desired_caps 中的 platformName 和 deviceName

连接失败常因基础配置不匹配，尤其 platformName 必须为 "Android"（大小写敏感），而 deviceName 不是手机型号，而是 adb devices 显示的设备 ID 或任意非空字符串（Appium 1.15+ 允许设为 "emulator-5554" 这类标识，但不能为空）。

• desired_caps = {"platformName": "Android", "deviceName": "123abc", "appPackage": "com.example.app", "appActivity": ".MainActivity"}
• 遗漏 appPackage 和 appActivity 会导致启动后黑屏或闪退——它们是定位目标 App 的必要坐标，可用 adb shell dumpsys window windows | grep -E 'mCurrentFocus|mFocusedApp' 实时获取
• 真机上建议加 "noReset": True 避免每次重装清数据；模拟器可设 "avd": "Pixel_3_API_30" 直接启动指定 AVD

点击/输入失效：优先用 find_element_by_accessibility_id 替代 find_element_by_id

Android 原生控件的 resource-id 在不同版本或厂商定制系统中极易变化，而 accessibility-id（即控件的 content-desc 属性）更稳定，且 Appium Desktop 的 Inspector 工具默认优先展示它。

Python 3.14.3

微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。

• 用 Appium Desktop 连接后，点选界面元素，右侧属性栏找 name 字段值（对应 Python 中的 accessibility_id），例如 driver.find_element_by_accessibility_id("login_button")
• 若无 content-desc，退而求其次用 find_element_by_xpath，但避免写绝对路径（如 //android.widget.Button[1]），改用含文本或唯一属性的相对表达式：//android.widget.Button[@text="登录"]
• 输入前务必加显式等待：WebDriverWait(driver, 5).until(EC.element_to_be_clickable((By.ACCESSIBILITY_ID, "search_field"))).send_keys("test")，否则容易因渲染延迟导致 ElementNotInteractableException

ADB 命令补位：绕过 Appium 封装直接操作底层

Appium 封装虽方便，但某些场景（如强制停止进程、模拟按键、截屏分析）用原生 adb 更快更稳，且无需等待 Appium driver 初始化。

• 杀应用进程：adb shell am force-stop com.example.app —— 比 driver.terminate_app() 更彻底，适合清理残留状态
• 模拟返回键：adb shell input keyevent 4；回到桌面：adb shell input keyevent 3；这些比 driver.back() 更少受页面 JS 阻塞影响
• 截屏并拉取：adb shell screencap -p /sdcard/screen.png && adb pull /sdcard/screen.png ./，后续可用 OpenCV 做图像识别补足 Appium 无法定位的动态元素
• 注意：adb shell 命令需在 Python 中用 subprocess.run() 执行，别忘了检查返回码，失败时 stderr 里常有关键线索（如 error: device offline）

真实项目里，Appium + ADB 不是二选一，而是分层协作：Appium 处理语义化交互（点击、输入、断言），ADB 负责环境控制与兜底操作。最易被忽略的是设备状态一致性——比如脚本中途手机锁屏、开发者选项被重置、或后台进程占满内存，这些都得靠 ADB 定期巡检，而不是等 Appium 报超时错误才反应过来。