Appium Inspector使用

Appium 1.15版本

Appium Inspector是appium自带的一个元素定位工具。启动 Inspector 这个查看元素工具，首先要确保 Appium Server 要运行起来。

前提：已连接一个Android 设备

1.在Appium 启动成功后的窗口，点击【Start Inspector Session】。 

1. 点击之后，打开是这个页面。 要想启动Inspector 需要我们手动创建一个 session，其实也就是创建一个客户端和 appium server 连接。需要在Desired Capabilities 里面填入一些参数。设定以下这些信息。 

• platformName: 平台名称设置为Android
• platformVersion:填写当前连接的Android设备的系统版本，必须正确
• deviceName: 填写Android设备名称，不需要正确
• app: 路径，从本地选择要测试应用的apk路径
• appPackage: 测试app的package
• appActivity: 测试app的StartActivity
• unicodeKeyboard: 布尔值 true则禁用手机键盘
• noReset: 布尔值true 则不重新安装apk，false则重新安装apk
• newCommandTimeout: 6000

设置后的效果如下： 

点击【Save SA】，设置一个名称保存一下方便下次使用。

1. 保存之后可以去 Saved Capability Sets (1) 里面查看。 

点击 StartSession 。这时候手机上会自动安装Appium Settings 应用（安装好不要卸载）

1. 接着又安装一个io.appium.uiautomator2.server 应用（每次启动都会提示安装一次）。

2. 然后手机上开始安装Desired Capabilities 中设置的apk 文件

3. 最后手机上启动安装成功的测试APP。

Inspector 功能

GUI

Inspector 启动成功后，界面如下 

Appium会话可能需要一些时间来加载，尤其是在云服务上，所以请耐心等待。

1. 当会话加载成功后，您的应用程序的屏幕截图（快照视图）将出现在左边。您可以在屏幕快照视图中使用鼠标来点击各种UI元素，将会看到它们突出显示。

2. Inspector窗口的中间是您的应用程序的层次结构，表示为XML。您可以通过单击它树节点，或者通过点击屏幕快照视图中的元素来导航这棵树。然后它们在视图中会被强调显示。在应用层次结构中会直接将元素的id也就是resource-id值标记在树上，这对于Appium定位元素很方便，可以快速看到元素是否有id。 

3. 当一个元素被突出显示时，它的信息会出现右侧的元素信息视图中。这个细节视图包括对元素的潜在操作，以及元素属性的表。这些属性将决定Appium定位元素的策略。

基本操作

刷新

当我们在手机上对APP进行操作后，Inspector窗口的屏幕截图不会自动更新，需要我们通过点击刷新按钮，更新应用的最新页面

操作回退

当我们想要查看返回上一个操作查看页面信息，可以通过点击back-按钮。此时Inspector窗口和手机都会同时回到上一个操作的界面。（等同于android手机上的返回键）

退出

当我们不再需要使用Inspector，就可以点击x关闭Inspector窗口(调用驱动程序)。退出并关闭Inspector

复制xml

如果我们需要保存应用当前界面的xml内容，可以点击COpy XML Source to Clipboard 将内容保存到粘贴板。

查看元素信息

当我们想要查看某一个元素的详细信息，首先需要点击select Elements 按钮，然后在屏幕截图中点击要查看的元素，最后在右侧的区域就可以看到元素的xpath，index，package,class,text,resource-id 等信息。

点击元素

选择一个元素后，还可以“点击”元素，当您使用一个元素执行Tap操作时，Inspector将发送命令到Appium，它将执行它。如果操作成功，左侧将生成一个新的屏幕截图，您将看到应用程序的更新状态和XML。如果不成功，您看到错误消息。

输入文本

选择一个元素后，还可以“发送内容”到元素(前提：它是一个输入框EditText)。同样Inspector将发送命令到Appium执行它

清空文本

选择一个元素后，还可以对元素“清空内容”(前提：它是一个输入框EditText)。同样Inspector将发送命令到Appium执行它

查找元素信息

如果我们想要通过元素的某一个属性值来查看它所对应的元素有哪些，可以点击search for element 按钮。 最常用的情况就是通过resource-id 或者 text 或者xpath 来判断属性值是否唯一对应一个元素。

步骤：

• 选择一个属性:id(resource-id),name(text),xpath,className(class)等
• 输入属性对应的值
• 点击Search

• 显示搜索结果

从上图可以看出id=com.zhihu.android:id/title的元素有三个。

Inspector窗口操作界面

点击 Tap By Coordinates按钮，我们就不需要在手机上点击操作，可以直接在屏幕截图上使用鼠标来点击元素，手机也会同步操作。 

滑动屏幕

如果想在Inspector窗口的屏幕截图中执行一个滑动屏幕的操作，使用鼠标无法完成，那么我们可以通过swipe by coordinates 按钮实现。 步骤

1. 先点击滑动的起始位置（会显示一个圆圈）
2. 在滑动结束的位置点击一下（会显示一个圆圈）
3. 这时候就开始执行滑动操作