一拒课、前言
因?yàn)樾枰浜蠝y(cè)試同學(xué)處理自動(dòng)化測(cè)試方面的東西徐勃，所以記錄下來(lái)自己關(guān)于Appium的安裝和使用，但是主要是關(guān)于安裝的早像，因?yàn)榘惭b真是遇到了很多坑僻肖，另外，我只是關(guān)注iOS App的測(cè)試卢鹦，所以這里沒(méi)有測(cè)試Android臀脏。
Appium 是一個(gè)開(kāi)源工具，用于自動(dòng)化 iOS 手機(jī)冀自、 Android 手機(jī)和 Windows 桌面平臺(tái)上的原生揉稚、移動(dòng) Web 和混合應(yīng)用。
Appium的核心是 客戶端+服務(wù)端 架構(gòu)熬粗。所以需要下載客戶端和服務(wù)端搀玖。
- 關(guān)于Appium: http://appium.io/docs/cn/about-appium/intro/
- GitHub地址：https://github.com/appium/appium-desktop
二、Appium Desktop
對(duì)于Appium Desktop驻呐，有2種安裝方式灌诅，命令行和安裝包，我這里直接去GitHub下載安裝包：
Github地址：https://github.com/appium/appium-desktop
在使用之前暴氏，需要閱讀一遍Appium的官方文檔延塑，理解里面的一些概念。文檔里是有中文的答渔。
文檔地址：https://github.com/appium/appium/tree/master/docs
三关带、使用iOS模擬器
推薦這個(gè)，比較方便沼撕，配置環(huán)境簡(jiǎn)單宋雏，需要電腦上安裝好Xcode+Appium即可。
啟動(dòng)Appium之后务豺，來(lái)到此頁(yè)面：
在這里輸入5個(gè)字段即可：
-
platformName固定值：iOS -
platformVersion固定值：iPhone Simulator -
automationName固定值：automationName -
platformVersion模擬器系統(tǒng)版本號(hào)磨总，打開(kāi)iOS模擬器在關(guān)于里能看到 -
app：要安裝到模擬器里面的安裝包地址，需要是絕對(duì)路徑笼沥，經(jīng)測(cè)試蚪燕，需要是.app結(jié)尾的安裝包
這些能力字段，官方文檔是有解釋和舉例的奔浅。
填寫完畢之后馆纳，點(diǎn)擊啟動(dòng)會(huì)話，即可自動(dòng)打開(kāi)模擬器汹桦。都填寫完畢后的例子：
{
"platformName": "iOS",
"deviceName": "iPhone Simulator",
"automationName": "XCUITest",
"platformVersion": "14.5",
"app": "/Users/hou/Desktop/name.app"
}
注意：
app字段的安裝包鲁驶，對(duì)于iOS開(kāi)發(fā)而言，很容易得到這個(gè)文件舞骆，iOS項(xiàng)目工程在模擬器運(yùn)行成功钥弯，就可以在Xcode的工程目錄里找到它径荔。
四、使用iOS真機(jī)
4.1 Doctor（可選）
這一步是可選的脆霎， 只是為了方便排查問(wèn)題总处，不想裝也沒(méi)有問(wèn)題，不過(guò)如果iOS和Android都需要自動(dòng)化測(cè)試的話绪穆，建議安裝一下辨泳。
appium-doctor安裝（依賴npm，所以需要有裝過(guò)node）:
npm install appium-doctor -g
安裝后執(zhí)行appium-doctor --ios指令玖院，可以查看與iOS相關(guān)配置是否完整菠红。比如我執(zhí)行的結(jié)果：
4.2 Homebrew
homebrew是 Mac OS 下最優(yōu)秀的包管理工具，沒(méi)有之一难菌。去官網(wǎng)首頁(yè)试溯，上面有安裝的命令。已經(jīng)安裝過(guò)的不用管這個(gè)郊酒。
# homebrew官網(wǎng)地址：
https://brew.sh/index_zh-cn
4.3 Python3（一般不用自己裝）
安裝Python3遇绞，目前Mac系統(tǒng)會(huì)自帶兩個(gè)版本的Python2和Python3，不用自己再安裝了燎窘，真想自己安裝可以使用brew管理和安裝：
# 安裝之前摹闽，先看看系統(tǒng)是否已經(jīng)安裝過(guò)Python3了
brew install python3
4.4 idevice（可選）
libimobiledevice是一個(gè)使用原生協(xié)議與蘋果iOS設(shè)備進(jìn)行通信的庫(kù)。通過(guò)這個(gè)庫(kù)我們的 Mac OS 能夠輕松獲得 iOS 設(shè)備的信息褐健，安裝命令：
brew install libimobiledevice
libimobiledevice的一些使用方法：
# 查看 iOS 設(shè)備日志
idevicesyslog
# 查看鏈接設(shè)備的UDID
idevice_id --list
idevice_id -l
# 查看設(shè)備信息
ideviceinfo
# 獲取設(shè)備時(shí)間
idevicedate
# 獲取設(shè)備名稱
idevicename
# 端口轉(zhuǎn)發(fā)
iproxy XXXX YYYY
# 屏幕截圖
idevicescreenshot
這里之所以說(shuō)是可選的付鹿，是因?yàn)槿绻b了Xcode，通過(guò)Xcode的集成工具蚜迅，也能拿到設(shè)備信息和列表舵匾。命令是：
instruments -s devices∷唬或者在Xcode的Window-->Devices and Simulators也可以看到坐梯。
4.5 安裝Carthage
Carthage是一款iOS項(xiàng)目依賴管理工具，與Cocoapods有著相似的功能刹帕，可以幫助你方便的管理三方依賴吵血。它會(huì)把三方依賴編譯成framework，以framework的形式將三方依賴加入到項(xiàng)目中進(jìn)行使用和管理偷溺。
WebDriverAgent本身使用了Carthage管理項(xiàng)目依賴蹋辅，因此需要提前安裝Carthage。命令：
brew install carthage
4.6 獲取WebDriverAgent
WebDriverAgent是 Facebook 推出的一款 iOS 移動(dòng)測(cè)試框架亡蓉，能夠支持模擬器以及真機(jī)。
WebDriverAgent在 iOS 端實(shí)現(xiàn)了一個(gè)WebDriver server喷舀，借助這個(gè) server 我們可以遠(yuǎn)程控制 iOS 設(shè)備砍濒。你可以啟動(dòng)淋肾、殺死應(yīng)用，點(diǎn)擊爸邢、滾動(dòng)視圖樊卓，或者確定頁(yè)面展示是否正確。
Clone下項(xiàng)目杠河，Github地址是：
https://github.com/facebookarchive/WebDriverAgent
使用GUI或者命令Clone：
git clone https://github.com/facebook/WebDriverAgent.git
下載項(xiàng)目之后碌尔，使用命令進(jìn)行操作，確保之前已經(jīng)安裝過(guò) Carthage：
cd WebDriverAgent
./Scripts/bootstrap.sh
上面這種辦法我自己試了試是不行了券敌，我是使用下面這種：
先安裝好Appium唾戚，電腦-應(yīng)用程序->Appium.app->右鍵-顯示包內(nèi)容->Contents，然后搜索WebDriverAgent.xcodeproj待诅，如下圖：
搜到之后叹坦，對(duì)文件進(jìn)行右鍵，如下圖：
然后將新打開(kāi)的文件卑雁，全部復(fù)制到一個(gè)新的文件夾（比如自己主頁(yè)目錄下）去募书，例如：
4.7 編譯WebDriverAgent
使用Xcode打開(kāi)WebDriverAgent工程，配置好證書之后测蹲，點(diǎn)擊Xcode的Product->Test莹捡，然后就會(huì)運(yùn)行到手機(jī)上， 控制臺(tái)會(huì)輸出手機(jī)的服務(wù)端口號(hào)：
這里我遇到一個(gè)坑扣甲，這個(gè)地址篮赢，直接輸入到電腦瀏覽器里， 是能得到一個(gè)JSON的文捶，這樣才是正確的荷逞，但是我瀏覽器怎么都得不到，而且明明是同一個(gè)網(wǎng)絡(luò)的粹排。后來(lái)我的辦法是使用了iproxy進(jìn)行了端口轉(zhuǎn)發(fā)种远，過(guò)程是:
# 1.安裝 usbmuxd
brew install usbmuxd
# 2.獲取手機(jī)的udid
idevice_id -l
# 3.設(shè)置端口轉(zhuǎn)發(fā)
# 第一個(gè)8900：為電腦端的端口 第二個(gè)8100：為手機(jī)端webdriveragent服務(wù)的端口
# 最后的數(shù)字：為自己手機(jī)的序列號(hào)
iproxy 8900 8100 -u 743430xxxxxxxxd9bc99
這時(shí)，我在電腦瀏覽器輸入地址就可以得到JSON了顽耳，需要注意的是坠敷，端口號(hào)的問(wèn)題。比如你替換了端口射富，那么你瀏覽器輸入的地址就是：http://127.0.0.1:8900
這里我參考的文章：https://codetosurvive1.github.io/posts/webdriver-agent-usb.html
這個(gè)坑的解決：我后來(lái)查看了Xcode項(xiàng)目膝迎，發(fā)現(xiàn)是項(xiàng)目的開(kāi)發(fā)者賬號(hào)問(wèn)題，在解決了開(kāi)發(fā)者賬號(hào)和bundleId之后胰耗，已經(jīng)正常了限次，瀏覽器輸入Xcode輸出的地址，可以看到JSON。
一定要檢查下圖中標(biāo)出來(lái)的開(kāi)發(fā)者賬號(hào)和bundleId卖漫。
4.8 編譯WebDriverAgent
在啟動(dòng)Xcode項(xiàng)目WebDriverAgent之后费尽，并且安裝到真機(jī)之后，打開(kāi)Appium羊始，啟動(dòng)服務(wù)旱幼，來(lái)到這個(gè)頁(yè)面，輸入下面的的能力字段突委，應(yīng)該是就可以連接到真機(jī)了柏卤。
例如我填寫的JSON：
{
"platformName": "iOS",
"platformVersion": "14.0",
"deviceName": "iPhone8",
"automationName": "XCUITest",
"bundleId": "com.xxxx.xx", // 要測(cè)試App的bundleId
"udid": "xxexxx" // 真機(jī)的udid，如果電腦只鏈接了一個(gè)真機(jī)匀油，可以填寫auto
}
五缘缚、Appium使用
Appium使用我沒(méi)太深入研究，因?yàn)槲抑饕桥浜蠝y(cè)試同學(xué)的钧唐，不過(guò)Appium的Github上忙灼，是有中文文檔的，全部看一遍钝侠，簡(jiǎn)單的錄制和腳本還是很容易上手的该园。
5.1 打開(kāi)Appium
Host不用管，不填寫就是本機(jī)帅韧，跟填127.0.0.1是一樣的里初。點(diǎn)擊啟動(dòng)服務(wù)器。
注意忽舟，在Appium的菜單-->視圖-->語(yǔ)言双妨。是切換成中文顯示的。
點(diǎn)擊右上角的 放大鏡??叮阅，進(jìn)入主配置界面 填寫設(shè)備信息即可
如上圖刁品，在啟動(dòng)之后，如果環(huán)境配置有問(wèn)題浩姥，會(huì)有提示信息的挑随，一般情況下，安裝提示解決就可以勒叠，不過(guò)在啟動(dòng)Appium之前兜挨，建議通過(guò)appium-doctor驗(yàn)證環(huán)境都是通過(guò)的。
六眯分、遇到過(guò)的坑
? Error running xcrun simctl
修改Xcode命令行設(shè)置：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/
安裝后配置環(huán)境變量
"/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/，然后配置環(huán)境變量
? 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
下載文件弊决，配置環(huán)境變量
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驗(yàn)證環(huán)境配置噪舀。
END。
我是小侯爺。
在帝都艱苦奮斗与倡，白天是上班族先改，晚上是知識(shí)服務(wù)工作者。
如果讀完覺(jué)得有收獲的話蒸走，記得關(guān)注和點(diǎn)贊哦。
非要打賞的話貌嫡，我也是不會(huì)拒絕的比驻。
