Python+ Appium：Android手机连接与操作详解（附源码）

在移动端自动化测试领域，Appium一直是最热门的开源工具之一。

今天这篇文章，我们聚焦Android端自动化测试的完整流程，从环境配置到代码实战，一步一步带你掌握用 Python 控制 Android 真机或模拟器的技巧。

后续还会推出 iOS 端的实战教程，谢谢大家的评论+收藏+关注！

先看效果！

应用启动

一、Appium 简介

Appium 是一个跨平台的移动应用测试框架，支持：

• Android 原生 / 混合 / 移动网页应用

• iOS 原生 / 混合 / 移动网页应用

它的最大优势在于：

✅ 使用相同的 API 来测试不同平台的应用。

二、准备工作 Checklist ✅

在开始之前，请确保你已准备好以下环境：

项目	状态说明
Appium Server	已安装并启动（推荐使用 Appium 2.x）
Python 3.x	已安装（推荐 Python 3.8+）
Appium-Python-Client	使用 pip install Appium-Python-Client 安装
Android 手机	开启「开发者模式」与「USB 调试」
adb 设备连接	可使用 adb devices 检查设备是否已连接
appPackage/appActivity	可通过工具（如 aapt、Appium Inspector）获取

Appium Server

三、完整代码实战（附讲解）

以下是用 Python 控制 Android 手机打开指定 App，并点击某个按钮的完整代码示例。

✅ 推荐写法（Appium 2.x 标准）

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：BangcleAutoTest 
@File    ：test.py
@Date    ：2025/4/14 18:49 
@Author : malijie
"""

from appium import webdriver
from appium.options.android import UiAutomator2Options
from appium.webdriver.common.appiumby import AppiumBy

# 使用 Options 对象承载配置参数
desired_caps = {
    'platformName': 'Android',
    'platformVersion': '11',
    'deviceName': 'FA7AK1A05436',  # 你自己的设备名
    'appPackage': 'com.example.demo',  # 目标App包名
    'appActivity': 'com.example.demo.MainActivity',  # 启动Activity
    'automationName': 'UiAutomator2',
    'newCommandTimeout': 600
}

# 将配置加载为 Options 对象
options = UiAutomator2Options().load_capabilities(desired_caps)

# 创建驱动连接
driver = webdriver.Remote(
    command_executor='http://localhost:4723',
    options=options
)

# 操作 App：点击某个控件
driver.find_element(AppiumBy.ID, 'behavior').click()

# 关闭连接
driver.quit()

四、关键说明 & 常见问题解析

为何使用 UiAutomator2Options？

Appium 2.x 版本推荐使用 Options 对象来配置 desired capabilities，代码更结构化、清晰，兼容性更好。

appPackage 和 appActivity 怎么获取？

可使用以下任意方法获取：

• Android Studio 的 logcat 日志

• adb shell dumpsys window | grep -E 'mCurrentFocus'

• 使用 Appium Inspector 或 GUI 工具自动抓取

获取appPackage和appActivity

报错“无法连接设备”怎么办？

请确认：

• 手机已允许 USB 调试

• adb devices 能看到设备

• Appium 服务已启动（默认端口 4723）

adb devices 查看设备

五、应用场景推荐

• 自动化测试移动 App 的核心流程（登录、操作、退出）

• 回归测试 & 烟雾测试场景自动化

• 可视化结果录制（配合截图、录屏）

• 自动化点击/滑动，用于自动演示/模拟

六、后续预告：iOS 自动化即将上线

很多小伙伴私信问：iOS 也能用 Appium 吗？

答案是：当然可以！

我将在下一篇文章中详细讲解：

• iOS 设备准备与信任证书配置

• WebDriverAgent 的安装与签名

• 真机控制常见坑点与解决方案

希望今天这篇文章能帮你更清晰地理解 如何使用 Appium 操作 Android 手机。

如果你觉得有用，欢迎点赞、收藏、转发支持我持续更新。

你想优先看到哪一类内容？

• Appium 进阶实战

• iOS 自动化教程

• App 自动打包+部署+测试整合

点关注点赞不迷路，后续更新更多自动化测试经验，我们一起成长！欢迎评论区留言！

参考链接：

GitHub - appium/appium: Cross-platform automation framework for all kinds of apps, built on top of the W3C WebDriver protocol