Macaca自动化测试Android和IOS应用

1.Macaca简介

Macaca是阿里巴巴集团开发的一套完整的自动化测试解决方案。

2.Macaca特性：

支持移动端和PC端
支持Native, Hybrid, H5 等多种应用类型
提供客户端工具和持续集成服务

3.macaca-cli客户端的安装：

3.1安装 Node.js

请安装 Node.js v4.0 或者更高版本，装好 Node.js 后命令行里就已经集成了 npm 工具，为了提高安装模块的速度，请使用国内的 cnpm。

3.2 iOS 环境安装

请安装 Xcode8 或者更高版本
需要安装 usbmuxd 以便于通过 USB 通道测试 iOS 真机，不需要测试真机则不用安装

$ brew install usbmuxd

应用中如含有 WebView，请安装 ios-webkit-debug-proxy

$ brew install ios-webkit-debug-proxy

备注：使用brew命令需要安装Homebrew（一款常用的 MacOS 的包管理器），请按照官网提示安装。
准备 App 包：如需要测试 iOS 应用，请使用 Scheme 设置为 debug 的 .app 包。

3.3 Android环境安装

3.3.1 安装 JDK

配置 JAVA_HOME，根据你所使用的 shell 工具修改不同的文件，比如 ~/.bashrc, ~/.bash_profile, ~/.zshrc

shell export JAVA_HOME=path/to/your/Java/Home

3.3.2安装安卓 SDK

运行 brew install android-sdk，然后安装18-24版本中的任一 SDK
shell 环境设置 ANDROID_HOME 根据你所使用的Terminal修改不同的

文件，比如~/.bashrc, ~/.bash_profile, ~/.zshrc
# 如果是通过homebrew安装的android-sdk，则路径如下export ANDROID_HOME = /usr/local/opt/android-sdk# 如果通过其他方式安装的sdk，路径设置为对应的android sdk的路径export ANDROID_HOME = path/to/your/Android/sdk

注意：准备 App 包：如需要测试 Android 应用，请使用 .apk 格式的包。

3.4 全局安装macaca

$ npm i -g macaca-cli

如果看到如下可爱的小猴子，那恭喜你安装成功啦！重新安装则会覆盖更新。

3.5安装驱动

3.6 环境检查

通过 macaca doctor 可以检查环境是否配置成功

$ macaca doctor

如上图所示则表示环境均配置正常，如果有错误，会出现红色的提示。

4 运行官方示例

将官方示例(mobile-app-sample-nodejs)克隆到本地，更多的示例请访问macaca-sample。

$ git clone https://github.com/macaca-sample/mobile-app-sample-nodejs.git --depth=1
$ cd mobile-app-sample-nodejs
$ npm i
# 更多运行方式见Makefile
$ macaca run --verbose

4.1 Android 的自动化测试

先在mobile-app-sample-nodejs/macaca-test/mobile-app-sample.test.js脚本文件中如果是ios该为Android。

var platform = process.env.platform || 'Android';
platform = platform.toLowerCase();

在mobile-app-sample-nodejs目录下执行

macaca run

测试的过程

lidongdeMacBook-Pro:mobile-app-sample-nodejs lidong$ macaca run ./macaca-test/macaca-mobile-sample.test.js
>> webdriver sdk launched
>> >> >>   macaca mobile sample>> get /Users/lidong/.macaca-temp/android_app_bootstrap-debug.apk from cache
>> sha:e2ca601f9ee1ec101326d12377a2e8d4
INSTRUMENTATION_STATUS: numtests=1
INSTRUMENTATION_STATUS: stream=
com.android.uiautomator.client.Initialize:
INSTRUMENTATION_STATUS: id=UiAutomatorTestRunner
INSTRUMENTATION_STATUS: test=testStartServer
INSTRUMENTATION_STATUS: class=com.android.uiautomator.client.Initialize
INSTRUMENTATION_STATUS: current=1
INSTRUMENTATION_STATUS_CODE: 1uiautomator start socket server.>> socket server ready
>> socket client ready
recive: {"cmd":"wake","args":{}}return: {"success":true,"data":{"status":0,"value":true}}recive: {"cmd":"getWindowSize","args":{}}return: {"success":true,"data":{"status":0,"value":"{\"width\":1080,\"height\":1794}"}}>> current window size {"width":1080,"height":1794}recive: {"cmd":"find","args":{"strategy":"class name","selector":"android.widget.EditText","multiple":true}}return: {"success":true,"data":{"status":0,"value":[{"ELEMENT":"1"},{"ELEMENT":"2"}]}}recive: {"cmd":"clearText","args":{"elementId":"1"}}return: {"success":true,"data":{"status":0,"value":true}}recive: {"cmd":"setText","args":{"elementId":"1","text":"中文+Test+12345678"}}return: {"success":true,"data":{"status":0,"value":true}}recive: {"cmd":"find","args":{"strategy":"class name","selector":"android.widget.EditText","multiple":true}}return: {"success":true,"data":{"status":0,"value":[{"ELEMENT":"3"},{"ELEMENT":"4"}]}}recive: {"cmd":"clearText","args":{"elementId":"4"}}return: {"success":true,"data":{"status":0,"value":true}}recive: {"cmd":"setText","args":{"elementId":"4","text":"111111"}}return: {"success":true,"data":{"status":0,"value":true}}recive: {"cmd":"find","args":{"strategy":"name","selector":"Login","multiple":true}}return: {"success":true,"data":{"status":0,"value":[{"ELEMENT":"5"}]}}recive: {"cmd":"click","args":{"elementId":"5"}}return: {"success":true,"data":{"status":0,"value":true}}>>
>>      #1 should login success (19613ms)recive: {"cmd":"getSource","args":{}}return: {"success":true,"data":{"status":0,"value":true}}>> { hierarchy: { rotation: '0',node: { index: '0',class: 'android.widget.FrameLayout',package: 'com.github.android_app_bootstrap',checkable: 'false',checked: 'false',clickable: 'false',enabled: 'true',focusable: 'false',focused: 'false',scrollable: 'false','long-clickable': 'false',password: 'false',selected: 'false',bounds: '[0,0][1080,1794]',node: [Object] } } }>>
>>      #2 should display home (911ms)recive: {"cmd":"find","args":{"strategy":"name","selector":"list","multiple":false}}
等等

