- 搭建环境
- PC端:MacOS 10.13.2 + Xcode 9.2 + Python + WebDriverAgent (必须在OS10.12以及以上,并且Xcode9.2以及以上才能顺利安装)
- 手机端:iPhone 8 + IOS 11.2.1
-
Step1 :配置PC端环境
必备软件
如果都已经安装了的话就可以跳过
- 安装Homebrew :
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- 安装python3:
brew install python3
- 安装npm和node:
brew install node
(npm 是用来构建 Inspector, Inspector 是一个 react 的应用,通过往 WebDriverAgent 发 HTTP 请求,返回页面的结构。)
安装 Carthage
- Carthage 是用来解决 xcode project 依赖的,需要在WDA运行脚本并用Xcode打开WDA之前安装。
- 用homebrew安装carthage
brew install carthage #安装 carthage version # 查看版本测试是否安装成功
安装WDA(WebDriverAgent)
- Facebook 推出的一款新的iOS移动测试框架 —— WebDriverAgent(简介),支持真机和模拟器的模拟。
- 需要Xcode9.2以上,而升级Xcode9.2又必须在macOS Sierra以上的版本。
- 安装WDA到home目录下
cd ~ #打开home目录 git clone https://github.com/facebook/WebDriverAgent #下载 cd WebDriverAgent #进入软件目录 ./Scripts/bootstrap.sh #运行初始化脚本,确保之前已经安装过carthage
打开WDA主程序
在Finder中打开即可:打开 Finder,按下 shift + command + G,输入 ~ 回车就可以打开home目录,然后就可以双击WDA目录下的WebDriverAgent.xcodeproj
这个文件,它会自动用Xcode打开。
使用模拟机测试一下WDA运行情况【此步骤可跳过】
可以参考这篇自动化测试网易云音乐的步骤,里面有动图更形象一些。
①设置为Runner:Xcode--Product--Scheme--WebDriverAgentRunner
②进入Test:Xcode--Product--Test,结束后就会出来一个Simulator,而且手机上也安装好软件了。③随后打开127.0.0.1:8100/inspector 这个地址,稍等一会儿,就可以看到一个酷炫的界面。
④之后就可以做模拟机的一些脚本测试操作了,但是本教程是为了要在真机上玩跳一跳外挂,所以模拟机这个步骤可以跳过不做。只是为了好玩放上来的,也顺便测试一下WDA是否可以正常工作。
- 安装Homebrew :
-
Step2:WDA 连接iphone真机
- 和模拟器是一样的,需要先选Runner:
-
但是选择真机后,运行Test:
发现了上述错误,看错误提示安装到真机的话需要签名,意味着需要选择开发者团队证书。
设置证书
- 这里参考了博客:iOS 真机如何安装 WebDriverAgent
- 真机与模拟器最大的区别在于要对 WebDriverAgent 和 测试 App 进行重签名。如果你用的是测试 App 是直接从 Appstore 中下载的,那么可以不用对测试 App 重签名。
- 所以WDA运行模拟机不需要设置证书,但是WDA实装到真机中的话,需要具备【开发者证书】
-
步骤: ①重签名 WebDriverAgent:注意这里需要番羽墙 第一步:修改WebDriverAgentLib的设置
上面是修改General,下面是修改Build Setting。修改下WebDriverAgent的BundleID,随便加点后缀,只要不跟其他人的重名就好
第二步:修改WebDerverAgentRunner的设置,保持跟上面的一样
②通过上面的①就可以获得免费版的个人证书,不过好像只有6天的使用期限。 ③在手机上设置授权签名,打开“设置”--“通用”--“设备管理”--选择你的开发者应用账号--点击信任你的开发者账号。 ③运行Test,看一下是否成功。如果成功的话,会看到手机上自动安装好了的那个WebDriverAgent应用,会自己启动之后,马上又返回到桌面。 ④此时console控制台面可以看到设备的IP,然后复制这个IP组成一个新的URL,
http://localhost:8100/status
粘贴到浏览器中打开,如果可以看到一系列JSON数据输出,说明成功了。http://localhost:8100/status
的json数据端口转发
- 有些国产的iPhone机器通过手机的IP和端口还不能访问,此时需要将手机的端口转发到Mac上。
- 在终端命令行中输入
brew install imobiledevice #安装端口转发工具 iproxy 8100 8100 #转发端口
-
显示connecting后,说明端口已经转发,成功后返回上一节的最后一步刷新浏览器。
- PS:使用
iproxy --help
可以查到更具体的用法。 - PPS:inspector的地址是
http://localhost:8100/inspector
, 用来查看UI的图层,方便写测试脚本。
Step3:下载脚本并运行开挂的程序
- 在Mac终端里新建一个文件夹放置代码,随便放哪里都行,打开终端,输入:
mkdir wechat_game #新建文件夹 cd wechat_game #进入文件夹 git clone https://github.com/wangshub/wechat_jump_game.git #下载代码 cd wechat_jump_game #进入程序根目录
- 安装WDA python客户端,可以上官网下载安装,但推荐使用pip安装
pip install --pre facebook-wda #安装WDA python客户端
- 安装跳一跳外挂脚本需要的一些依赖
pip install -r requirements.txt #安装依赖,这个txt文件在程序根目录下 #如果这一步发现一直报错说pip没有升级到*的话 #在Mac下试试python3 -m pip install --upgrade pip
- 查看程序文件,可以发现,config下有一个默认的json配置文件,里面是程序运行时,与手机截图像素相关的一些全局参数,这个脚本作者很贴心的把所有适配的手机像素的配置参数都配好了,我们只需要找到我们手机对应的json配置文件,复制到config文件夹下的并且命名为config.json文件就可以了。
cp config/iPhone/6_config.json config.json
打开微信跳一跳的小程序,点击“开始游戏”,到等待跳跃的界面。
执行脚本文件
python3 wechat_jump_auto_iOS.py
-
然后就可以插着手收割高分了,炫耀一下。
下一次调试运行
以后每次需要运行的时候,只需要按顺序运行下列命令即可:
先打开Xcode运行Test:# 解锁keychain,以便可以正常的签名应用, PASSWORD="replace-with-your-password" security unlock-keychain -p $PASSWORD ~/Library/Keychains/login.keychain # 获取设备的UDID UDID=$(idevice_id -l | head -n1) # 运行测试 xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination "id=$UDID" test
然后再开一个终端,配置手机端口转发:
iproxy 8100 8100
最后再开一个终端到程序根目录下运行脚本即可:
python3 wechat_jump_auto_iOS.py