Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alibaba/macaca

Automation solution for multi-platform. 多端自动化解决方案
https://github.com/alibaba/macaca

android automation hybrid-apps ios macaca testing uitest

Last synced: 25 days ago
JSON representation

Automation solution for multi-platform. 多端自动化解决方案

Host: GitHub
URL: https://github.com/alibaba/macaca
Owner: alibaba
License: mit
Created: 2016-03-16T02:52:39.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2022-09-18T13:23:18.000Z (about 2 years ago)
Last Synced: 2024-04-13T22:53:38.003Z (7 months ago)
Topics: android, automation, hybrid-apps, ios, macaca, testing, uitest
Homepage: https://macacajs.github.io
Size: 83 KB
Stars: 3,159
Watchers: 191
Forks: 418
Open Issues: 64
Metadata Files:
- Readme: README.en.md
- License: LICENSE

Awesome Lists containing this project

awesome-nodejs - macaca - Automation solution for multi-platform. *(You might like [awesome-macaca](https://github.com/macacajs/awesome-macaca))* ![](https://img.shields.io/github/stars/alibaba/macaca.svg?style=social&label=Star) (Repository / Testing)
awesome-notes - macaca `多端自动化测试解决方案`

README

        


  

    

  



---

# Macaca

[中文版](README.md)

Macaca is an open-source automation solution for multi-platform.

---

## Macaca Core

At its core, Macaca is an end-to-end test automation framework consisting of clients, servers and drivers.



  



### Client

Macaca doesn't limit what languages you will use to write your tests. You can choose to write your tests in Node.js, Java or Python, using respective clients:

* Node.js client - [macaca-wd](https://github.com/macacajs/macaca-wd)

* Java client - [wd.java](https://github.com/macacajs/wd.java)

* Python client - [wd.py](https://github.com/macacajs/wd.py)

### 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 architecture is that REST API and [W3C WebDriver Wire Protocol](https://www.w3.org/TR/webdriver/) 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.

### Driver

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. To achieve this, we have drivers for different platforms:

* Macaca's [iOS WebDriver](https://github.com/macacajs/XCTestWD) is written in Swift and built in-house.

* Macaca's [Android WebDriver](https://github.com/macacajs/UIAutomatorWD) is built in-house, and supports Android UIAutomator 2.0.

Macaca supports major browsers such as Chrome, Firefox, Safari. It also supports electron environment.

## Native, Mobile, Hybrid

0. Native means apps written with iOS or android SDKs.

0. 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.

0. Hybrid is apps created by webview in native app.

0. Web means apps written in HTML, CSS and JavaScript.

## Macaca Community Ecosystem



  



### Macaca DataHub



  

    

  



Macaca DataHub is a continuous data provider for development, testing, staging and production.

---



  



* [Website](https://macacajs.github.io/macaca-datahub/)

* [GitHub](https://github.com/macacajs/macaca-datahub)

### Reliable



  

    

  



Reliable is a testing management suite with continuous delivery support.

---



  



* [Website](https://macacajs.github.io/reliable/)

* [GitHub](https://github.com/macacajs/reliable)

### NoSmoke

NoSmoke is a cross platform UI crawler which generate and execute UI test cases.



  



* [Website](https://macacajs.github.io/NoSmoke/)

* [GitHub](https://github.com/macacajs/NoSmoke)

### App Inspector

App-inspector is a mobile UI viewer in browser. View the UI in a tree view, and generate XPath automatically.



  



* [Website](https://macacajs.github.io/app-inspector/)

* [GitHub](https://github.com/macacajs/app-inspector)

### Macaca UITest

Macaca UITest runs mocha in a browser environment.



  



* [Website](https://macacajs.github.io/uitest/)

* [GitHub](https://github.com/macacajs/uitest)

### Macaca Reporter

Macaca Reporter is a reporter used for mocha and other frameworks.



  



* [Website](https://macacajs.github.io/macaca-reporter/)

* [GitHub](https://github.com/macacajs/macaca-reporter)

### Torchjs

Torchjs is an excellent unit testing framework for browser environment.

[gif demo](https://macacajs.github.io/torchjs/assets/6d308bd9gy1fiw8er0a5eg20zc0k0he0.gif)

* [Website](https://macacajs.github.io/macaca-reporter/)

* [GitHub](https://github.com/macacajs/macaca-reporter)

### UI Recorder



  

    

  



UI Recorder is a zero cost UI test case recorder like Selenium IDE.

---



  



* [Website](https://uirecorder.com/)

* [GitHub](https://github.com/alibaba/uirecorder)

## Source Code

Source code is maintained in different repos within [macacajs](https://github.com/macacajs).

It is recommended to get started from the [official site](https://macacajs.github.io), since there are many repos in macacajs.

## Help and Support

- [Official Site](//macacajs.github.io)

- [Samples](//github.com/macaca-sample)

- [Roadmap](//macacajs.github.io/guide/roadmap.html)

- [Awesome](//github.com/macacajs/awesome-macaca)

- [Community Support](//macacajs.github.io/guide/support.html)

## License

The MIT License (MIT)