八、手机助手（工具按钮）功能

1. 手机助手功能的入口

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

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

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

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

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

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

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

3. 显示Android助手

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

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

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

注意

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

1）App管理功能

① 从电脑安装Apk到手机

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

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

apk路径问题

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

2）手机应用列表查看

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

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

3）手机应用的快捷操作

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

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

4）手机常用快捷操作

① 打开网址和快速输入

• 在右上角输入框中输入网址并点击 open，会使用当前默认浏览器打开该网址。
• 输入text内容并点击 input ，可以在手机上输入该内容。

② 快捷切换输入法

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

③ 常用快捷操作

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

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

5）手机shell调试窗口

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

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

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

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

4. 显示TV版按钮

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

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

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

adb shell input keyevent KEYCODE_DPAD_UP
adb shell input keyevent KEYCODE_DPAD_DOWN
adb shell input keyevent KEYCODE_DPAD_LEFT
adb shell input keyevent KEYCODE_DPAD_RIGHT
adb shell input keyevent ENTER