macaca-java for ios 自动化环境搭建
基础原理解析:https://testerhome.com/topics/6608
一、环境搭建
1、安装eclipse; -----Java开发调试工具 下载地址:https://www.eclipse.org/downloads/ PS:java调试工具，可根据自身情况选择不下载。
2、安装node.js 中文网地址:http://nodejs.cn/ node.js安装方式一: (1)安装brew
/usr/bin/ruby -e "$(curl -fsSLhttps://raw.githubusercontent.com/Homebrew/install/master/install)" (2)安装node
brew install node (3)验证node安装
验证node安装:node -v
验证npm安装:npm -v node.js安装方式二: (1)安装node
访问node.js官网(https://nodejs.org/en/download/)，下载安装包，一键安装; (2)验证node安装
node -v npm -v 3、安装xcode
进入https://developer.apple.com/download/more/网站找到要下载版本的xcode(xcode安装需要8.3或更高的版本)，下载安装。
PS:可以在appstore上下载xcode，但只支持最新版本。 4、安装usbmuxd ----通过 USB 通道测试 iOS 真机
brew install usbmuxd
5、安装ios-webkit-debug-proxy ----被测试应用中包含webview时安装
brew install ios-webkit-debug-proxy 6、安装ios-deploy 装包工具
npm i ios-deploy -g 7、安装carthage
brew install carthage
PS:Macaca XCTestWD 的代码管理使用carthage
8、安装macaca
npm i -g macaca-cli ----macaca命令集
npm i -g macaca-ios ----macaca-ios自动化驱动
macaca doctor ----检查macaca环境 8、安装inspector
npm i app-inspector -g
PS:卸载命令:npm uninstall app-inspector -g 9、安装maven
brew install maven 10、下载iOS自动化框架代码
下载SVN上的iOS自动化框架代码，路径:https://******/product/qa-platform/automation/iOSMacaca/ios_a utomation/;
进入工程目录;
安装工程依赖库:mvn -s settings.xml clean install -DskipTests
如果下载依赖过程中报错，可能是由于mvn -s命令没有生效导致的，建议将根目录下settings.xml中的依赖配置到本地Maven目录下的settings.xml中
本地目录:/usr/local/Cellar/maven/3.3.9/libexec/conf
PS:eclipse与maven的关联配置这里不做介绍，如果后续有需求会补充到此文档。 11、xctestwd配置
macaca的webdriver存在两个，一个为app-inspector调试需要，一个为iOS自动化需要，路径分别为: /usr/local/lib/node_modules/app-inspector/node_modules/xctestwd/XCTestWD/XCTestWD.xcodeproj
----app-inspector启动需要配置
/usr/local/lib/node_modules/macaca-ios/node_modules/xctestwd/XCTestWD/XCTestWD.xcodeproj ----ios自 动化需要配置
macaca的两个webdriver配置相同，下面会主要以macaca-ios为例来介绍配置: (1)安装证书，证书下载地址:https://*******/iQIYITest/product/qa-platform/automation/iOSMacaca/identifier/
ios_automation.p12 (证书密码:123456); (2)下载profile，profile下载地址:https://*******/product/qa-platform
/automation/iOSMacaca/identifier/ios_automation.mobileprovision; (3)使用xcode打开/usr/local/lib/node_modules/macaca-ios/node_modules/xctestwd/XCTestWD/XCTestWD.xcodeproj工程文件; (4)配置XCTestWD，选择XCTestWD target，配置Gerneral中的sign以及Build Settings中的signing，具体见下图:
(5)配置
XCTestWDUITests，选择XCTestWDUITeststarget，配置Gerneral中的sign以及Build Settings中的signing，具体见下图:
(6)使用xcode打开/usr/local/lib/node_modules/app-inspector/node_modules/xctestwd/XCTestWD/XCTestWD.xcodeproj工程文件，分别按 照(4)(5)进行配置。
PS:如果设备不可用，无法将xctestwd安装到设备上请自行更新profile文件。
二、模拟器运行
1、启动macaca server macaca server --verbose
2、执行用例
新建窗口进入macaca Java的demo工程根目录命令行执行:mvn test
三、inspector使用
1、启动macaca server macaca server --verbose
2、获取device 的udid 设备的udid获取方式如下:
(1)模拟器获取设备udid:xcrun simctl list ; (2)查看模拟器&连接设备udid:instruments-s ; (3)连接设备udid:xcode查看Hardware ->devices -> manage devices 。
3、运行webdriver
打开xcode，选择WebDriverAgentRunner target，将webdriver运行到连接的设备上。
4、launch
app-inspector -u YOUR-DEVICE-ID --verbose
5、使用inspector元素查找工具 浏览器打开:http://current_ip:5678或http://localhost:5678
四、真机运行
1、连接设备
MAC连接能运行测试包的设备
2、启动macaca server
macaca server --verbose
3、修改java代码中的运行配置
目前的运行配置以macaca提供的demo为例。
(1)修改工程文件中的bootstrap/src/test/java/com/javademo/utils/Config.java文件以便于可以真机运行，以下为Config.java文件中的 代码片段:
// ios平台相关信息
publicstaticfinalString IOS_PLATFORM_NAME ="iOS";
publicstaticfinalString IOS_DEVICE_NAME ="Ranli1"; //连接设备的name
publicstaticfinalString IOS_APP = RootPath + File.separator +"app/iQiYiPhoneVideo.app_2017-01-15_18-52.zip";
包的路径，请放置开发包
publicstaticfinalString IOS_UDID ="40911ef567d57fcff5813d774fdeb108eaefde1b"; //连接设备的udid publicstaticfinalString IOS_BUNDLE_ID ="************"; //测试安装包的bundle id
(2)修改工程文件中的bootstrap/src/test/java/com/javademo/cases/BaseTest.java 文件以便于Config.java文件中配置的设备信息何以传递到server，以下为BaseTest.java的代码片段:
4、执行用例
新建窗口进入macaca Java的demo工程根目录命令行执行，命令如下:
全部case运行:mvn test 单条case运行:mvntest-Dtest=packagename.classname(mvntest-Dtest=*****.cases.baseline.offline.function.Test_21674
1)