Macaca App-Inspector 元素定位工具（搭建使用）

一、环境要求

nodejs

macaca-cli

homebrew

carthage

xcode

app-inspector

二、安装

（一）homebrew

下载地址：macOS（或 Linux）缺失的软件包的管理器 — Homebrew

（二）macaca-cli

npm install macaca-cli -g

（三）nodejs

brew install node

#国内访问外网比较困难，需要切换到淘宝源
npm install -g cnpm  -registry=https://registry.npm.taobao.org 

（四）carthage

brew install carthage

carthage用于安装依赖，具体在app-inspector目录下XCTestWD的依赖。

比如：

/Users/liyinchi/TestTool/node-v12.18.3-darwin-x64/lib/node_modules/app-inspector/node_modules/xctestwd

因为npm install app-inspector -g 完成安装后会需要切到目录下安装node_modules/xctestwd的carthage依赖

（五）gradle

brew install gradle

gradle环境用于Android系统

（六）XCode安装

安装Xcode，从Appstore下载即可，有时候官方来不及更新，会出现XCode与app-inspector依赖版本不一致导致无法正常运行XCTestWD项目

（七）安装app-inspector

【模拟器执行】

npm install app-inspector -g

 【真机执行】

安装有 TEAM_ID 的 app-inspector

# cnpm
DEVELOPMENT_TEAM_ID=2RXG6C9738 cnpm i app-inspector -g

# npm
DEVELOPMENT_TEAM_ID=2RXG6C9738 npm i app-inspector -g

1.XCTestWD.xcodeproj重签名

（1）安装依赖

cd /Users/liyinchi/TestTool/node-v12.18.3-darwin-x64/lib/node_modules/app-inspector/node_modules/xctestwd

carthage.sh bootstrap --platform iOS --cache-builds

（2）执行下面命令

cd /Users/liyinchi/TestTool/node-v12.18.3-darwin-x64/lib/node_modules/app-inspector/node_modules/xctestwd/XCTestWD

open XCTestWD.xcodeproj

或XCode打开XCTestWD.xcodeproj，双击打开node_modules目录下的XCTestWD.xcodeproj文件

（3）配置Team、启动自动化、更改包名

原包名Bundle Identifier：XCTestWDRunner.XCTestWDRunner.liyinchideMacBook-Pro.local

更改为iOS公司测试包名？？？

Project看不到Test话，切换Scheme到XCTestWDUITests 

 

XCTestUI项目，默认端口是8100，故app-inspector启动端口也需要是8100

（4）edit schema

指定执行包

备注：需要Debug包才可以，和配置的Bundle Iden

这边包名要改成测试包名一致？？？比如好慷在家Bundle Identifier

 

（八）获取设备号

idevice_id -l

（九）app-inspector

1.获取TEAM_ID

XCTestWD》TARGETS》signing &capabilities

 使用公司的开发团队权限（要让iOS开发邀请你的Apply ID加入developer team中，登录邮箱确认邀请）

启动app-inspector

app-inspector -u 00008020-0019481611D8003A --verbose

（十）获取元素

（十一）常见问题

1.XCTestWD中报错'No such module'Swifter''

原因：XCTestWD依赖没有安装成功

解决办法：（无效）

# 先定位到XCTestWD的目录中
cd /Users/liyinchi/TestTool/node-v12.18.3-darwin-x64/lib/node_modules/app-inspector/node_modules/xctestwd/XCTestWD

# 更新carthage
carthage update

执行carthage update构建失败

原因：XCTestWD项目与最新Xcode版本不兼容，需要等xudafeng更新，重新克隆XCTestWD新项目、重新安装app-inspector（有效）

从报错上面来看，由于当前版本是0.30.1 而最新版是0.38.0

解决办法：（无效）

https://github.com/macacajs/XCTestWD/pull/193

我重新安装了carthage，还是不行

brew install carthage

 参考：Carthage安装与使用（2018.12.4更新） - 简书

提示carthage已经安装最新版，只是没有链接

 解决办法：

brew link carthage

提示需要删除”/usr/local/bin/cathage“这个文件夹路径

解决办法：

sudo rm '/usr/local/bin/carthage'

 

 删除指定目录路径后，重新执行

brew link carthag

 回到之前那步carthage update

cd /Users/liyinchi/TestTool/node-v12.18.3-darwin-x64/lib/node_modules/app-inspector/node_modules/xctestwd

carthage update

 

3.报错”No matching provisioning profiles found: No provisioning profiles with a valid signing identity (i.e. certificate and private key pair) matching the bundle identifier “com.facebook.xctweb-driver-agent” were found.“

解决办法：

xcode》preferance》account中点击 view detail，然后，重新download