4.2 IOS 的自动化测试

先在mobile-app-sample-nodejs/macaca-test/mobile-app-sample.test.js脚本文件中如果是Android改为ios。

var platform = process.env.platform || 'ios';
platform = platform.toLowerCase();

在mobile-app-sample-nodejs目录下执行

macaca run

测试过程

lidongdeMacBook-Pro:mobile-app-sample-nodejs lidong$ macaca run ./macaca-test/macaca-mobile-sample.test.js
>> webdriver sdk launched
>> >> >>   macaca mobile sample>> get /Users/lidong/.macaca-temp/android_app_bootstrap-debug.apk from cache
>> sha:e2ca601f9ee1ec101326d12377a2e8d4
INSTRUMENTATION_STATUS: numtests=1
INSTRUMENTATION_STATUS: stream=
com.android.uiautomator.client.Initialize:
INSTRUMENTATION_STATUS: id=UiAutomatorTestRunner
INSTRUMENTATION_STATUS: test=testStartServer
INSTRUMENTATION_STATUS: class=com.android.uiautomator.client.Initialize
INSTRUMENTATION_STATUS: current=1
INSTRUMENTATION_STATUS_CODE: 1uiautomator start socket server.>> socket server ready
>> socket client ready
recive: {"cmd":"wake","args":{}}return: {"success":true,"data":{"status":0,"value":true}}recive: {"cmd":"getWindowSize","args":{}}return: {"success":true,"data":{"status":0,"value":"{\"width\":1080,\"height\":1794}"}}>> current window size {"width":1080,"height":1794}recive: {"cmd":"find","args":{"strategy":"class name","selector":"android.widget.EditText","multiple":true}}return: {"success":true,"data":{"status":0,"value":[{"ELEMENT":"1"},{"ELEMENT":"2"}]}}recive: {"cmd":"clearText","args":{"elementId":"1"}}return: {"success":true,"data":{"status":0,"value":true}}

5.脚本初始化参数

5.1 常见的参数

platformName String 当前用例运行的平台 { iOS / Android / Desktop }
browserName String 当前测试的浏览器名称 { iOS: Safari } { Android: Chrome } { Desktop: Chrome / Electron }

5.2 App 相关参数

deviceName String 模拟器的名称，例如 ‘iPhone 6’ 或者 ‘Nexus 5x’。
app Stirng .ipa，.app 或者 .apk 文件的绝对地址或者远程地址，或者是包含上述文件格式的 Zip 文件。
udid String 测试设备的唯一设备 ID。

5.3 Android 的参数介绍

reuse Number 0: 启动并安装 app。{1 (默认): 卸载并重装 app。 2: 仅重装 app。3: 在测试结束后保持 app 状态。}
package String Android app 的 package name。
activity String 启动时的 Activity name。

5.4 iOS 的参数介绍

reuse Number 0: 清楚数据并重装 app。 1: (默认) 卸载并重装 app。 2: 仅重装 app。 3: 在测试结束后保持 app 状态。
bundleId String 应用的 Bundle ID，例如 com.apple.Maps。
autoAcceptAlerts Boolean 自动接受所有的系统弹窗信息。默认是 false。
autoDismissAlerts Boolean 自动拒绝所有的系统弹窗信息。默认是 false。

5.5 基本用法

'use strict';require('should');
var xml2map = require('xml2map');var platform = process.env.platform || 'ios';
platform = platform.toLowerCase();var pkg = require('../package');/*** download app form npm** or use online resource: https://npmcdn.com/ios-app-bootstrap@latest/build/ios-app-bootstrap.zip** npm i ios-app-bootstrap --save-dev** var opts = {*   app: path.join(__dirname, '..', 'node_modules', 'ios-app-bootstrap', 'build', 'ios-app-bootstrap.zip');* };*/// see: https://macacajs.github.io/desired-capsvar iOSOpts = {deviceName: 'iPhone 5s',platformName: 'iOS',autoAcceptAlerts: false,//reuse: 3,//udid: '',//bundleId: 'xudafeng.ios-app-bootstrap',app: 'http://localhost:8087/ios-app-bootstrap.zip'
};var androidOpts = {platformName: 'Android',autoAcceptAlerts: false,// reuse: 3,// udid: '',// package: 'com.github.android_app_bootstrap',// activity: 'com.github.android_app_bootstrap.activity.WelcomeActivity',app: 'http://localhost:8087/android_app_bootstrap-debug.apk'
};const isIOS = platform === 'ios';
const infoBoardId = isIOS ? 'info' : 'com.github.android_app_bootstrap:id/info';const wd = require('macaca-wd');// override custom 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);});

Macaca自动化测试Android和IOS应用,基本上说到这里就要结束。后面我们还是学习如何自己写测试脚本。