1. 环境准备
- 操作系统：Linux
- 宝塔面板已安装
- Node.js 已安装（v22.14.0）
- Java 环境：OpenJDK 11.0.20.1
2. Appium 安装与配置
2.1 安装 Appium
使用 npm 在全局范围内安装 Appium：
npm i -g appium
2.2 环境变量配置
配置 Java 和 Android SDK 环境变量：
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.20.1.1-2.el9.x86_64
export PATH=$PATH:$JAVA_HOME/bin
export ANDROID_HOME=/www/server/android-sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
2.3 安装 Appium Doctor
npm install -g appium-doctor
运行检查后发现以下问题：
✔ The Node.js binary was found at: /www/server/nodejs/v22.14.0/bin/node
✔ Node version is 22.14.0
✔ JAVA_HOME is set to: /usr/lib/jvm/java-11-openjdk-11.0.20.1.1-2.el9.x86_64
✖ ANDROID_HOME is set to '/www/server/android-sdk' but this is NOT a valid path!
✖ adb, android, emulator could NOT be found in /www/server/android-sdk!
- 检查 Java 是否已安装
java -version
openjdk version "11.0.20.1" 2023-08-24 LTS OpenJDK Runtime Environment (Red_Hat-11.0.20.1.1-2) (build 11.0.20.1+1-LTS) OpenJDK 64-Bit Server VM (Red_Hat-11.0.20.1.1-2) (build 11.0.20.1+1-LTS, mixed mode, sharing)
- 设置
JAVA_HOME环境变量
which java | xargs readlink -f | sed "s/bin\/java//g"
/usr/lib/jvm/java-11-openjdk-11.0.20.1.1-2.el9.x86_64/
- 将环境变量添加到系统配置中：
echo "export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.20.1.1-2.el9.x86_64" >> /etc/profile && echo "export PATH=\$PATH:\$JAVA_HOME/bin" >> /etc/profile && echo "export ANDROID_HOME=/www/server/android-sdk" >> /etc/profile && echo "export PATH=\$PATH:\$ANDROID_HOME/tools:\$ANDROID_HOME/platform-tools" >> /etc/profile && source /etc/profile
- 安装 Android SDK
// 1. 创建 Android SDK 目录
mkdir -p /www/server/android-sdk
// 2. 下载并安装 Android SDK 命令行工具
cd /www/server/android-sdk && wget https://dl.google.com/android/repository/commandlinetools-linux-9477386_latest.zip
// 3. 解压并设置 Android SDK 命令行工具
cd /www/server/android-sdk && unzip commandlinetools-linux-9477386_latest.zip && mkdir -p cmdline-tools/latest && mv cmdline-tools/* cmdline-tools/latest/ 2>/dev/null || true && rm -f commandlinetools-linux-9477386_latest.zip
// 4. 使用 sdkmanager 安装必要的 Android SDK 组件
cd /www/server/android-sdk && ./cmdline-tools/latest/bin/sdkmanager --list | cat
// 5. 安装 platform-tools 和 emulator 工具
cd /www/server/android-sdk && ./cmdline-tools/latest/bin/sdkmanager "platform-tools" "emulator" "build-tools;33.0.0" --sdk_root=/www/server/android-sdk
3. 常用的插件安装
// uiautomator2（Android 测试）
appium plugin install uiautomator2
// xcuitest（iOS 测试）
appium plugin install xcuitest
// espresso（Android Espresso 测试）
appium plugin install espresso
// mac2（Mac 桌面应用测试）
appium plugin install mac2
// windows（Windows 桌面应用测试）
appium plugin install windows
