# 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 : APP自动化性能测试
![](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>


## 📋介绍

* 纯可视化解决方案，独立于XML和系统元数据。
* 操作范围不受限制，可进行多应用操作。
* 用于操作定位的多种视觉感知工具。
* 无需探索和训练，即插即用。

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

## 🔧开始
❗ 将config.conf中的信息修改为所需的测试信息
```
android-monitor/config.conf
```
❗ 根据需要修改配置文件
![20240205-115108.jpeg](assets%2F20240205-115108.jpeg)


### 如何添加飞书机器人
 refer to https://open.feishu.cn/document/ukTMukTMukTM/ucTM5YjL3ETO24yNxkjN?lang=en-US

### 连接移动设备的准备工作
❗ 一般情况下，不需要配置
❗ 在特殊情况下，您可以自己下载并安装它，然后将其移动到tools目录中
1. 下载[Android调试桥](https://developer.android.com/tools/releases/platform-tools?hl=en).
2. 打开Android手机上的ADB调试开关，需要先在开发者选项中打开。
3. 用数据线将手机连接到电脑，然后选择“传输文件”。
4. 按如下方式测试您的ADB环境：```/path/to/ADB设备```。如果显示连接的设备，则说明准备工作已完成。
5. 如果您使用的是MAC或Linux系统，请确保按如下方式打开adb权限：``sudo chmod+x/path/to/adb```
6. 如果您使用的是Windows系统，路径将为``xx/xx/adb.exe```

### 运行
```
python3 android-monitor/androidperf/startup.py
```

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


## 引用
如果您发现Android Monitor对您的研究和应用有用，请引用使用此BibTeX:
```
@article{peri2024Android,
  title={[YMX PERF]Android-Monitor : Automation of APP Performance Testing},
  author={Biccabo Li,Mency Ying},
  year={2024}
}
```

## 📋名词解析
### pss_ipc
- pss：实际使用的物理内存
- java_heap：java的堆内存
- native_heap：其他的堆内存

### cpuinfo
- device_cpu_rate：整机CPU使用率
- user%：用户态CPU使用率
- system%：内核态CPU使用率
- idle%：空闲CPU
- pid_cpu%：测试对象进程的CPU

### meminfo
- total_ram：设备总内存
- free_ram：可用内存
- pid_pss：测试对象进程的内存