Appium 是目前移动端 APP 自动化测试主流开源框架，跨平台、支持 Android/iOS、无需改源码、适配 Python 语言。本文从零搭建完整 Appium 移动端自动化环境，零基础可直接复刻落地。

一、Appium 核心原理

基于 Selenium 协议扩展，复用 Web 自动化语法体系，通过手机驱动实现 APP 元素识别、手势操作、页面控制，一套语法适配双端。

二、全套环境依赖

Python 环境、JDK 环境、Android SDK、Appium Server、Appium-Python-Client、模拟器/真机设备。

三、分步环境搭建

1. 基础环境配置

配置 Java 环境变量、Android SDK 环境变量，确保 adb 命令、java 命令全局生效。

2. Appium 服务安装

安装桌面版 Appium，启动本地服务，默认端口 4723。

3. Python 依赖安装

pip 安装 Appium 客户端库，用于代码连接服务、控制设备。

4. 设备准备

Android 开启开发者模式、USB 调试、安装未知应用；模拟器直接开启调试模式，adb 验证设备连接成功。

四、核心参数配置（启动 APP 必备）

设备名称、平台系统、APP 包名、APP 启动页 Activity、服务地址端口、无重置参数、超时参数。

五、环境验证与入门脚本

编写启动 APP、关闭 APP、获取设备信息的基础脚本，验证环境通调。

六、环境常见报错排查

1. adb 设备识别失败；

2. 包名 Activity 错误启动失败；

3. 端口占用服务启动失败；

4. 环境变量不生效；

5. 设备权限不足。