Mac 机器上搭建 Appium

[可选]安装Homebrew
  /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

一、自动化测试服务器：安装 Appium
1、安装 Node.js，支持的版本：^14.17.0 || ^16.13.0 || >=18.0.0
   npm Version >= 8
   下载：https://nodejs.org/

2、安装 Appium Doctor
   sudo npm install @appium/doctor -g
   用法: appium-doctor -h
        appium-doctor --ios
        appium-doctor --android

3、安装 Appium
   sudo npm i -g appium --drivers=xcuitest,uiautomator2
   更新： sudo npm update -g appium

  [NOTE]: 此处指定了 xcuitest,uiautomator2 驱动，之后就不需要再单独安装了。

4、安装 Appium Drivers
    MacOS:  sudo appium driver install mac2    
    Win:  appium driver install --source=npm appium-windows-driver

二、自动化测试服务器：安装安卓 UiAutomator2
1、安装 Java JDK
     brew install openjdk@21
     echo 'export PATH="/usr/local/opt/openjdk/bin:$PATH"' >> ~/.zshrc
     source ~/.zshrc

   设置 JAVA_HOME 环境变量

2、安装 Android SDK
   安装 Android command-line tools：
     https://developer.android.com/studio#command-line-tools-only
     下载解压后把 bin、lib 一层全部目录和文件放到 ~/Library/Android/sdk/cmdline-tools/latest 目录下。
   安装 Android SDK 及 Platform-Tools:
     sdkmanager "platform-tools" "platforms;android-33" "build-tools;33.0.3"

     sdkmanager --list [options] \
           [--channel=channel_id] // Channels: 0 (stable), 1 (beta), 2 (dev), or 3 (canary)

   设置环境变量：
     ANDROID_HOME=~/Library/Android/sdk
     ANDROID_PATH=~/Library/Android/sdk/platform-tools

   参考：
     https://developer.android.com/tools/sdkmanager
     https://developer.android.com/tools/releases/platform-tools

3、安装 UiAutomator2 驱动
     appium driver install uiautomator2

   确认：重新运行 appium，显示的可用驱动包括 uiautomator2@2.0.5

   [NOTE]: 此安装在shell中进行，需注意确保VPN或代理在终端中可用。

三、自动化测试服务器：安装iOS xcuitest
1、安装 Xcode、 iOS SDK + Simulator_Runtime、Xcode Command Line Tools
2、安装 xcuitest
     appium driver install xcuitest

     [NOTE]: 
     此安装在shell中进行，需注意确保VPN或代理在终端中可用。
     若安装时报 EACESS 错误，根据错误说明，可能需要执行： sudo chown -R 501:20 "/Users/<当前登录用户名>/.npm"

四、自动化测试服设备：安卓手机设置
1、打开开发者模式
2、启用USB调试
3、打开参数开关
  Quick settings developer tiles
  添加：Memory
     Take bug report
     System UI demo mode
     Desktop backup password
     Stay awake
     Enable Bluetooth Host Controller Interface (HCI) snoop log

参考：https://developer.android.com/studio/debug/dev-options

4、通过 USB 连接到 Appium 服务器，在 Appium 服务器上设置手机的adb端口：
     adb -s <序列号> tcpip 5555 
  或：adb -d tcpip 5555
5、查看手机 IP 地址
   可执行： adb -s <序列号> shell ip -f inet addr show wlan0
      或： adb -d shell ip -f inet addr show wlan0
   或在wifi连接属性里查看IP地址。
6、断开 USB 连接，通过 Wifi 连接，在 Appium 服务器上连接手机：
   adb connect 192.168.x.x:5555

五、自动化测试服设备：iOS手机设置

五、启动 Appium：
1、创建自动启动服务（Mac）
   下面的 /Users/admin 为当前登录用户的 HOME 目录。 
 （a）创建 /Users/admin/start-appium.sh ，并执行 chmod +x 设置可执行权限。
#!/bin/zsh
/usr/local/bin/appium -p 4723 --log /Users/admin/log/appium/appium.log --log-level debug --local-timezone 

 （b）创建 /Library/LaunchDaemons/com.my.appium.daemon.plist 文件。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>Label</key>
    <string>com.my.appium.daemon</string>
    <key>KeepAlive</key>
    <true/>
    <key>ProcessType</key>
    <string>Interactive</string>
    <key>RunAtLoad</key>
    <true/>
    <key>Program</key>
    <string>/Users/admin/start-appium.sh</string>
    <key>ProgramArguments</key>
    <array>
    </array>
    <key>UserName</key>
    <string>admin</string>  <!-- 修改为实际的用户名 -->
    <key>GroupName</key>
    <string>staff</string>
    <key>WorkingDirectory</key>
    <string>/Users/admin</string>  <!-- 修改为实际的用户目录 -->
    <key>EnvironmentVariables</key>
    <dict>
        <key>JAVA_HOME</key>
        <string>/usr/local/opt/openjdk</string>
        <key>ANDROID_HOME</key>
        <string>/Users/admin/Library/Android/sdk</string>
        <key>ANDROID_PATH</key>
        <string>/Users/admin/Library/Android/sdk/platform-tools</string>
        <key>PATH</key>
        <string>/usr/local/opt/openjdk/bin:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/System/Cryptexes/App/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/Library/Apple/usr/bin</string>
    </dict>
  </dict>
</plist>

2、启动服务（Mac） 
    sudo launchctl enable system/com.my.appium.daemon
    sudo launchctl bootstrap system /Library/LaunchDaemons/com.my.appium.daemon.plist
    
3、需要停止appium时，需要先停止服务，再杀appium进程
Mac：
   sudo launchctl bootout system /Library/LaunchDaemons/com.my.appium.daemon.plist
   查找进程： lsof -i tcp: 4723
   杀进程： kill <pid>
Win：
   查找进程：netstat -aon | findstr 4723
   杀进程：taskkill /f /pid <pid>

六、客户端
1、安装 Python3，含pip3
   brew install python3

2、安装 Appium-Python-Client
   pip3 install -I --index-url https://mirrors.aliyun.com/pypi/simple Appium-Python-Client

  [NOTE]: 如果报错（This environment is externally managed），加上 --break-system-packages 参数。