alibaba/macaca

Name: macaca

Owner: Alibaba

Description: Automation test solution for native, hybrid, mobile web and web application on mobile and desktop platforms.???????????

Created: 2016-03-16 02:52:39.0

Updated: 2018-05-23 17:25:27.0

Pushed: 2018-05-13 13:10:19.0

Homepage: https://macacajs.com

Size: 16

Language: null

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Macaca

Macaca

???

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.

Features
  1. Macaca has a MIT license.
  2. Macaca's Inspector(//macacajs.com/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
Server

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.

Session

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.

Client

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
License

The MIT License (MIT)

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.