---
title: "【自动化测试】经验与技巧[adb&Aritest&Poco]"
author: "Perrin Yong"
author_profile: https://www.pystone.net/profile/
published_by: "Perrin Yong"
canonical: https://www.pystone.net/notes/adb-airtest-poco-tips-tricks/
type: note
content_role: unspecified
visibility: public
id_stability: rename-stable
source_path: "10-计算机、信息技术与工程/03-软件工程与质量保障/CI-CD与质量保障/CI-CD工具链/【自动化测试】经验与技巧[adb&Aritest&Poco].md"
content_hash: d6eaf22168a0a644ca5766c40716239d4e03b9febd1bf8d3facb27b53b7ea2ce
knowledge_version: 224c990773de.5fa8af6e39fa
site_commit: 224c990773de166d23a886306577dd90379529ce
notes_commit: 5fa8af6e39fa3891d1b9b4832bfa6c4e0ecaaf0a
---
# 【自动化测试】经验与技巧[adb&Aritest&Poco]

# 【自动化测试】经验与技巧[adb&Aritest&Poco]

> 创建时间：2021/5/8 13:39

* ADB技巧
    * 连接安卓设备
    * Profiler: Editor-to-Android connection
    * log抓取
    * 获取包名等
    * 启动游戏
  * Airtest
    * 相关概念
      * proxy
      * 其他
    * 常用API
      * 基本
      * Connect
      * Simulate Input
      * Make Assertion
    * Running .air from CLI
      * run automated case
      * generate html report
      * get case info
    * 设备连接问题
      * Some special parameters
    * 相关网站
    * 设备支持问题
  * Poco
    * SDK集成
    * 术语
    * 多设备连接与初始化
    * 坐标系
    * 常用API
      * 操作UI对象(Object Proxy Related Operation)
      * 全局操作(Global Operation)
      * 异常处理(Exceptions)
  * 实践技巧（需求及处理方案汇总）
  * 遇到的坑
    * [Python]ModuleNotFoundError and ImportError
  * Ref

## ADB技巧

用法大全: https://github.com/mzlogin/awesome-adb

### 连接安卓设备

WIFI连接调试：

```cpp
string s = String.Empty;

```
```cpp
string s = String.Empty;

```
```cpp
string s = String.Empty;

```

切换USB模式与WIFI模式

```cpp
string s = String.Empty;

```

### Profiler: Editor-to-Android connection

adb forward tcp:34999 localabstract:Unity-{insert bundle identifier here}

### log抓取

adb logcat -s Unity
adb -s %DeviceName% logcat -s Unity
adb logcat -s Unity ActivityManager PackageManager dalvikvm DEBUG #获取log，-s指定过滤器
adb -s deviceName logcat -s Unity -f /mnt/sdcard/log.txt #-f 输出log到指定文件。只能输出到Android设备上。
adb -s deviceName logcat -s Unity > c:\unity_log.txt

### 获取包名等

shell命令：

```cpp
string s = String.Empty;

```

### 启动游戏

adb shell dumpsys package com.examle.xx
adb shell am start -n 包名/包名.****

## Airtest

### 相关概念

#### proxy

代理服务器 (Proxy server) : In computer networking, a proxy server is a server application or appliance that **acts as an intermediary for requests from clients seeking resources from servers that provide those resources** 。

Proxy主要运作的行为在 OSI 七层协议的 **应用层** 部分。Proxy 能不能进行某些工作，与该服务的程序功能有关。

#### 其他

  * **网络主机（network host）** \- 是已连接到一个计算机网络的一台电子计算机或其他设备。
使用TCP/IP协议族参与网络的计算机也可称为IP主机。更具体来说，参与互联网计算机可称为互联网主机，有时还称作互联网节点。

### 常用API

#### 基本

```cpp
string s = String.Empty;

```

#### Connect

```cpp
string s = String.Empty;

```

![assets/Image.png](/media/02c20bcc2fbab5952654.png)

![assets/Image_1.png](/media/4b0b20b5b8c9c8fe631c.png)

connect_device("Android://127.0.0.1:5037/10.254.60.1:5555")

  * adb host: adb server的地址（the IP of the host where adb Server is located） -
By default, this is localhostor 127.0.0.1

  * adb port defaults to 5037

  * devicehost:port: 移动设备的地址和端口号 （端口号：5555-5585）

#### Simulate Input

touch
swipe
text
keyevent
snapshot
wait

#### Make Assertion

assert_exists
assert_not_exists
assert_equal
assert_not_equal

### Running .air from CLI

#### run automated case

> airtest run "path to your .air dir" \--device Android:///
>  airtest run "path to your .air dir" \--device Android://adbhost:adbport/serialno
>  airtest run "path to your .air dir" \--device Windows:///?title_re=Unity.*
>  airtest run "path to your .air dir" \--device iOS:///

```cpp
string s = String.Empty;

```

#### generate html report

> airtest report "path to your .air dir"

```cpp
string s = String.Empty;

```

#### get case info

> python -m airtest info "path to your .air dir"

```cpp
string s = String.Empty;

```

### 设备连接问题

