Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/austin2035/hermit
Don't need ADB. It runs on Android and the software itself provides a restful API, you just need to send an HTTP request and it translates the call to the API into an operation on the phone.
https://github.com/austin2035/hermit
android-auto android-automation automated-testing automation restful-api
Last synced: 14 days ago
JSON representation
Don't need ADB. It runs on Android and the software itself provides a restful API, you just need to send an HTTP request and it translates the call to the API into an operation on the phone.
- Host: GitHub
- URL: https://github.com/austin2035/hermit
- Owner: austin2035
- License: gpl-3.0
- Created: 2021-01-26T06:15:39.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-09-01T09:04:20.000Z (about 2 years ago)
- Last Synced: 2024-06-01T23:36:28.060Z (5 months ago)
- Topics: android-auto, android-automation, automated-testing, automation, restful-api
- Language: Java
- Homepage: https://lookcos.cn/archives/1206.html
- Size: 8.68 MB
- Stars: 317
- Watchers: 9
- Forks: 62
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[中文README](./README_CN.md)
Doc: [https://www.lookcos.cn/docs/hermit](https://www.lookcos.cn/docs/hermit)
## Introduction
Hermit, a software for Android automation testing, runs on Android by receiving restful API requests, which are then translated into operations on the device.
It supports a range of operations such as quick taps, swipes, reading and setting the clipboard (Chinese language support), simulating input, finding controls and clicking on them, and supports visual layout analysis.
Less than 3Mib in size and runs on port 9999 by default.
## Accessibility based features
- Coordinate click
- Coordinate swipe
- Clicking based on control ids (if there are multiple identical ids, click based on order)
- Click based on control text (as above, clickable in order)
- Click based on control content-desc
- View screenshots
- Analog input function (Chinese language support)
- Ten global functions (back, press home key, recent tasks, show notifications, quick settings, long press on power button, split screen, lock screen, screenshot)
- Real-time access to interface control details
## Root-based features
- Coordinate tapping
- Coordinate swipe
- Screenshot
- Request and determine root access
- Send any keyevent
- Long press on coordinates
- Launch app based on package name
- Get device information capability
- Get and set clipboard content (Chinese language support)
- Device screen length and width
- CPU max, min, real time frequency
- CPU name
- Total amount of memory, available
- Total amount of storage, amount available
- Name of all installed packages
- Device language, system version number, phone model, phone manufacturer
## Interactive layout visualisation
Similar to Android Studio's LayoutInspector, you can analyse the level and scope of the interface and get information about the controls on the interface to facilitate operations such as clicking and swiping.
Controls can be selected with the mouse (see LayoutInspector for details) to see the corresponding information:
- bounds (clickable range)
- boundsInParent
- checked
- class
- clickable
- package
- resource-id (control id)
- scrollable
- text (control text)
- content-desc (control description)
## How it works
### Caution
The diagram may be slightly over-drawn, but in short: Hermit, once installed and running, provides HTTP APIs which are translated into operations on the phone by calling the appropriate APIs. As a result, most languages can be supported. It is because it is based on the restful API that it is considerably more extensible, and a Python module based on its API has been produced to enable the ease of operation.