五、Airtest封装的ADB操作

1. 前言

ADB,即 Android Debug Bridge (安卓调试桥)。它就是一个命令行窗口,用于通过电脑端与模拟器或者真机设备进行交互。

对于Android开发和测试人员来说,它都是不可替代的强大工具。所以今天,我们将跟同学们一起来聊一聊一些常用的ADB操作和Airtest给我们封装好的一些ADB接口。

2. 一些使用ADB命令的场景

作为一名测试人员,相信大家对使用ADB的场景都不陌生了。比如在做真机或者模拟器测试之前,我们常用 adb devices 命令去查看被测设备是否已经跟我们的电脑建立了连接:

  1. >>> adb devices
  2. List of devices attached
  3. PFT4PBLF75GQHYBM device
  4. emulator-5554 device

再比如,我们在使用Airtest进行测试自动化时,经常遇到ADB版本冲突的报错:

  1. raise AdbError(stdout, stderr)
  2. airtest.core.error.AdbError: stdout[] stderr[adb server version (36) doesn't match this client (40); killing...
  3. could not read ok from ADB Server

而我们不清楚电脑里面那么多ADB,究竟哪些是40版本,哪些是36版本时,我们就可以使用 adb version 查看当前的ADB版本,然后将电脑里面所有的ADB替换成同一个版本,从而解决这个版本冲突的问题:

  1. >>> adb version
  2. Android Debug Bridge version 1.0.40
  3. Version 4986621
  4. Installed as C:\Users\xiaojuan\adb.exe

3. 常用的ADB操作及使用示例

当然,除了上面已经提到的查询已连接的设备/模拟器命令 adb devices, 和查看ADB版本的命令adb version ,ADB操作可以做的事情还非常多:

1)应用管理

① 查看应用列表

  1. # 查看设备上的所有应用
  2. adb shell pm list packages
  3. # 查看设备上的第三方应用
  4. adb shell pm list packages -3
  5. # 查看设备上的系统应用
  6. adb shell pm list packages -s

② 安装APK

  1. adb install "D:/demo/tutorial-blackjack-release-signed.apk"

③ 卸载应用

  1. adb uninstall com.netease.cloudmusic

④ 查看应用详细信息

  1. adb shell dumpsys package com.netease.cloudmusic

2)文件管理

① 复制设备里的文件到电脑

  1. # adb pull <设备里的文件路径> [电脑上的目录]
  2. adb pull /sdcard/sr.mp4 ~/tmp/

② 复制电脑里的文件到设备

  1. # adb push <电脑上的文件路径> <设备里的目录>
  2. adb push ~/sr.mp4 /sdcard/

3)模拟按键输入

① 模拟电源键: adb shell input keyevent 26

② 模拟HOME键: adb shell input keyevent 3

③ 模拟返回键: adb shell input keyevent 4

④ 点亮/熄灭屏幕:

  1. # 点亮屏幕
  2. adb shell input keyevent 224
  3. # 熄灭屏幕
  4. adb shell input keyevent 223

⑤ 模拟滑动解锁

  1. # 300 1000 300 500 分别表示起始点x坐标 起始点y坐标 结束点x坐标 结束点y坐标
  2. adb shell input swipe 300 1000 300 500

⑥ 输入文本

  1. adb shell input text airtest

4)查看设备信息

① 查看设备型号

  1. >>> adb -s PFT4PBLF75GQHYBM shell getprop ro.product.model
  2. OPPO A83

② 查看屏幕分辨率

  1. >>> adb -s PFT4PBLF75GQHYBM shell wm size
  2. Physical size: 720x1440

③ 查看Android系统版本

  1. >>> adb -s PFT4PBLF75GQHYBM shell getprop ro.build.version.release
  2. 7.1.1

5)更多ADB命令详解

想了解更多详细的ADB操作的同学,我们推荐大家阅读这篇GitHub文档:https://github.com/mzlogin/awesome-adb

4. Airtest封装好的ADB接口及使用示例

在Airtest库中,大部分的ADB操作我们已经帮大家封装好了,所以同学们可以不用再单独去执行ADB命令。

举个简单的例子,利用Airtest封装好的ADB接口打印设备序列号和设备所有的第三方应用:

image

可以看到,我们只需要调用一些封装好的airtest接口,即可替代完整的ADB命令,另外在log查看窗的运行日志中,我们还可以看到这个接口实际执行的ADB命令:

  1. # android.get_default_device()对应的ADB命令
  2. adb.exe devices
  3. # android.list_app(third_only=True)对应的ADB命令
  4. adb.exe -s PFT4PBLF75GQHYBM shell pm list packages -3

另外Airtest还有很多常用的封装好的ADB接口:

1)返回应用的完整路径:path_app()

  1. android = Android()
  2. android.path_app("com.netease.cloudmusic")

2)检查应用是否存在于当前设备上:check_app()

  1. android = Android()
  2. android.check_app("com.netease.cloudmusic")

3)停止应用运行:stop_app()

  1. stop_app("com.netease.cloudmusic")
  2. # 启动应用:start_app()
  3. start_app("com.netease.cloudmusic")
  4. # 清除应用数据:clear_app()
  5. clear_app("com.netease.cloudmusic")

4)安装应用:install_app()

  1. install(r"D:\demo\tutorial-blackjack-release-signed.apk")
  2. # 卸载应用:uninstall_app()
  3. uninstall("org.cocos2dx.javascript")

5)关键词操作:keyevent()

  1. keyevent("HOME")
  2. keyevent("POWER")

6)唤醒设备:wake()

  1. wake()

7)返回HOME:home()

  1. home()

8)文本输入:text()

  1. text("123")

9)检查屏幕是否打开:is_screenon()

  1. android = Android()
  2. android.is_screenon()

10)检查设备是否锁定:is_locked()

  1. android = Android()
  2. android.is_locked()

11)获取当前设备的分辨率:get_current_resolution()

  1. android = Android()
  2. android.get_current_resolution()

12)其它adb shell命令:shell()

  1. shell("ls")
  2. shell("pm list packages -3")

image

实际上,airtest的 shell() ,就是帮忙补充了 adb -s 手机序列号 shell 这一部分,后面的内容同学们就按正常shell指令来传就行了。

13)更多Airtest封装好的ADB接口介绍

若同学们需要了解更多详细的Airtest封装好的ADB接口介绍,可以到你本地的Airtest库里面查找这个文件查看:airtest/core/android/android.py