投稿

Macaca-Java版入门指南

AITest · · 阅读 2963

本帖已被设为精华帖！,

以下内容转载自我的云栖社区：https://yq.aliyun.com/users/1035573748035711

导语

接触Macaca已经有一段时间，从开始的对于UI自动化的调研开始，将Macaca与Appium,Robotium等自动化方案进行了多方对比，最终Macaca脱颖而出成为团队的敲定方案，随后经历了Macaca从JS版本到Java版本的迭代，踩了很多坑，积累了很多经验教训，在这里总结沉淀一下，以方便后来人少走弯路，加快脚步。

一、认识Macaca

Macaca是一套基于WebDriver标准协议开发的开源自动化解决方案，旨在解决跨平台，跨终端的UI自动化测试的短板问题，减少繁杂、重复的人工工作，降低自动化测试的上手门坎。终端上，Macaca同时支持Native(iOS&&Android)、Hybrid、Mobile Web、以及PC端的自动化测试，用例编写上，Macaca采取CS架构，可以支持任意编程语言的封装，目前已支持Javascript、Java、Python三种语言，感兴趣的同学甚至可以自行封装支持任意自己习惯的语言。目前，Macaca在testerHome上的关注度以及活跃度都保持着强劲的势头，他不只提供了基础的用例编写功能，更提供了性能数据,包含电量、内存等指标的采集功能的附带模块，以及一套分布式持续集成系统供有需者选择，选择Macaca作为UI自动化的框架，将为大家提供很大的便利性。

二、配置Macaca开发环境

这部分主要针对Macaca1.0版本环境配置进行介绍，Macaca更新2.0后，环境配置上有些许改动，配置最新版Macaca环境，请略过本张姐，参考我的最新文章 从无到有搭建 Macaca 环境 (forMac)

三、编写Macaca-Java版测试用例

1.下载官方提供的Java版Demo用例

https://github.com/macaca-sample/sample-java
官方demo已更新，如下描述为针对早前版本的描述，仅供参考。

2.Demo用例分析：

通过Eclipse导入Maven工程，会发现工程结构相当简单，只有一个SampleTest.java类，之所以如此简洁，是因为Demo工程将Macaca的Java源码库以Maven源的形式配置到了pom.xml中：

<dependency>
        <groupId>macaca.webdriver.client</groupId>
        <artifactId>macacaclient</artifactId>
        <version>1.0.1</version>
</dependency>

如上图，可知道当Macaca有更新时，可以通过修改上图中的version版本号来实现库的更新。

对SampleTest.java源码的分析：

*setUp()方法主要用于配置被测应用的基础信息，包含平台版本，系统版本，安装包路径等，Demo实例中提供的为一个PC端的实例，当配置移动端应用测试时，相关参数稍有不同，后面会给出对应移动端的setUp()配置

@Before
public void setUp() throws Exception {
   // 在setUp()中配置被测应用的基础信息，如平台版本，安装包地址等
    Logger logger = Logger.getLogger(getClass());
    JSONObject porps = new JSONObject();
    porps.put("autoAcceptAlerts", true);
    porps.put("browserName", "electron");
    porps.put("platformName", "desktop");
    porps.put("version", "");
    porps.put("javascriptEnabled", true);
    porps.put("platform", "ANY");
    JSONObject desiredCapabilities = new JSONObject();
    desiredCapabilities.put("desiredCapabilities", porps);
    driver.initDriver(desiredCapabilities).setWindowSize(1280, 800).get("https://www.baidu.com");
}

*移动端的setUp()配置信息实例

       @Before
   public void setUp() throws Exception {

       JSONObject porps = new JSONObject();
       porps.put("autoAcceptAlerts", true);
       porps.put("platformVersion", "9.3");
       porps.put("deviceName", "iPhone 5s");
       porps.put("platformName", "iOS");
       // 指定待测应用的安装包
       porps.put("app", "**/**/targetApp.zip"); 
      // 指定app复用类型，比如需要每次用例启动重装app,可以设置为1，不重装，可以设为3
porps.put("reuse",1);
       JSONObject desiredCapabilities = new JSONObject();
       desiredCapabilities.put("desiredCapabilities", porps);
       driver.initDriver(desiredCapabilities);
       driver.platform = "ios";


   }

针对如上代码，需要注意的是，对于iOS平台，在模拟器上跑用例时 app的安装包需要基于.app包压缩后的zip包(这个.app包可以找对应的iOS开发同学提供，在XCode工程目录下Products目录下)，而不能用.ipa包进行压缩，对于真机，可以直接使用.ipa文件，不过需要涉及证书签名等问题，关于这个，可参考https://testerhome.com/topics/6503。
另外，对于配置参数，iOS与安卓有各自特有的参数，具体配置信息可参考：
https://macacajs.com/helpful-settings
滑动到此页面底部可看到 Desired Capabilities

*测试用例编写


@Test
public void test_case_1() throws Exception {
    driver
        .elementById("kw")
        .sendKeys("macaca")
        .sleep(1000)
        .elementById("su")
        .click()
        .sleep(3000);

    String html = driver.source();

    Assert.assertThat(html, containsString("<html>"));

    driver
        .elementByCss("#head > div.head_wrapper")
        .elementByXPath("//*[@id=\"kw\"]")
        .sendKeys(" elementByXPath")
        .elementById("su")
        .click()
        .takeScreenshot();
}

