Macaca is an open-source automation test solution for native, hybrid, mobile web and web application on mobile and desktop platforms.
- Native means apps written with iOS or android SDKs.
- Hybrid is apps created by webview in native app.
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.
- Macaca has a MIT license.
- Macaca’s Inspector is web based.
- Macaca’s iOS WebDriver is written by Swift and in-house built.
- Macaca’s Android WebDrive is in-house built, and supports Android UIAutomator 2.0.
- Macaca has built-in UI recorder functionality.
- Macaca has built-in support for using computer vision to verify UI elements
- Macaca supports major browsers such as Chrome, Firefox, Safari.
- Macaca follows W3C WebDriver Wire Protocol.It means Macaca has much better chances to be compatible with current and future web standard.
To run Macaca, you need to have node.js and npm installed.
To run your test against a particular platform (iOS, android or web browsers), you need to set up for this platform. Don’t worry, we do have
macaca doctor help you inspect whether your environment is ready.
To quickly get to where you want to know, jump right in our Quick Start.
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.
Once you have node.js and npm installed, run our
sample test project to see Macaca in action
$ git clone https://github.com/macaca-sample/sample-nodejs.git --depth=1 $ cd sample-nodejs $ npm i $ make