iOS自動(dòng)化測試之Appium的安裝和使用

一、前言

因?yàn)樾枰浜蠝y試同學(xué)處理自動(dòng)化測試方面的東西，所以記錄下來自己關(guān)于Appium的安裝和使用，但是主要是關(guān)于安裝的，因?yàn)榘惭b真是遇到了很多坑，另外，我只是關(guān)注iOS App的測試，所以這里沒有測試Android。

Appium 是一個(gè)開源工具，用于自動(dòng)化 iOS 手機(jī)、 Android 手機(jī)和 Windows 桌面平臺(tái)上的原生、移動(dòng) Web 和混合應(yīng)用。
Appium的核心是 客戶端+服務(wù)端 架構(gòu)。所以需要下載客戶端和服務(wù)端。

二、Appium Desktop

對(duì)于Appium Desktop，有2種安裝方式，命令行和安裝包，我這里直接去GitHub下載安裝包：
Github地址：https://github.com/appium/appium-desktop

Appium Desktop

在使用之前，需要閱讀一遍Appium的官方文檔，理解里面的一些概念。文檔里是有中文的。
文檔地址：https://github.com/appium/appium/tree/master/docs

三、使用iOS模擬器

推薦這個(gè)，比較方便，配置環(huán)境簡單，需要電腦上安裝好Xcode+Appium即可。
啟動(dòng)Appium之后，來到此頁面：

Appium

在這里輸入5個(gè)字段即可：

  • platformName固定值：iOS
  • platformVersion固定值：iPhone Simulator
  • automationName固定值：automationName
  • platformVersion模擬器系統(tǒng)版本號(hào)，打開iOS模擬器在關(guān)于里能看到
  • app：要安裝到模擬器里面的安裝包地址，需要是絕對(duì)路徑，經(jīng)測試，需要是.app結(jié)尾的安裝包

這些能力字段，官方文檔是有解釋和舉例的。

填寫完畢之后，點(diǎn)擊啟動(dòng)會(huì)話，即可自動(dòng)打開模擬器。都填寫完畢后的例子：

{
    "platformName": "iOS",
    "deviceName": "iPhone Simulator",
    "automationName": "XCUITest",
    "platformVersion": "14.5",
    "app": "/Users/hou/Desktop/name.app"
}

注意：app字段的安裝包，對(duì)于iOS開發(fā)而言，很容易得到這個(gè)文件，iOS項(xiàng)目工程在模擬器運(yùn)行成功，就可以在Xcode的工程目錄里找到它。

四、使用iOS真機(jī)

4.1 Doctor（可選）

這一步是可選的， 只是為了方便排查問題，不想裝也沒有問題，不過如果iOS和Android都需要自動(dòng)化測試的話，建議安裝一下。
appium-doctor安裝（依賴npm，所以需要有裝過node）:

npm install appium-doctor -g

安裝后執(zhí)行appium-doctor --ios指令，可以查看與iOS相關(guān)配置是否完整。比如我執(zhí)行的結(jié)果：

Appium

4.2 Homebrew

homebrew是 Mac OS 下最優(yōu)秀的包管理工具，沒有之一。去官網(wǎng)首頁，上面有安裝的命令。已經(jīng)安裝過的不用管這個(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)安裝過Python3了
brew install python3

4.4 idevice（可選）

libimobiledevice是一個(gè)使用原生協(xié)議與蘋果iOS設(shè)備進(jìn)行通信的庫。通過這個(gè)庫我們的 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

這里之所以說是可選的，是因?yàn)槿绻b了Xcode，通過Xcode的集成工具，也能拿到設(shè)備信息和列表。命令是：instruments -s devices?；蛘咴赬code的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)測試框架，能夠支持模擬器以及真機(jī)。
WebDriverAgent在 iOS 端實(shí)現(xiàn)了一個(gè)WebDriver server，借助這個(gè) server 我們可以遠(yuǎn)程控制 iOS 設(shè)備。你可以啟動(dòng)、殺死應(yīng)用，點(diǎn)擊、滾動(dòng)視圖，或者確定頁面展示是否正確。
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)安裝過 Carthage：