可能习惯Java的同学对于测试用例的这种链式写法有些不习惯，个人认为这样写与Javascript版本的迁移有所关联，优势在于可以便利的实现连续的UI操作，而不用一行行写重复样式的调用，而实现这种语法的关键在于源码中每一个接口，比如elementById(),sendKeys()都返回了driver本身，如下：

    #MacacaClient.java
    /**
 * Search for an element on the page, starting from the document root.
 * @param elementId The ID attribute of element
 * @return The currently instance of MacacaClient
 * @throws Exception
 */
public MacacaClient elementById(String elementId) throws Exception {
    JSONObject jsonObject = new JSONObject();
    jsonObject.put("value", elementId);
    jsonObject.put("using", "id");
    element.findElement(jsonObject);
    return this;
}

以上源码来自于Java版Source Code：https://github.com/macacajs/wd.java

3.Demo用例运行

同Javascript版用例不同的一点是，Javascript版本的用例可以直接通过一条命令启动macaca server并运行case,而Java版的用例则需要单独启动Macaca server，然后执行测试用例，具体操作如下：

1）进入工程目录
$cd path/to/macaca-test-sample-java
2）启动Macaca server
$macaca server --verbose

如果想查看启动中的详细信息 可以追加–verbose参数 $macaca server –verbose

3)新建cmd窗口，进入当前工程目录下：
$mvn -s settings.xml clean install -Dmaven.test.skip=true

注：mvn -s的作用在于使maven以工程目录下的settings.xml文件为依据下载依赖，但是实践中发现部分同学会出现mvn -s无法生效的作用，这样会导致依赖下载失败，这种情况下，需要大家将工程目录下的settings.xml中的配置相应的添加到本地settings中。

$mvn test

或者可以直接进入到IDE中运行test用例

这样就可以看到自动执行的测试效果了

四、UI控件查找工具-Inspector

实际应用中自动化用例的编写很多情况下都是查找控件并操作，于是如何快速高效的查找控件成为了一件关乎效率的大问题，最早的时候对于安卓，查找控件依赖于Android自带的UIAutomator viewer工具，iOS则依赖于XCode中的Accessibility Inspector工具，但是这两种工具查找起来相对麻烦，效率相对低下，针对这个问题，Macaca团队提供了统一的Inspector工具，可以以Web的方式方便的查看不论是安卓还是iOS的控件。

具体使用链接如下：https://macacajs.com/inspector

关于控件的查找另外补充一点，目前Java版提供通过id,css,name,xpath等方式获取控件，但xpath的方式扩展性太弱，不到万不得已不推荐使用，最好的方式是希望对每个控件能有一个唯一性的id标示获取，但这需要开发同学的配合，对于安卓，有一些控件是有id的，因为开发同学自身也需要定位这个控件，但对于iOS,有很多控件是不存在id的，但是如果有一种底层的方案，按照一定的规则给控件自动增加id属性，则只需要在底层做一定适配而不需要开发同学额外给每个控件增加id属性，这对于提高自动化的效率大有裨益，在网上找到了一篇类似思想的文章，仅供参考：为UIAutomation 添加自动化测试标签的探索

常用命令集锦

  1. 启动server : 

    //--verbose为可选参数，用于查看详细日志，可不加
    $macaca server --verbose

  2. 查看当前设备ID:

    Android: 

    $adb devices

    iOS: 

    $xcrun simctl list

  3. 查看视图Dom树

    //***部分为要监控的设备id
    $ app-inspector -u ***

    前提是要安装了app-inspector ,安装命令：

    cnpm i app-inspector -g

    参考资料

1.macaca官方教程

官方教程包含环境搭建/API参考（Js、Java、Python）/CI集成等最权威的指南，参考首选。

2.TesterHome上的Macaca社区

testerHome上包含很多实际应用的帖子，很多步骤介绍的比较详细并配有截图，以及暴露了很多开发者使用过程中的坑，对于扫盲非常有帮助

3.Macaca源码

想深入了解Macaca原理的同学可以研究Macaca的源码，Macaca团队将每个模块单独建立了代码库，看起来清楚明了。如果在开发中遇到了框架层面的问题，也可以在对应的github上提issue，甚至可以提交PR参与到Macaca的共建中，作为开源框架，Macaca需要大家共同努力发扬光大。

附录

“Macaca开源社区”群的钉钉群号： 11775486(欢迎入群讨论，钉钉顶部搜索框搜索群号加入即可)

更多相关文章

UI 自动化框架调研总结
从无到有搭建 Macaca 环境 (forMac)
Macaca-Java 版入门指南
UI 自动化 Macaca-Java 版实践心得
UI 自动化利器-为你的应用自动添加控件 ID 探索
Macaca 基础原理浅析

* 注：本文来自网络投稿，不代表本站立场，如若侵犯版权，请及时知会删除

赞 (0)
标签:
0

相关推荐