八、手机助手(工具按钮)功能

1. 手机助手功能的入口

在IDE的设备连接窗口连接上我们的设备之后,右上角会出现一个手机助手 Phone assistant 的功能按钮(或称工具按钮):

image-20210923154924478

点击该按钮,可以看到它给我们提供了以下功能:

image-20210923155112693

本文将详细介绍这些功能按钮的功能。

2. 控制面板与断开当前设备

点击手机助手的 控制面板 按钮,我们会从设备画面,切换到刚才连接设备的窗口页面:

image-20210923155430850

在这里,我们可以连接第二台甚至更多台设备(但目前1次只能显示1个设备画面,不能同时显示多个设备的画面),也可以看到IDE当前已连接的设备并点击 disconnect 按钮断开已经连接的设备;此时我们再次点击手机助手的按钮,即可切换回刚才的设备画面中:

image-20210923155830662

另外,手机助手按钮还给我们提供了 断开当前设备 的快捷按钮,单击该按钮即可断开当前连接的设备:

image-20210923160205716

3. 显示Android助手

为了方便使用安卓手机的用户进行一些ADB相关的操作,我们增加了一个 安卓手机助手功能 ,在 连上Android设备后 (真机or模拟器),点击设备窗口右上角的工具图标(手机助手按钮),在展开下拉菜单中,选择 Show assistant dialog 即可打开安卓手机助手。

image

image

在安卓手机助手中,我们提供了以下几种功能:

  • 手机应用的安装/卸载/列表查看
  • 常用快捷操作:打开网址、输入文本、切换输入法、音量调节等
  • 手机Shell调试窗口

注意

目前安卓手机助手功能尚在待完善阶段,若出现BUG,请将操作步骤、手机型号、 安卓版本号 和报错log反馈至 Github

1)App管理功能

① 从电脑安装Apk到手机

目前可以直接点击安卓助手上的安装按钮,选择PC上的apk文件后,即可打开安装窗口。点击 Install按钮将会开始尝试向手机上安装apk,请注意操作手机点击同意安装。

image

此外,直接拖动apk文件到当前手机的屏幕画面上,松开鼠标按键后,也能打开安装窗口进行安装。

apk路径问题

请同学们尽量将apk保存在 纯英文路径 下,若安装路径中包含中文,大概率会出现apk安装失败的情况。

2)手机应用列表查看

安卓助手左侧列表中显示了当前手机安装的应用列表,可在搜索框中输入关键词进行列表筛选。勾选 Only show third party applications 将会只显示手机中的第三方应用,让列表更精简。

image

需要 复制包名 的同学,可以在这个列表中找到对应的apk包名,然后单击包名后使用 ctrl+c 将包名复制到剪切板上,之后可以直接使用 ctrl+v 粘贴包名到我们的脚本编辑窗口使用。

3)手机应用的快捷操作

安卓助手右下角是一系列手机应用的快捷操作按钮,可以对左侧列表中选中的应用进行启动、关闭、卸载、清理和备份操作。

image

在点击 stop start clear 等操作之前,请确保当前的 Package 栏目中显示的包名,是想要操作的对应包名。点击 refresh 按钮可以刷新并显示手机当前启动中的包信息。此功能可以帮助我们获取设备安装应用的包名,我们可以在已连接的Android设备中,打开需要知道包名的apk,然后从工具按钮中找到显示Android助手,点击 refresh 按钮刷新启动应用的包信息 。

4)手机常用快捷操作

① 打开网址和快速输入
  • 在右上角输入框中输入网址并点击 open,会使用当前默认浏览器打开该网址。
  • 输入text内容并点击 input ,可以在手机上输入该内容。
② 快捷切换输入法

IME Manager 下拉菜单中可以快速切换手机当前输入法,在airtest中默认使用的输入法是yosemite输入法,在切换回人工使用时不太方便,现在可以直接在这个下拉菜单中进行选中切换输入法了。

image

③ 常用快捷操作

Quick Button 提供了 unlock 解锁、power 电源键 的操作, 以及一个 snapshot可以立刻截取一张当前手机画面的图片,并选择路径保存到电脑中。

Volumn Setting 提供了 mute 静音、volumn_down音量降低、 volumn_up音量升高 的快捷操作。

image-20210923161408673

5)手机shell调试窗口

偶尔我们需要对安卓手机进行一些ADB操作,或是连上ADB shell查看一些手机相关的信息,目前可以在安卓手机助手中,切换到 Remote Debug 页面,就能直接输入 adb shell 指令了。

image

如图所示,无需输入 adb shell ,只需要输入后续的指令,即可看到对应的返回结果,不需要另外使用命令行去连接ADB SHELL了。

Clear log 按钮可以清理当前窗口中的log, Export log to a file 可以导出当前log窗口里的信息到一个文本文件中。

请注意,本功能尚在试用阶段,部分shell命令请 不要输入 ,例如 top 这样会反复刷屏的命令。

4. 显示TV版按钮

部分TV版App,以及某些特殊设备上的应用,可能需要使用上下左右方向键+确认键进行操作,针对这样的需求,我们增加了一个TV版按钮的小功能:

image

在成功连接上设备后,点击右上角的快捷菜单按钮,在弹出窗口中选择显示TV按钮,即可打开TV按钮:

image

使用它即可快捷点击上下左右+确认按钮,对应的ADB指令分别为:

  1. adb shell input keyevent KEYCODE_DPAD_UP
  2. adb shell input keyevent KEYCODE_DPAD_DOWN
  3. adb shell input keyevent KEYCODE_DPAD_LEFT
  4. adb shell input keyevent KEYCODE_DPAD_RIGHT
  5. adb shell input keyevent ENTER