Macaca Macaca iOS 真机实战

ryan · March 23, 2017 · Last by xdf replied at March 21, 2018 · 5362 hits

Macaca iOS 真机实战

前言

目前在圈子里好像还没人介绍过 Macaca 在 iOS 真机上的测试过程,下面我主要介绍一下楼主是怎么猜坑的。真机与模拟器最大的区别在于要对 WebDriverAgent 和 测试 App 进行重签名。
如果你用的是测试 App 是直接从 Appstore 中下载的,那么可以不用对测试 App 重签名。

目的

实现 Macaca 项目,在 iOS 真机上执行用例。

准备工作

  • 安装 Macaca shell $ npm i macaca-cli macaca-ios -g
  • 请安装 Xcode8 或者更高版本
  • 需要安装 usbmuxd 以便于通过 USB 通道测试 iOS 真机,不需要测试真机则不用安装 shell $ brew install usbmuxd
  • 应用中如含有 WebView,请安装 ios-webkit-debug-proxy shell $ brew install ios-webkit-debug-proxy

Macaca 真机调用原理

Macaca通过调用 WebDriverAgent 实现在真机上安装测试app 并执行测试用例。

在执行测试用例时,Macaca 首先会在真机上安装 WebDriverAgent ,该App 原始地址 /usr/local/lib/node_modules/macaca-ios/node_modules/webdriveragent/WebDriverAgent/WebDriverAgent.xcodeproj

然后通过 WebDriverAgent 发送指令调用被测试 App。

WebDriverAgent 是什么

WebDriverAgent 在 iOS 端实现了一个 WebDriver server ,借助这个 server 我们可以远程控制 iOS 设备。你可以启动、杀死应用,点击、滚动视图,或者确定页面展示是否正确。

iOS真机调试步骤

工作环境: Mac OS

Xcode: >= 8.0

  1. 重签名 WebDriverAgent:

    双击 /usr/local/lib/node_modules/macaca-ios/node_modules/webdriveragent/WebDriverAgent/WebDriverAgent.xcodeproj

    在打开的 Xcode 中按照下图中的顺序进行设置

    如果上图中 步骤5 报错,则需要先按照 下图所示设置一个自定义的 Product Bundle Identifier

    注意:按照以上步骤操作完,则已经完成了对 WebDriverAgentLib 的重签名工作,接下来需要对 WebDriverAgentRunner 进行相同的重签名工作,步骤参考上两图:)

    完成以上设置后 接下来需要build一下:

    1. 步骤如下图所示

    1. 点击 上图中的 步骤4 后如果提示 Build Successed 那么恭喜你重签名成功了。
  2. 重签名 待测试的App

    步骤:参见 WebDriverAgent 的重签名过程

  3. 至此,你已经完成了一般的工作,亲 恭喜你:)

  4. 准备测试用例

test.js


'use strict';

require('should');
var xml2map = require('xml2map');
var platform = process.env.platform || 'iOS';//iOS Android
platform = platform.toLowerCase();
var pkg = require('../package');

var iOSOpts = {
deviceName: 'iPhone 6 Plus',
platformName: 'iOS',
autoAcceptAlerts: false,
udid: '8cdb7*********a61',
bundleId: 'com.ant.***',
app: 'apk/****.ipa'
};

const isIOS = platform === 'ios';
const infoBoardId = isIOS ? 'info' : 'com.github.android_app_bootstrap:id/info';
const wd = require('macaca-wd');
require('./wd-extend')(wd, isIOS);

describe('macaca mobile sample', function() {
this.timeout(5 * 60 * 1000);

const driver = wd.promiseChainRemote({
host: 'localhost',
port: 3456
});

driver.configureHttp({
timeout: 600 * 1000
});

before(function() {
return driver
.init(isIOS ? iOSOpts : androidOpts);
});

after(function() {
return driver
.sleep(1000)
.quit();
});

it('#1 should login success', function() {
return driver
.getWindowSize()
.then(size => {
console.log(`current window size ${JSON.stringify(size)}`);
})
.appLogin('中文+Test+12345678', '111111')
.sleep(1000);
});
});

以上代码中需要修改的内容为:

  • udid(你设备的udid,可在 iTunes 中查看)

  • bundleId(步骤2 中的 Product Bundle Identifier)

  • app(此处支持 .ipa 或者 你将 .app 打成压缩包也可以,如:test.app => test.zip)

注意:此处多说一点,udid是用来告诉 Macaca 要在哪儿个设备上执行测试代码;

bundleId 的作用是告诉 Macaca 哪儿个是要测试的 App;

app 的作用是在找不到 bundleId 指定的 App 的情况下,安装指定的 App,如果你的测试机上已经安装了测试 App,那么本参数可以不写;

启动测试用例:

macaca run -d test.js --verbose
共收到 15 条回复 时间 点赞

这图好像是我画的。。

https://testerhome.com/topics/5804
就,觉得很尴尬不知道为什么......

恒温 回复

别好像,抄袭直接关闭了吧

mark 回复

不算抄袭。

https://testerhome.com/topics/5804 @adfghzhang 好尴尬。。

我也来 尴尬一下 “好尴尬啊” https://testerhome.com/topics/6507 😆 😁

6Floor has been deleted
ryan #7 · March 23, 2017 作者

只是把我的真实体验过程 写出来而已

ryan 关闭了讨论 23 Mar 16:54
ryan 重新开启了讨论 23 Mar 16:54
ryan 关闭了讨论 23 Mar 17:04
ryan 重新开启了讨论 23 Mar 17:06

楼主没事的,鼓励分享。 @worry127722

ryan #13 · March 23, 2017 作者
恒温 回复

吓死宝宝了

ryan 回复

没事没事,我就是尴尬一下,不用管我,对不起对不起🙏

@worry127722 提示这个错误 Error: Cannot find module './wd-extend' 是什么原因?

测试用例是需要自己写的吗,不是随机事件?

为什么使用WebDriverAgent的时候,从Appstore直接下载的App不需要进行重签名呢?

重签名需要开发者账号吗?以前没有搞过ios,不懂,求告知~

写的不错,细节交代的很详细

Macaca Ios 真机调试文档 https://testerhome.com/topics/12428

需要 Sign In 后方可回复, 如果你还没有账号请点击这里 Sign Up