可以在调用airtest时连接设备，也可以在airtest脚本中进行设备的连接。

> These two methods only need to choose one of them, basically can meet our needs to connect devices.

调用时通过参数初始化连接:

  * 在运行时的命令行中如果传入了类似`--device Android:///XXXX` 这样的设备参数，那么脚本在 **初始化时会自动连上对应的设备** ，不需要再另外写代码连接了。连接哪个设备，就会在哪个设备上执行脚本
  * 如果不主动输入连接的设备，则会默认选择（随机性）一个设备来执行脚本。

airtest脚本内通过API连接:

  * 如果没有在初始化时连上设备，可以在脚本代码中使用`connect_device`接口来连接设备。
  * Airtest支持在一个脚本里同时连接多个设备，使用`set_current`接口可以在多个设备中进行切换，`device()`接口可以获取到当前使用中的设备。

虽然支持多线程多设备运行，但是一个airtest进程在同一时间只支持在一个设备上执行命令。可以调用时就设置连接的设备，也可以在脚本内进行连接或者断开，但`device()` 接口获取的当前设备只有一个。

#### Some special parameters

Some special devices may appear black screen when connected, such as some emulators, we can add an extra parameter cap_method=JAVACAP to force the screen capture mode to be JAVACAP :

```cpp
string s = String.Empty;

```

In addition, we have two other parameters, ori_method=ADBORI, which specifies the rotation mode of the device screen, and touch_method=ADBTOUCH, which specifies the click mode of the screen as ADB instruction.

命令行传参数需要对一些字符进行转义。
if any of the characters `^<>|&` appear on the command line, they may need to be escaped to take effect.

```cpp
string s = String.Empty;

```

### 相关网站

源码地址：https://github.com/AirtestProject/Airtest

Android连接常见问题： https://airtest.doc.io.netease.com/IDEdocs/device_connection/2_android_faq/

各个平台支持情况：https://airtest.readthedocs.io/zh_CN/latest/wiki/device/platforms.html

Android平台的一些技巧： https://airtest.readthedocs.io/zh_CN/latest/wiki/device/android.html

模拟器连接：https://airtest.doc.io.netease.com/en/IDEdocs/device_connection/3_emulator_connection/#2

Airtest Project文档：https://airtest.doc.io.netease.com/

### 设备支持问题

https://airtest.doc.io.netease.com/IDEdocs/device_connection/6_android_support/

## Poco

### SDK集成

场景中任意 GameObject 上 Add Component Unity3D/PocoManager.cs

### 术语

UI proxy: proxy objects within Poco framework, they represent zero (none), one or multiple in-game UI elements
Node/UI element: UI element instances or nodes in app/game
选择表达式 ：除非你需要扩展或自定义更底层的Poco的行为，一般无需关心此。选择表达式是一种框架和sdk交互的底层数据结构，用在 Selector 类中。

### 多设备连接与初始化

https://poco.readthedocs.io/zh_CN/latest/source/doc/drivers/unity3d.html

### 坐标系

归一化坐标系(Normalized Coordinate System)
UI在poco中的宽和高其实就是相对于屏幕的百分比大小，好处就是不同分辨率设备之间，同一个UI的归一化坐标系下的位置和尺寸是一样的，有助于编写跨设备测试用例。屏幕正中央一定是(0.5, 0.5)

局部坐标系(Local Coordinate System (local positioning))
局部坐标系以UI包围盒左上角为原点，向右为x轴，向下为y轴，包围盒宽和高均为单位一。

### 常用API

```cpp
string s = String.Empty;

```

UI选择：

  * 相对选择器(Relative Selector)
  * 空间顺序选择器(Sequence Selector)

#### 操作UI对象(Object Proxy Related Operation)

点击(click)
滑动(swipe)
拖拽(drag) - darg 是从一个UI拖到另一个UI，而 swipe 是将一个UI朝某个方向拖动。

局部定位(focus (local positioning)) - 所有UI相关的操作都默认以UI的 anchorPoint 为操作点，如果想自定义一个点那么可以使用 focus 方法。调用此方法将返回 新的 设置了默认 焦点 的UI

```cpp
string s = String.Empty;

```

等待出现(wait)
wait(5).exists()
wait_for_appearance(timeout=120)
wait_for_disappearance(timeout=120)

#### 全局操作(Global Operation)

poco.click([0.5, 0.5])
poco.long_click([0.5, 0.5], duration=3)
poco.swipe(point_a, center)

截屏(snapshot)

```cpp
string s = String.Empty;

```

#### 异常处理(Exceptions)

PocoTargetTimeout
PocoNoSuchNodeException

## 实践技巧（需求及处理方案汇总）

Android设备上的一些操作技巧可查看：
https://airtest.readthedocs.io/zh_CN/latest/wiki/device/android.html

涉及到的例子有：连续滑动、两个手指操作、录屏等

代码功能示例：https://airtest.readthedocs.io/zh_CN/latest/wiki/code/code.html

## 遇到的坑

### [Python]ModuleNotFoundError and ImportError

set PYTHONPATH="path to your .air dir"

## Ref

https://www.zhihu.com/zvideo/1261234074455998464