一、前言
因為需要配合測試同學處理自動化測試方面的東西，所以記錄下來自己關于Appium的安裝和使用，但是主要是關于安裝的，因為安裝真是遇到了很多坑，另外，我只是關注iOS App的測試，所以這里沒有測試Android。
Appium 是一個開源工具，用于自動化 iOS 手機、 Android 手機和 Windows 桌面平臺上的原生、移動 Web 和混合應用。
Appium的核心是 客戶端+服務端 架構。所以需要下載客戶端和服務端。
- 關于Appium: http://appium.io/docs/cn/about-appium/intro/
- GitHub地址：https://github.com/appium/appium-desktop
二、Appium Desktop
對于Appium Desktop，有2種安裝方式，命令行和安裝包，我這里直接去GitHub下載安裝包：
Github地址：https://github.com/appium/appium-desktop
在使用之前，需要閱讀一遍Appium的官方文檔，理解里面的一些概念。文檔里是有中文的。
文檔地址：https://github.com/appium/appium/tree/master/docs
三、使用iOS模擬器
推薦這個，比較方便，配置環境簡單，需要電腦上安裝好Xcode+Appium即可。
啟動Appium之后，來到此頁面：
在這里輸入5個字段即可：
-
platformName固定值：iOS -
platformVersion固定值：iPhone Simulator -
automationName固定值：automationName -
platformVersion模擬器系統版本號，打開iOS模擬器在關于里能看到 -
app：要安裝到模擬器里面的安裝包地址，需要是絕對路徑，經測試，需要是.app結尾的安裝包
這些能力字段，官方文檔是有解釋和舉例的。
填寫完畢之后，點擊啟動會話，即可自動打開模擬器。都填寫完畢后的例子：
{
"platformName": "iOS",
"deviceName": "iPhone Simulator",
"automationName": "XCUITest",
"platformVersion": "14.5",
"app": "/Users/hou/Desktop/name.app"
}
注意：
app字段的安裝包，對于iOS開發而言，很容易得到這個文件，iOS項目工程在模擬器運行成功，就可以在Xcode的工程目錄里找到它。
四、使用iOS真機
4.1 Doctor（可選）
這一步是可選的， 只是為了方便排查問題，不想裝也沒有問題，不過如果iOS和Android都需要自動化測試的話，建議安裝一下。
appium-doctor安裝（依賴npm，所以需要有裝過node）:
npm install appium-doctor -g
安裝后執行appium-doctor --ios指令，可以查看與iOS相關配置是否完整。比如我執行的結果：
4.2 Homebrew
homebrew是 Mac OS 下最優秀的包管理工具，沒有之一。去官網首頁，上面有安裝的命令。已經安裝過的不用管這個。
# homebrew官網地址：
https://brew.sh/index_zh-cn
4.3 Python3（一般不用自己裝）
安裝Python3，目前Mac系統會自帶兩個版本的Python2和Python3，不用自己再安裝了，真想自己安裝可以使用brew管理和安裝：
# 安裝之前，先看看系統是否已經安裝過Python3了
brew install python3
4.4 idevice（可選）
libimobiledevice是一個使用原生協議與蘋果iOS設備進行通信的庫。通過這個庫我們的 Mac OS 能夠輕松獲得 iOS 設備的信息，安裝命令：
brew install libimobiledevice
libimobiledevice的一些使用方法：
# 查看 iOS 設備日志
idevicesyslog
# 查看鏈接設備的UDID
idevice_id --list
idevice_id -l
# 查看設備信息
ideviceinfo
# 獲取設備時間
idevicedate
# 獲取設備名稱
idevicename
# 端口轉發
iproxy XXXX YYYY
# 屏幕截圖
idevicescreenshot
這里之所以說是可選的，是因為如果裝了Xcode，通過Xcode的集成工具，也能拿到設備信息和列表。命令是：
instruments -s devices。或者在Xcode的Window-->Devices and Simulators也可以看到。
4.5 安裝Carthage
Carthage是一款iOS項目依賴管理工具，與Cocoapods有著相似的功能，可以幫助你方便的管理三方依賴。它會把三方依賴編譯成framework，以framework的形式將三方依賴加入到項目中進行使用和管理。
WebDriverAgent本身使用了Carthage管理項目依賴，因此需要提前安裝Carthage。命令：
brew install carthage
4.6 獲取WebDriverAgent
WebDriverAgent是 Facebook 推出的一款 iOS 移動測試框架，能夠支持模擬器以及真機。
WebDriverAgent在 iOS 端實現了一個WebDriver server，借助這個 server 我們可以遠程控制 iOS 設備。你可以啟動、殺死應用，點擊、滾動視圖，或者確定頁面展示是否正確。
Clone下項目，Github地址是：
https://github.com/facebookarchive/WebDriverAgent
使用GUI或者命令Clone：
git clone https://github.com/facebook/WebDriverAgent.git
下載項目之后，使用命令進行操作，確保之前已經安裝過 Carthage：
cd WebDriverAgent
./Scripts/bootstrap.sh
上面這種辦法我自己試了試是不行了，我是使用下面這種：
先安裝好Appium，電腦-應用程序->Appium.app->右鍵-顯示包內容->Contents，然后搜索WebDriverAgent.xcodeproj，如下圖：
搜到之后，對文件進行右鍵，如下圖：
然后將新打開的文件，全部復制到一個新的文件夾（比如自己主頁目錄下）去，例如：
4.7 編譯WebDriverAgent
使用Xcode打開WebDriverAgent工程，配置好證書之后，點擊Xcode的Product->Test，然后就會運行到手機上， 控制臺會輸出手機的服務端口號：
這里我遇到一個坑，這個地址，直接輸入到電腦瀏覽器里， 是能得到一個JSON的，這樣才是正確的，但是我瀏覽器怎么都得不到，而且明明是同一個網絡的。后來我的辦法是使用了iproxy進行了端口轉發，過程是:
# 1.安裝 usbmuxd
brew install usbmuxd
# 2.獲取手機的udid
idevice_id -l
# 3.設置端口轉發
# 第一個8900：為電腦端的端口 第二個8100：為手機端webdriveragent服務的端口
# 最后的數字：為自己手機的序列號
iproxy 8900 8100 -u 743430xxxxxxxxd9bc99
這時，我在電腦瀏覽器輸入地址就可以得到JSON了，需要注意的是，端口號的問題。比如你替換了端口，那么你瀏覽器輸入的地址就是：http://127.0.0.1:8900
這里我參考的文章：https://codetosurvive1.github.io/posts/webdriver-agent-usb.html
這個坑的解決：我后來查看了Xcode項目，發現是項目的開發者賬號問題，在解決了開發者賬號和bundleId之后，已經正常了，瀏覽器輸入Xcode輸出的地址，可以看到JSON。
一定要檢查下圖中標出來的開發者賬號和bundleId。
4.8 編譯WebDriverAgent
在啟動Xcode項目WebDriverAgent之后，并且安裝到真機之后，打開Appium，啟動服務，來到這個頁面，輸入下面的的能力字段，應該是就可以連接到真機了。
例如我填寫的JSON：
{
"platformName": "iOS",
"platformVersion": "14.0",
"deviceName": "iPhone8",
"automationName": "XCUITest",
"bundleId": "com.xxxx.xx", // 要測試App的bundleId
"udid": "xxexxx" // 真機的udid，如果電腦只鏈接了一個真機，可以填寫auto
}
五、Appium使用
Appium使用我沒太深入研究，因為我主要是配合測試同學的，不過Appium的Github上，是有中文文檔的，全部看一遍，簡單的錄制和腳本還是很容易上手的。
5.1 打開Appium
Host不用管，不填寫就是本機，跟填127.0.0.1是一樣的。點擊啟動服務器。
注意，在Appium的菜單-->視圖-->語言。是切換成中文顯示的。
點擊右上角的 放大鏡??，進入主配置界面 填寫設備信息即可
如上圖，在啟動之后，如果環境配置有問題，會有提示信息的，一般情況下，安裝提示解決就可以，不過在啟動Appium之前，建議通過appium-doctor驗證環境都是通過的。
六、遇到過的坑
? Error running xcrun simctl
修改Xcode命令行設置：Xcode > Preferences > Locations
? Xcode is installed at: /Applications/Xcode.app/Contents/Developer
? Xcode Command Line Tools are
? Carthage was NOT found!
使用Homebrew安裝Carthage即可。
? opencv4nodejs cannot be found.
下載cmake：https://cmake.org/download/
安裝后配置環境變量
"/Applications/CMake.app/Contents/bin/"
sudo cnpm -g install opencv4nodejs --unsafe-perm=true --allow-root --loglevel silly
cnpm install opencv4nodejs
? ffmpeg cannot be found
下載FFmpeg：https://ffmpeg.zeranoe.com/builds/，然后配置環境變量
? mjpeg-consumer cannot be found.
安裝：
sudo cnpm i -g mjpeg-consumer --unsafe-perm=true --allow-root
? set-simulator-location is not installed
brew install lyft/formulae/set-simulator-location
? idb and idb_companion are not installed
brew tap facebook/fb
brew install idb-companion
pip3.8 install fb-idb # 和自己的py版本一致
? applesimutils cannot be found
brew tap wix/brew
brew install applesimutils
? ios-deploy cannot be found
sudo cnpm install -g ios-deploy --unsafe-perm=true --allow-root
? bundletool.jar cannot be found
下載文件，配置環境變量
http://appium.io/docs/en/writing-running-appium/android/android-appbundle/
? gst-launch-1.0 and/or gst-inspect-1.0 cannot be found
brew install gstreamer gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav
最后使用appium-doctor驗證環境配置。
END。
我是小侯爺。
在帝都艱苦奮斗，白天是上班族，晚上是知識服務工作者。
如果讀完覺得有收獲的話，記得關注和點贊哦。
非要打賞的話，我也是不會拒絕的。
