# AndroidVehicleAutoTestFramework

**Repository Path**: qiuqqit/android-vehicle-auto-test-framework

## Basic Information

- **Project Name**: AndroidVehicleAutoTestFramework
- **Description**: 安卓车机自动化测试代码生成工具
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-07-04
- **Last Updated**: 2025-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 自动化测试框架使用说明

>   2024年11月13日 编辑

# 一、实时显示车机画面

1.  连接adb并确保能正常进入shell以及root
    
2.  点击动态按钮
    
3.  界面黑色区域将会显示动态画面
    

![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/9b2daf4c-b340-4306-825f-36f8147605fe.png)

![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/28ee68ce-711a-463f-b384-c040e66abc1c.png)

# 二、新增用例

1.  在用例编辑器内的标题栏输入用例标题
    
2.  点击用例编辑器的+号按钮
    
3.  录制或点击左侧的功能按钮或点击屏幕区域下方的断言按钮
    

![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/17c3d425-a2a9-4e72-8f4c-28f931244099.png)

### 录制

> 请勾选左下角的录制选项

> 如不想录制两个动作之间的延迟，请取消勾选录制延时

*   点击：在屏幕区域上点击，会自动将坐标信息插入到用例中。
    
*   滑动：在屏幕区域上点击后滑动，会自动将位置信息储存到用例中。
    
*   长按：在屏幕上长按
    
*   拖拽：在屏幕上长按后拖拽
    

### 标定

> 请确保屏幕区域不为黑屏（勾选动态按钮）

1.  点击添加标定，屏幕区域会转为静态模式。
    

![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/8f4ed810-95be-4310-9171-ad51e5c049b7.png)

2.  在屏幕区域框选需要标定的位置
    
3.  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/c4417649-8f12-4c0d-b22d-9021156e184d.png)
    
4.  标定完成后会弹出保存窗口，选择合适的位置后保存。（注意：只能保存在软件根目录/data/下面，但可在data目录中创建文件夹。）
    
5.  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/38f48315-f8c5-4026-a00a-f674b4a574b3.png)
    
6.  保存完成后即可在标定标签内找到刚才标定的元素，点击可查看图片信息（如果勾选了录制选项，会自动添加一个断言到用例中）
    
7.  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/360f8839-a86c-4f2e-85b8-e7f1b5773bd3.png)
    

### 获取元素

1.  选择静态
    
2.  点击屏幕区域的元素（建议取消勾选录制选项）
    
3.  程序将自动获取鼠标点击位置最小范围的元素，并自动跳转到元素标签，将图片、位置信息、id、文本等展示在界面上
    
4.  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/51c94e11-4f1e-44ab-858d-4b720a13fa75.png)
    
5.  如果没获取到信息，则会在对应的输入框中置空。
    
6.  如果信息后面的图片为√，则表示该信息可用于点击、断言。
    
7.  如后面的图片为×，则表示多个元素使用该信息，且无法找到更合适的信息。
    
8.  在点击模式下，点击图片按钮可插入一条点击动作到用例。分别为点击坐标、ResourceId、Text、XPath。
    
9.  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/bf52488e-1663-45fc-9477-19205298e34c.png)
    
10.  断言模式需要先点击保存，且必须将图片保存到/data/目录中（可在该目录中新建文件夹）
    
11.  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/6ab37d64-0085-4d7b-920f-f6bc531ce081.png)
    
12.  保存后会新增一条记录，可点击查看![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/ac61c6e4-5513-4d98-b8c7-e9167e4ae935.png)
    
13.  切换到断言模式，点击图片按钮会添加对应的断言信息到用例中，分别为断言图片是否匹配、ID是否存在、文本是否存在、XPath是否存在。![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/3c21b0e2-3c69-4ea5-9db1-e64cefe79e37.png)
    

# 三、功能按钮

> 需要先点击需要将事件插入的位置，如下面的点击坐标上方插入一个等待时间，则需要先点击已有的“点击坐标”事件，再点击等待时间按钮，添加等待时间。

