os: win11 appium:v3.5.2
1. 准备Android SDK 轻量级环境
1.1 下载安装JAVA SDK，推荐JDK 17
# https://www.oracle.com/java/technologies/downloads/#java17
# 在系统变量 Path 中，新增 %JAVA_HOME%\bin
1.2 安装并配置 Android SDK
# 下载地址：https://developer.android.google.cn/studio#command-tools，页面需往下多滚一些
# 手动在 SDK 根目录下建立一个 cmdline-tools 文件夹，并在其中再新建一个名为 latest 的文件夹，下载的解压放入latest目录：
SDK根目录/
└── cmdline-tools/
└── latest/
├── bin/ <-- sdkmanager.bat, avdmanager.bat 等工具在这里
├── lib/
├── NOTICE.txt
└── source.properties
# 配置 ANDROID_HOME 环境变量
# 编辑系统变量 Path，新增以下两条路径：
# %ANDROID_HOME%\cmdline-tools\latest\bin
# %ANDROID_HOME%\platform-tools
# 并使用 sdkmanager 命令安装 platform-tools 和对应的安卓平台版本
sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"
adb version
1.3 安装 Node.js
# Appium 服务端是基于 Node.js 运行的
2. 安装 Appium 服务端和驱动
2.1 安装 Appium 及驱动。appium 2.x 版本采用了核心与驱动分离的架构，需要分别安装
# 1）全局安装 Appium：在命令行执行 npm install -g appium
# 2）安装安卓驱动：执行 appium driver install uiautomator2
appium -v
appium driver list --installed # 检查已安装的驱动，确认列表中出现了 uiautomator2
2.2 安装 Python
# 1） 前往 Python 官网下载 3.8 及以上版本，安装时务必勾选 “Add Python to PATH”
# 2）安装 Appium-Python-Client：在命令行执行 pip install Appium-Python-Client -i https://mirrors.ustc.edu.cn/pypi/simple
# 检查 Python 客户端（pip install Appium-Python-Client已安装相关依赖项 selenium 和 typing-extensions，用pip show selenium）
python -c "from appium import webdriver; print('Appium-Python-Client 安装成功！')"
# 或用 pip show ，可进一步打印作者、版本号、版权、依赖关系等详情：
pip show Appium-Python-Client
2.3 推荐安装Appium Inspector，一款图形化元素定位工具
# Windows下，下载.exe：https://github.com/appium/appium-inspector/releases
# 本文安装.exe文件: Appium-Inspector-2026.5.1-win.exe
# 确保appium server已启动：
appium server # server可省略，启动参数使用比较复杂，详情见官网手册：https://appium.io/docs/zh/3.5/reference/cli/server/
# 获取正确的包名（appium:appPackage）和页面（appium:appActivity, 如 .Settings 或 .MainActivity）的步骤: ①windows下，先在模拟器上手动打开待连接的APP; ②通过 adb 命令成功抓取到了正确的包名和 Activity 信息；③回到 Appium Inspector 的 Capability Builder 设置区，将配置修改为刚获取到的准确信息
# 上②，windows下的adb命令：
adb shell dumpsys window windows | findstr mCurrentFocus
# Mac/Linux下: adb shell dumpsys window windows | grep -E "mCurrentFocus"
)