1伪朽、下載或者更新Homebrew:homebrew官網(wǎng) macOS 不可或缺的套件管理器
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" #下載
$ brew update #更新
$ brew -v
Homebrew 1.1.5
Homebrew/homebrew-core (git revision e151b; last commit 2016-12-26)
2议蟆、使用homebrew來安裝node.js : Node.js教程 node采用C++編寫恩脂,是一個JavaScript的運行環(huán)境汞幢,因為JS是腳本語言需要一個解析器才能運行肛宋,對于寫在HTML頁面的JS,瀏覽器本身就是解析器榨馁,對于需要單獨運行的JS憨栽,Node.js就是解析器。
$ brew install node
$ node -v
v7.3.0
3、安裝npm: NPM 使用介紹 是一個NodeJS包管理和分發(fā)工具屑柔,已經(jīng)成為了非官方的發(fā)布Node模塊(包)的標(biāo)準(zhǔn)屡萤。
$ brew install npm
4、使用npm來安裝appium锯蛀,2017/01/03目前最新的版本是 1.6.3
灭衷,當(dāng)然也可以在 Macos下bitbucket下載appium客戶端次慢,但是坑人的是最新版本是 1.5.3
支持的還只是 iOS10
以下的 UIAutomation
框架基礎(chǔ)上測試旁涤,而 iOS10
以后蘋果使用的卻是基于 XCUITest
,所以只能采用npm安裝咯迫像。但是因為國內(nèi)墻太高而使用npm卻是從國外服務(wù)器下載劈愚,有時候使用npm需要非常長的時間,更多時候是失敗闻妓,推薦使用cnpm來安裝:淘寶 NPM 鏡像 10分鐘同步npmjs.org鏡像菌羽,使用方式和npm完全一致
$ npm install cnpm -g --registry=https://registry.npm.taobao.org
$ npm view appium versions #查看appium所有的版本號
5、使用cnpm安裝appium和appium-doctor:
$ cnpm install -g appium --no-cache
$ cnpm install -g appium
$ cnpm install -g appium-doctor
6由缆、檢查appium環(huán)境檢測:
$ appium-doctor
info AppiumDoctor Appium Doctor v.1.2.5
info AppiumDoctor ### Diagnostic starting ###
info AppiumDoctor ? Xcode is installed at: /Applications/Xcode.app/Contents/Developer
WARN AppiumDoctor ? Xcode Command Line Tools are NOT installed!
info AppiumDoctor ? DevToolsSecurity is enabled.
info AppiumDoctor ? The Authorization DB is set up properly.
info AppiumDoctor ? The Node.js binary was found at: /usr/local/bin/node
info AppiumDoctor ? Carthage was found at: /usr/local/bin/carthage
info AppiumDoctor ? HOME is set to: /Users/denglibing
WARN AppiumDoctor ? ANDROID_HOME is NOT set!
info AppiumDoctor ? JAVA_HOME is set to: /Library/Java/JavaVirtualMachines/jdk1.8.0_111.jdk/Contents/Home
WARN AppiumDoctor ? adb could not be found because ANDROID_HOME is NOT set!
WARN AppiumDoctor ? android could not be found because ANDROID_HOME is NOT set!
WARN AppiumDoctor ? emulator could not be found because ANDROID_HOME is NOT set!
WARN AppiumDoctor ? Bin directory for $JAVA_HOME is not set
info AppiumDoctor ### Diagnostic completed, 6 fixes needed. ###
info AppiumDoctor
info AppiumDoctor ### Manual Fixes Needed ###
info AppiumDoctor The configuration cannot be automatically fixed, please do the following first:
WARN AppiumDoctor - Manually configure ANDROID_HOME.
WARN AppiumDoctor - Manually configure ANDROID_HOME and run appium-doctor again.
WARN AppiumDoctor - Add '$JAVA_HOME/bin' to your PATH environment
info AppiumDoctor ###
info AppiumDoctor
info AppiumDoctor Bye, run appium-doctor again when all manual fixes have been applied!
info AppiumDoctor
常見問題解決:
? Xcode Command Line Tools are NOT installed!
$ xcode-select --install #按照提示安裝即可
? Carthage was NOT found!
$ brew install carthage #carthage:類似cocoapods管理第三方代碼注祖,自動將工程編譯為動態(tài)庫,所以僅支持iOS8以上
WARN AppiumDoctor ? ANDROID_HOME is NOT set!
但是建議安裝安裝編譯器均唉,可以解決其他Android環(huán)境的其他問題 AndroidStudio(https://developer.android.com/studio/index.html?hl=zh-cn)
設(shè)置 ANDROID_HOME 路徑:
http://stackoverflow.com/questions/19986214/setting-android-home-enviromental-variable-on-mac-os-x
設(shè)置 JAVA_HOME 路徑:
http://stackoverflow.com/questions/6588390/where-is-java-home-on-osx-sierra-10-12-el-captain-10-11-yosemite-10-10
JAVA_HOME問題:
當(dāng)前最新JDK版本下載地址 Java SE Development Kit 8u111 (http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
.bash_profile文件:
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_111.jdk/Contents/Home
export ANDROID_HOME=/Users/denglibing/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools:${JAVA_HOME}/bin
7是晨、安裝appium客戶端,上面的操作只是安裝了server端舔箭,接下來需要安裝測試代碼運行所依賴的客戶端罩缴,我們以python為例:
git clone https://github.com/appium/python-client
cd python-client
#謝謝 @GentHuang 提醒
sudo python setup.py install
如果提示下面錯誤:
python setup.py install
Password:
Traceback (most recent call last):
File "setup.py", line 19, in <module>
from appium.common.helper import library_version
File "/Users/denglibing/HDProject/GithubProject/python-client/python-client/appium/common/helper.py", line 20
def extract_const_attributes(cls: type) -> Dict[str, Any]:
^
SyntaxError: invalid syntax
需要使用如下命令安裝(語法錯誤,需要使用python3层扶,沒有請自行下載安裝):
python3 setup.py install
8箫章、對于 iOS10
以上的測試,需要下載安裝 appium-xcuitest-driver 驅(qū)動:Appium iOS driver, backed by Apple XCUITest
, 當(dāng)然也可以在 /usr/local/lib/node_modules/appium/node_modules/.2.5.1@appium-xcuitest-driver/WebDriverAgent/
找到該項目镜会,執(zhí)行 carthage update
, 選擇 WebDriverAgentRunner
這個target編譯即可檬寂。
其他相關(guān)的安裝:
$ ./Scripts/bootstrap.sh #感謝網(wǎng)友 @托托李_742f 的提醒,添加該命令解決很多人編譯WebDriverAgent不通過的問題戳表。
$ brew install libimobiledevice --HEAD # install from HEAD to get important updates
$ brew install ideviceinstaller # 只是對iOS9有用
$ npm install -g ios-deploy # iOS10 以后的版本安裝ios-deploy
$ sudo gem install xcpretty # 真機(jī)需要安裝 xcpretty
不太熟悉WebDriverAgent的可以看看這個博客:
https://testerhome.com/topics/7220
9桶至、下載測試代碼并且測試,官網(wǎng)上的測試代碼坑很多扒袖,這個問題我困擾我好久塞茅。一開始還以為是自己那個環(huán)境出問題還是流程不對,結(jié)果真的只是官網(wǎng)測試代碼本身問題季率,當(dāng)然可以自己編寫代碼測試咯野瘦,也可以下載我的一個簡單的 erduoniba/appium_ios_sample_code
先啟動 appium
服務(wù)器:
$ appium &
再執(zhí)行模擬器的python客戶端的代碼測試
$ cd sample-code/apps/HHH
#在sample-code/apps/HHH/build/Release-iphonesimulator/得到HHH.app包
$ xcodebuild -sdk iphonesimulator
Build settings from command line:
SDKROOT = iphonesimulator10.2
=== BUILD TARGET HHH OF PROJECT HHH WITH THE DEFAULT CONFIGURATION (Release) ===
...
...
...
Signing Identity: "-"
/usr/bin/codesign --force --sign - --timestamp=none /Users/denglibing/Desktop/sample-code/apps/HHH/build/Release-iphonesimulator/HHH.app
** BUILD SUCCEEDED **
$ cd sample-code/examples/python
$ python ios_simple_simulator.py # 執(zhí)行測試腳本時,會遇到 HTMLTestRunner 錯誤的問題,這個是因為第二篇也對這個腳本進(jìn)行了測試鞭光,請移步到 這里http://www.reibang.com/p/a673b93d1f98 可以快速解決并輸出測試結(jié)果
test_scroll (__main__.SimpleIOSTests) ... ok
----------------------------------------------------------------------
Ran 1 test in 30.421s
OK
對于真機(jī)吏廉,可能要麻煩些,安裝 appium-xcuitest-driver 驅(qū)動后惰许,生成在真機(jī)上運行的包:
參考資料可以看官網(wǎng)的說明 部署ios-app-到手機(jī)上
# 在 apps/HHH/build/Release-iphoneos/HHH.app 得到 release 包
$ xcodebuild -sdk iphoneos -target HHH -configuration Release CODE_SIGN_IDENTITY="iPhone Distribution: Shenzhen XXXX Technology Co., Ltd. (B9FH944VTE)"
PROVISIONING_PROFILE="08f04032-ca2e-4bb5-b1ba-c32778115f2e"
關(guān)于怎么設(shè)置 CODE_SIGN_IDENTITY
和 PROVISIONING_PROFILE
如何查看 席覆,可以選擇下圖所示的 Development Team
一行, control+c
然后 復(fù)制出去即可
接下來連上真機(jī) 執(zhí)行測試用例代碼:
$ cd sample-code/examples/python
$ python ios_simple_device.py
test_scroll (__main__.SimpleIOSTests) ... ok
----------------------------------------------------------------------
Ran 1 test in 30.421s
OK
10:一些很有幫助的資料
很好的論壇 https://testerhome.com
appium源碼地址: https://github.com/appium/appium
appium官網(wǎng)地址:http://appium.io/
appium中文說明文檔:http://appium.io/slate/cn/master/?ruby#about-appium
11、心得:
整體的流程其實不多汹买,但是在macOS10.12搭建appium的環(huán)境及測試整個過程著實煩躁佩伤,有時候一個小問題就卡1-2天也不好說,而且官網(wǎng)上的文檔和測試代碼已經(jīng)部分誤導(dǎo)我走了非常多的歪路晦毙。
比如
11.1生巡、開始使用 appium1.5.3的mac客戶端,雖然在macOS10.12上也有些問題见妒,確實畢竟GUI用起來非常方便孤荣,可惜是基于 UIAutomation
框架來的,然后在iOS10中已經(jīng)使用了新的框架 XCUITest
须揣,只能廢棄盐股;
11.2、關(guān)于appium如果搭建啊耻卡,進(jìn)行測試啊相關(guān)的文章其實不少疯汁,有中文的也有英文的,可能是作者在那個時候測試兼容過劲赠,但是iOS10上真的很多是誤導(dǎo)了涛目,而且搭建的流程我不建議閱讀 appium中文說明文檔
,畢竟年代太久遠(yuǎn)了凛澎。倒是可以在 appium源碼地址
上多多發(fā)現(xiàn)類似的問題或者多多提問霹肝,作者及團(tuán)隊人員很熱血 ??
11.3、還是環(huán)境問題塑煎,動不動就會失敗沫换,這個時候只能有耐心的多多看看log日志了,log少什么就滿足他們最铁,邊邊角角的一些依賴資源也可以了解了解??讯赏,畢竟程序員需要耐得住寂寞??,上面的流程基于當(dāng)前最新的開發(fā)環(huán)境 Xcode8.2
冷尉、iOS10.2