### 等待时间

![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/4fe7c484-b611-447f-ab73-eb974b6c9880.png)

### 加载DBC

如需发送CAN、CANFD信号，需要加载DBC文件，为信号解析提供支持

### 选择CAN盒

如需发送CAN、CANFD信号，需要选择CAN盒，目前已支持同星和周立功的CAN盒

![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/16f604c6-52ea-4bf5-b61a-44dc472e067e.png)

### 发送CAN、CANFD信号

> 确保DBC文件已加载，CAN盒已选择

1.  点击发送CAN信号
    
2.  选择添加信号，则会添加一行信号（可添加多个CAN信号）![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/401945bd-7a22-43a6-b9bb-28a3dc3f5c3f.png)
    
3.  在ID、name输入框中搜索（注意大小写）或选择，程序会自动生成所有参数都为0的字节信息并展示到值中
    
4.  如需发送指定帧数，请填写需要发送的帧数，以及帧数之间的间隔时间（ms）
    
5.  如果是CANFD信号，需要勾选FD并正确填写fdlc和ffdp。
    
6.  点击...按钮进入信号编辑窗口，修改对应的值，并点击确定。
    
7.  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/ef705ccd-ce5e-4c2f-8d83-7357eadcaf21.png)
    
8.  程序会解析成对应的字节信息，点击确认，即可插入一条发送CAN、CANFD信号的事件。![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/032e6b0c-220f-4771-a40d-d8ec369c22d8.png)
    

### 停发CAN、CANFD信号

如果用例中有发送CAN、CANFD信号的事件，点击停发CAN信号后，会自动搜索到所有正在发送的信号，勾选需要停发的信号，点击确认即可插入一条停止CAN、CANFD信号事件。

### 断言CAN、CANFD信号

1.  点击断言CAN信号按钮，在弹窗中点击添加信号按钮。
    
2.  选择需要断言的ID或name，输入需要断言的帧数，填写值或点击...按钮填写详细信息自动生成值
    
3.  点击确认按钮即可添加一条断言CAN、CANFD信号事件
    

### 控制继电器

1.  点击添加继电器按钮
    
2.  在弹窗中选择需要控制的继电器，输入通道号，选择开关，点击确认即可添加一个继电器控制事件。（可点击测试按钮确认是否为指定通道）
    
3.  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/32a8383a-4316-4e60-988b-2fbb8c2bd737.png)
    

### 断言声音

1.  点击断言声音按钮
    
2.  输入设备名、采样率、采样时间、电压阈值（V），点击确认即可添加断言声音事件
    
3.  ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/c201b432-c222-4cc4-bf31-bbe10fb7caa8.png)
    

# 四、脚本编辑

### 更换顺序

拖拽需要更换执行顺序的事件到对应位置，如下图，将1号事件拖拽到2号事件，软件会将1号事件置于2号事件的上方

![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/bac44c90-accd-4a04-8cc1-8753bcf70671.png)

### 删除行

如需删除指定行，需要先选择对应的事件，点击删除即可

![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/456a1a8b-6ec7-4787-b525-030345d74d66.png)

### 调试

执行单个事件

点击事件后面的执行按钮即可，注意：如需发送CAN、CANFD信号，需要先执行加载DBC和选择CAN盒操作

![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/e4c276d4-cd14-46dd-9a02-dee5e27b6250.png)

### 执行当前用例

选择需要执行的用例，点击当前脚本▶即可，每个事件的执行结果会显示在表格中的结果列。

![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/pLdn5gxm8LNKOo83/img/4dc94fc5-19ca-4def-8903-792e5f5f7a1b.png)

### 批量执行

如需执行多个用例，需先切换到执行的第一个用例，点击批量执行▶即可，程序会按顺序执行

### 停止执行

如在执行用例过程中需要停止执行，点击停止按钮即可

### 保存

编辑号单个或多个用例后，点击保存按钮即可将脚本保存到本地

### 读取

点击打开按钮，选择对应的脚本，即可将用例导入到程序中