# android-monitor

**Repository Path**: phlio/android-monitor

## Basic Information

- **Project Name**: android-monitor
- **Description**: 无需Agent的Android性能实时监控系统。
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-02-05
- **Last Updated**: 2024-03-05

## Categories & Tags

**Categories**: android-modules

**Tags**: None

## README


# [YMX PERF]Android-Monitor : Automation of APP Performance Testing
![](assets/logo.png?v=1&type=image)
<div align="center">
    <a href="https://arxiv.org/abs/2401.16158"><img src="https://img.shields.io/badge/Arxiv-2401.16158-b31b1b.svg?logo=arXiv" alt=""></a>
    <a href="https://huggingface.co/papers/2401.16158"><img src="https://img.shields.io/badge/🤗-Paper%20In%20HF-red.svg" alt=""></a>
</div>
<br>
<div align="center">
biccabo Li<sup>1</sup>, Mency Ying<sup>2</sup>,
</div>


## 📋Introduction
* Pure visual solution, independent of XML and system metadata.
* Unrestricted operation scope, capable of multi-app operations.
* Multiple visual perception tools for operation localization.
* No need for exploration and training, plug and play.

### Installation
```
git clone https://gitee.com/phlio/android-monitor.git
cd android-monitor
pip3 install -r requirements.txt
```

## 🔧Getting Started
❗Modify the information in config.conf to the required testing information
```
android-monitor/config.conf
```
❗Modify the configuration file as required
![20240205-115108.jpeg](assets%2F20240205-115108.jpeg)


### How to add Feishu robots
 refer to https://open.feishu.cn/document/ukTMukTMukTM/ucTM5YjL3ETO24yNxkjN?lang=en-US

### Preparation for Connecting Mobile Device
❗In general, configuration is not required 
❗In special circumstances, you can download and install it yourself and move it to the tools directory
1. Download the [Android Debug Bridge](https://developer.android.com/tools/releases/platform-tools?hl=en).
2. Turn on the ADB debugging switch on your Android phone, it needs to be turned on in the developer options first.
3. Connect your phone to the computer with a data cable and select "Transfer files".
4. Test your ADB environment as follow: ```/path/to/adb devices```. If the connected devices are displayed, the preparation is complete.
5. If you are using a MAC or Linux system, make sure to turn on adb permissions as follow: ```sudo chmod +x /path/to/adb```
6. If you are using Windows system, the path will be ```xx/xx/adb.exe```


### Run
```
python3 android-monitor/androidperf/startup.py
```

## 📱Mobile-Eval
![](assets/20240205-114345.jpeg?v=1&type=image)


## Citation
If you find Android-Monitor useful for your research and applications, please cite using this BibTeX:
```
@article{peri2024Android,
  title={[YMX PERF]Android-Monitor : Automation of APP Performance Testing},
  author={Biccabo Li,Mency Ying},
  year={2024}
}
```

## 📋Noun analysis
### pss_ipc
- pss：Actual physical memory used
- java_heap：Java's heap memory
- native_heap：Other heap memory

### cpuinfo
- device_cpu_rate：CPU usage rate of the entire machine
- user%：User mode CPU usage rate
- system%：Kernel CPU usage rate
- idle%：Idle CPU
- pid_cpu%：CPU of the test object process

### meminfo
- total_ram：Total memory of the device
- free_ram：available memory
- pid_pss：Memory of the test object process