cd WebDriverAgent
./Scripts/bootstrap.sh

上面這種辦法我自己試了試是不行了，我是使用下面這種：
先安裝好Appium，電腦-應(yīng)用程序->Appium.app->右鍵-顯示包內(nèi)容->Contents，然后搜索WebDriverAgent.xcodeproj，如下圖：

WebDriverAgent

搜到之后，對(duì)文件進(jìn)行右鍵，如下圖：

WebDriverAgent

然后將新打開的文件，全部復(fù)制到一個(gè)新的文件夾（比如自己主頁目錄下）去，例如：

WebDriverAgent

4.7 編譯WebDriverAgent

使用Xcode打開WebDriverAgent工程，配置好證書之后，點(diǎn)擊Xcode的Product->Test，然后就會(huì)運(yùn)行到手機(jī)上， 控制臺(tái)會(huì)輸出手機(jī)的服務(wù)端口號(hào)：

WebDriverAgent

這里我遇到一個(gè)坑，這個(gè)地址，直接輸入到電腦瀏覽器里， 是能得到一個(gè)JSON的，這樣才是正確的，但是我瀏覽器怎么都得不到，而且明明是同一個(gè)網(wǎng)絡(luò)的。后來我的辦法是使用了iproxy進(jìn)行了端口轉(zhuǎn)發(fā)，過程是:

# 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)的問題。比如你替換了端口，那么你瀏覽器輸入的地址就是：http://127.0.0.1:8900

這里我參考的文章：https://codetosurvive1.github.io/posts/webdriver-agent-usb.html

這個(gè)坑的解決：我后來查看了Xcode項(xiàng)目，發(fā)現(xiàn)是項(xiàng)目的開發(fā)者賬號(hào)問題，在解決了開發(fā)者賬號(hào)和bundleId之后，已經(jīng)正常了，瀏覽器輸入Xcode輸出的地址，可以看到JSON。

web

一定要檢查下圖中標(biāo)出來的開發(fā)者賬號(hào)和bundleId。

xcode

4.8 編譯WebDriverAgent

在啟動(dòng)Xcode項(xiàng)目WebDriverAgent之后，并且安裝到真機(jī)之后，打開Appium，啟動(dòng)服務(wù)，來到這個(gè)頁面，輸入下面的的能力字段，應(yīng)該是就可以連接到真機(jī)了。

Appium

例如我填寫的JSON：

{
    "platformName": "iOS",
    "platformVersion": "14.0",
    "deviceName": "iPhone8",
    "automationName": "XCUITest",
    "bundleId": "com.xxxx.xx",  // 要測試App的bundleId
    "udid": "xxexxx"  // 真機(jī)的udid，如果電腦只鏈接了一個(gè)真機(jī)，可以填寫auto
}

五、Appium使用

Appium使用我沒太深入研究，因?yàn)槲抑饕桥浜蠝y試同學(xué)的，不過Appium的Github上，是有中文文檔的，全部看一遍，簡單的錄制和腳本還是很容易上手的。

5.1 打開Appium


appium

Host不用管，不填寫就是本機(jī)，跟填127.0.0.1是一樣的。點(diǎn)擊啟動(dòng)服務(wù)器。

注意，在Appium的菜單-->視圖-->語言。是切換成中文顯示的。

Appium

點(diǎn)擊右上角的 放大鏡??，進(jìn)入主配置界面 填寫設(shè)備信息即可


Appium

如上圖，在啟動(dòng)之后，如果環(huán)境配置有問題，會(huì)有提示信息的，一般情況下，安裝提示解決就可以，不過在啟動(dòng)Appium之前，建議通過appium-doctor驗(yàn)證環(huán)境都是通過的。

六、遇到過的坑

? Error running xcrun simctl

修改Xcode命令行設(shè)置：Xcode > Preferences > Locations


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ù)工作者。
如果讀完覺得有收獲的話，記得關(guān)注和點(diǎn)贊哦。
非要打賞的話，我也是不會(huì)拒絕的。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容