操作步驟
- 安裝JDK
- jdk需要是1.8版本
- 配置環(huán)境變量
- win+r輸入rundll32.exe sysdm.cpl,EditEnvironmentVariables
- 環(huán)境變量新增:JAVA_HOME = “jdk安裝地址”,同時在path下新增%JAVA_HOME%\jre\bin,%JAVA_HOME%\jre\bin
-
校驗是否安裝成功,命令行中輸入 java -version,顯示如下即配置成功
image.png
2.安裝Nodejs
- nodejsv8.0 或者更高版本
-
nodejs集成了npm,命令行中輸入npm -v ,顯示版本即可
image.png - 配置默認全局模塊的存放路徑,方便查找
- npm config set prefix "node安裝路徑\node_global"
- npm config set cache "node安裝路徑\node_cache"
- 配置環(huán)境變量:將"node安裝路徑\node_global"添加到系統(tǒng)變量path中
- 安裝cnpm
- npm config set registry http://registry.npm.taobao.org
- 命令行輸入 cnpm -v ,這一步如果報錯,請參考上面---配置node_globa環(huán)境變量
- 安裝SDK
-
sdk下載對應版本即可
image.png -
解壓后打開SDK manager.exe 文件,安裝如下
image.png -
配置環(huán)境變量
- 新增系統(tǒng)變量:ANDROID_HOME = sdk安裝地址
-
;%ANDROID_HOME%\platform-tools;%ANDROID_HOME%\tools;加入到系統(tǒng)變量path中
image.png - 命令行輸入 adb version 顯示對應版本即成功
4.安裝Gradle
- Gradle下載解壓即可
- 配置環(huán)境變量
- 新增系統(tǒng)變量:GRADLE_HOME = gradle解壓地址
- %GRADLE_HOME%\bin 加入到系統(tǒng)變量path中
-
命令行輸入gradle -v
image.png
5.安裝Macaca
-
命令行:cnpm i macaca-cli -g,出現(xiàn)一只猴子臉說明安裝成功
image.png - 由于前面設置了全局模塊安裝路徑,在對應路徑下會生成 macaca-cli文件夾
-
命令行:macaca doctor,查看macaca配置
image.png - 根據(jù)需要安裝驅(qū)動即可
- cnpm i macaca-android -g 安裝Android驅(qū)動
- cnpm i macaca-ios -g 安裝ios驅(qū)動
- cnpm i macaca-electron -g 安裝electron環(huán)境驅(qū)動
- cnpm i macaca-chrome -g 安裝chrome驅(qū)動
- cnpm install webdriver-client 安裝webdriver-client
- cnpm i app-inspector -g 安裝app-inspector
- 開源鏡像
- chrome-driver:http://npm.taobao.org/mirrors/chromedriver/
- electron:https://npm.taobao.org/mirrors/electron/
- 官網(wǎng)
- Sample示例地址: https://github.com/macaca-sample/macaca-test-sample-python
- Python API文檔:https://macacajs.github.io/wd.py/
- 常用命令
- 啟動Macaca服務
- macaca server --verbose 加--verbose,打印詳細日志
- python tests/macaca-desktop-sample.test.py 運行測試
- macaca server 正常模式
- macaca server -p 3456 設置端口
- macaca server -p 3456 & 設置端口后臺運行
- macaca server --verbose輸出詳細日志
- 測試
- macaca run 運行當前目錄用例集
- macaca run -d ./test 運行指定目錄下用例集
- macaca doctor 環(huán)境檢查
- 幫助
- macaca -h
- macaca server -h
- macaca run -h
- macaca doctor -h
問題記錄
- SDK manager.exe文件打不開,閃退
- 解決方案:
- 文件下載地址:https://pan.baidu.com/s/19EYPseh43Ks0gnsv30xlUA
- 密碼:hi5u
- 下載解壓后將 find_java.bat替換掉SDK文件下\tools\lib下面的find_java.bat;原因好像是r17以上的版本重寫了find_java.bat,需要替換回r16的版本
2.SDK manager下載不了東西或者很慢
- 解決方案:可以配置對應host;將dl.google.com通過https://site.ip138.com/dl.google.com/ 查詢對應可用ip,將能夠ping 通的ip加入到host里即可
image.png
3.執(zhí)行cnpm i macaca-android -g 報錯,提示License for package Android SDK Build-Tools 28.0.2 not accepted

image.png
- 解決方案
-
(1)進入sdk安裝目錄下,文件地址行輸入cmd回車,打開命令行工具
image.png - (2)輸入sdkmanager.bat --licenses,執(zhí)行之后,它會提示你去允許認證,然后命令會提醒你確定y/n(accept lincense),一路y下去便可以了。
- (3)若提示“Error: Unknown argument --licenses,說明版本太低,執(zhí)行sdkmanager.bat --update,一路y下去便可以了。
- (4)成功后,再次執(zhí)行cnpm i macaca-android -g 即可
-
4.執(zhí)行腳本時,提示 app-debug.apk不存在,如圖

image.png
- 解決方案
-
(1)檢查macaca-andriod 安裝路徑下的是否有如下兩個包
image.png - (2)如果沒有,則說明 macaca-android 未安裝成功,再次執(zhí)行cnpm i macaca-android -g
- (3)若還是無法成功,則說明SDK未配置,請仿照上面再次安裝SDK所需內(nèi)容
-
-
執(zhí)行cnpm i macaca-chrome -g報錯,如圖
image.png











