Macaca简单入门

一纸荒年

执行Macaca自动化脚本时，首先需要启动一个Macaca服务器：

$ macaca server --verbose
1
参数设置

启动Macaca服务器时如果没有指定端口号，服务器URL的配置参数如下：

1. server_url = {
   
2.     'hostname': 'localhost',
   
3.     'port': 3456
   
4. }

复制代码

Android设置

变量desired_caps是用来在启动时配置服务器的参数，使用模拟器，并安装、启动App时，常用的配置参数如下：

1. 
   
2. apps_path = '/Users/xxx/test-macaca/apps/'
   
3. 
   
4. desired_caps = {
   
5.     'platformName': 'android',
   
6.     'deviceName': 'Nexus4',
   
7.     'app': apps_path + 'app-debug.apk',
   
8. }
   
9. 
   

复制代码

参数        类型        描述
platformName        String        当前用例运行的平台
deviceName        String        模拟器的名称
app        String        .apk文件的绝对地址或者远程地址
使用真机测试，并直接启动App测试时，常用的配置参数如下：

1. 
   
2. desired_caps = {
   
3.     'platformName': 'android',
   
4.     'package': 'com.xxxx.Maps',
   
5. }
   

复制代码

参数        类型        描述
platformName        String        当前用例运行的平台
package        String        Android app的package name
iOS设置

使用模拟器，并安装、启动App时，常用的配置参数如下：

1. apps_path = '/Users/xxx/test-macaca/apps/'
   
2. 
   
3. desired_caps = {
   
4.     'platformName': 'iOS',
   
5.     'deviceName': 'iPhone 6s',
   
6.     'app': apps_path + 'app-debug.app',
   
7. }
   

复制代码

参数        类型        描述
platformName        String        当前用例运行的平台
deviceName        String        模拟器的名称
app        String        .ipa、.app文件的绝对地址或者远程地址
需要注意一下，在真机下可能无法安装App，最好提前将测试App安装到真机，并直接启动App测试，常用的
配置参数如下：

1. 
   
2. desired_caps = {
   
3.     'platformName': 'iOS',
   
4.     'udid': '4502df9f327096e14502df9f327096e1',
   
5.     'bundleId': 'com.apple.Maps',
   
6. }

复制代码

参数        类型        描述
platformName        String        当前用例运行的平台
udid        String        测试设备的唯一设备ID
bundleId        String        应用的Bundle ID
Web设置

直接启动桌面浏览器，并打开Web网页测试时，常用的配置参数如下：

1. desired_caps = {
   
2.     'platformName': 'desktop',
   
3.     'browserName': 'electron',
   
4. }
   

复制代码

参数        类型        描述
platformName        String        当前用例运行的平台
browserName        String        当前测试的浏览器名称
编写用例

启动Macaca测试用例需要导入WebDriver，它是一个为Macaca而设计的Python WebDriver客户端。还需要导
入unittest这个单元测试框架，它能组织执行测试用例。最好再导入retry，正如它的名字，它可以用来实现重
试功能，比如出现网络问题导致失败，这时就需要重试了：

1. import unittest
   
2. from macaca import WebDriver
   
3. from retrying import retry
   

复制代码

使用unittest来组织执行测试用例，同时使用了它的几个特殊方法：

setUpClass()在所有test运行前运行一次（必须使用@classmethod装饰器）
tearDownClass()在所有test运行完后运行一次（必须使用@classmethod装饰器）
initDriver()在运行测试用例前初始化（必须使用@classmethod装饰器）
首先在setUpClass()中，配置所需的功能和服务器URL的WebDriver，并初始化WebDriver服务器。然后在tea
rDownClass()中，删除当前WebDriver服务器会话。最后在initDriver()中，创建一个新的WebDriver服务器会话：

1. 
   
2. class MacacaTest(unittest.TestCase):
   
3.     @classmethod
   
4.     def setUpClass(cls):
   
5.         cls.driver = WebDriver(desired_caps, server_url)
   
6.         cls.initDriver()
   
7. 
   
8.     @classmethod
   
9.     def tearDownClass(cls):
   
10.         cls.driver.quit()
    
11. 
    
12.     @classmethod
    
13.     @retry
    
14.     def initDriver(cls):
    
15.         print('尝试连接服务器...')
    
16.         cls.driver.init()
    
17. 
    
18.     def test_01(self):
    
19.         self......
    
20. 
    
21.     def test_02(self):
    
22.         self......
    
23. 
    
24. if __name__ == '__main__':
    
25.     unittest.main()
    

复制代码

元素查看器

app-inspecto是浏览器中的移动UI查看器，可以对当前界面进行抓取、分解界面可操作的基本元素，使用npm安
装app-inspecto：

$ npm i app-inspector -g
1
直接-u加设备的udid即可启动元素查看器：

$ app-inspector -u xxxxxxxx-xxxx-xxxx
1


Android

在真机调试下，因为app-inspector和macaca-android是两个文件夹下的，安装的apk是不一样的，可能会有问
题，最好把这com.maraca.android.testing.test、UiAutomator sample、android-unlock这三个apk从手机里删除
下。打开Android模拟器或连接真机：

$ emulator -avd Nexus4
1
使用adb命令查看设备的UDID：

$ adb devices
1
启动元素查看器：

$ app-inspector -u emulator-5554
1
iOS

在app-inspector安装过程中可以将TEAM_ID通过环境变量传入即可支持真机，同时，还需要重签名app-inspec
to模块下的XCTestWD.xcodeproj，Xcode项目所在路径：“xxx/node_modules/app-inspector/node_modules/
xctestwd/XCTestWD/XCTestWD.xcodeproj”，双击打开Xcode项目，重签名XCTestWD和XCTestWDUITests，
并能正常执行即可。如果是个人开发者，iOS上要在“设置>通用>设备管理”中信任开发者。

DEVELOPMENT_TEAM_ID=TEAM_ID npm i app-inspector -g
1
打开iOS模拟器或连接真机：

$ open -a Simulator
1
从菜单中打开“Hardware>devices>manage devices”，然后会看到模拟器信息界面，里面有个identifier，就是U
DID，再启动元素查看器：

$ app-inspector -u B5393605-DCAF-4EA8-9B2C-4058449FA527