Automation test solution for native, hybrid, mobile web and web application on mobile and desktop platforms.多端自动化测试解决方案
Switch branches/tags
Nothing to show
Clone or download
Latest commit 881cd0c Apr 24, 2018
Failed to load latest commit information.
.github update Dec 7, 2016
.gitignore tweak ignore Aug 24, 2016
LICENSE update lisense May 20, 2017 feat: update readme May 13, 2018 feat: update readme May 13, 2018




Macaca is an open-source automation test solution for native, hybrid, mobile web and web application on mobile and desktop platforms.

  1. Native means apps written with iOS or android SDKs.
  2. Mobile web means apps written in HTML, CSS and Javascript and displayed via a mobile device browser such as Safari, Chrome or Webview in iOS and android.
  3. Hybrid is apps created by webview in native app.
  4. Web means apps written in HTML, CSS and Javascript.

Macaca is "cross-platform". It means you can use the same API to write test scripts, and same test scripts to test your apps running on devices such as iOS, Android or desktops.

Macaca doesn't limit what languages you will use to write your tests.


  1. Macaca has a MIT license.
  2. Macaca's Inspector(// is web based.
  3. Macaca's iOS WebDriver is written by Swift and in-house built.
  4. Macaca's Android WebDrive is in-house built, and supports Android UIAutomator 2.0.
  5. Macaca has built-in UI recorder functionality.
  6. Macaca has built-in support for using computer vision to verify UI elements
  7. Macaca supports major browsers such as Chrome, Firefox, Safari.
  8. Macaca follows W3C WebDriver Wire Protocol.It means Macaca has much better chances to be compatible with current and future web standard.

Macaca Concepts


Macaca's core is a REST API web server. It connects with clients, listens for requesting, and executes request commands on a mobile device, and a desktop browser, responses with results conforming HTTP response protocol.

The beauty of a client/server architecure, REST API and W3C WebDriver Wire Protocol opens the opportunities that test codes can be written any common languages, as long as it has a http client API. On the other hand, the server can be on a different machine, or in cloud.

Besides this Macaca's core, we call it macaca server, Macaca's extra utility tool is also server/client centric, such as UI Inspector, computer vision tool.


Macaca uses session to accept and respond requests. A client initiates a session with Macaca server by sending POST /session request. Macaca server will response with this session with a sessionId. The further request needs to contain this sessionId to move forward.


Macaca doesn't limit what client you use. We provide Node.js, Java and Python API libraries to get you started quickly.

Help and Support


The MIT License (MIT)