微信跳一跳开外挂 | Mac+IOS+python

之前整理了Windows环境下对安卓系统的手机进行测试的开外挂安装步骤，鉴于我也同时拥有Mac和iPhone，干脆就把iPhone版本的开外挂步骤一起整理了吧。

• 外挂代码地址https://github.com/wangshub/wechat_jump_game。
• 搭建环境
  • PC端：MacOS 10.13.2 + Xcode 9.2 + Python + WebDriverAgent (必须在OS10.12以及以上，并且Xcode9.2以及以上才能顺利安装)
  • 手机端：iPhone 8 + IOS 11.2.1

参考教程

主要参考教程：https://www.jianshu.com/p/ff973a5910ae

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打开。
  

  

  image.png

• 使用模拟机测试一下WDA运行情况【此步骤可跳过】
  可以参考这篇自动化测试网易云音乐的步骤，里面有动图更形象一些。

①设置为Runner：Xcode--Product--Scheme--WebDriverAgentRunner

image.png

②进入Test：Xcode--Product--Test，结束后就会出来一个Simulator，而且手机上也安装好软件了。

image.png

③随后打开127.0.0.1:8100/inspector 这个地址，稍等一会儿，就可以看到一个酷炫的界面。

image.png

左边屏幕图像，右边具体的元素信息，所有这些东西都是我们写脚本的时候需要用到的。
④之后就可以做模拟机的一些脚本测试操作了，但是本教程是为了要在真机上玩跳一跳外挂，所以模拟机这个步骤可以跳过不做。只是为了好玩放上来的，也顺便测试一下WDA是否可以正常工作。

Step2：WDA 连接iphone真机

• 和模拟器是一样的，需要先选Runner：

• 但是选择真机后，运行Test：

  
  
  

  error
  
  

  发现了上述错误，看错误提示安装到真机的话需要签名，意味着需要选择开发者团队证书。

设置证书

• 这里参考了博客：iOS 真机如何安装 WebDriverAgent
• 真机与模拟器最大的区别在于要对 WebDriverAgent 和 测试 App 进行重签名。如果你用的是测试 App 是直接从 Appstore 中下载的，那么可以不用对测试 App 重签名。
• 所以WDA运行模拟机不需要设置证书，但是WDA实装到真机中的话，需要具备【开发者证书】

• 步骤：
  ①重签名 WebDriverAgent：注意这里需要番羽墙
  第一步：修改WebDriverAgentLib的设置

  
  
  

  image.png
  
  

  上面是修改General，下面是修改Build Setting。修改下WebDriverAgent的BundleID，随便加点后缀，只要不跟其他人的重名就好

  
  
  

  image.png

第二步：修改WebDerverAgentRunner的设置，保持跟上面的一样

image.png

②通过上面的①就可以获得免费版的个人证书，不过好像只有6天的使用期限。
③在手机上设置授权签名，打开“设置”--“通用”--“设备管理”--选择你的开发者应用账号--点击信任你的开发者账号。
③运行Test，看一下是否成功。如果成功的话，会看到手机上自动安装好了的那个WebDriverAgent应用，会自己启动之后，马上又返回到桌面。
④此时console控制台面可以看到设备的IP，然后复制这个IP组成一个新的URL，http://localhost:8100/status
粘贴到浏览器中打开，如果可以看到一系列JSON数据输出，说明成功了。

image.png

⑤如果浏览器无响应的话，请看下一节，实现端口转发之后再回来尝试刷新浏览器。就可以看到 http://localhost:8100/status的json数据

端口转发

• 有些国产的iPhone机器通过手机的IP和端口还不能访问，此时需要将手机的端口转发到Mac上。
• 在终端命令行中输入

brew install libimobiledevice #安装端口转发工具
iproxy 8100 8100 #转发端口

• 显示connecting后，说明端口已经转发，成功后返回上一节的最后一步刷新浏览器。

  
  
  

  image.png

• 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

image.png

• 查看程序文件，可以发现，config下有一个默认的json配置文件，里面是程序运行时，与手机截图像素相关的一些全局参数，这个脚本作者很贴心的把所有适配的手机像素的配置参数都配好了，我们只需要找到我们手机对应的json配置文件，复制到config文件夹下的并且命名为config.json文件就可以了。

cp config/iPhone/6_config.json config.json

image.png

• 打开微信跳一跳的小程序，点击“开始游戏”，到等待跳跃的界面。

• 执行脚本文件

python3 wechat_jump_auto_iOS.py

• 然后就可以插着手收割高分了，炫耀一下。

  
  
  wechat.gif

下一次调试运行

以后每次需要运行的时候，只需要按顺序运行下列命令即可：
先打开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

image.png

image.png