【真机测试】Appium Inspector的零基础安装和参数配置

---

前言

随着移动应用的快速发展，确保应用在不同设备和环境下的稳定性和兼容性变得至关重要。Appium作为一款开源的自动化测试工具，支持跨平台（iOS和Android）的移动应用测试，为开发者提供了高效的真机测试解决方案。

---

以下操作的前提是在Appium已安装完成并搭建好所需环境下进行：

一、安装Appium Inspector

Appium Inspector是一个独立的工具，用于检查和调试移动应用的UI元素。虽然Appium本身提供了自动化测试能力，但Inspector在可视化元素定位和交互式调试等不可或缺。

1、Appium Inspector下载

网站下载：https://github.com/appium/appium-inspector/releases
下载对应系统的包。

下载时提示不安全，选择仍要保留

2、Appium Inspector安装

1、仅为我安装

2、安装完成后，运行Appium Inspector

3、页面打开后显示如图，安装成功。

二、设置Appium Inspector

1、设置remote参数

• Remote Path 填写 /wd/hub。这是 Appium 服务器的默认端点路径，用于处理 WebDriver 协议的请求。
• Host 填写 127.0.0.1 或 localhost。如果 Appium服务器运行在本地机器上，使用此地址。若服务器部署在远程机器，需填写对应的 IP 地址或域名。
• Port 默认端口为 4723。这是 Appium 服务器的标准端口，若启动时未指定其他端口，则保持默认值。若自定义了端口（如通过–port 参数启动），需填写实际使用的端口号。
  

2、填写capability

参考文档：Appium自动化测试（九）Capability介绍及配置

以连接安卓手机，百度APP为例填写下列参数：

1、platformName
平台名称：填写手机当前的系统是Android还是iOS

2、appium:deviceName
设备名称：当前连接的手机的设备ID，通过adb devices查看

3、appium:platformVersion
系统版本：填写当前系统的版本，在手机系统中查看。例如Android15，此处填15。

4、appium:appPackage
app的包名：使用命令 adb shell dumpsys window | findstr “mCurrentFocus”

因此，百度的包名为com.baidu.searchbox

5、appium:appActivity
app当前的活动窗口：同上命令 adb shell dumpsys window | findstr “mCurrentFocus”

因此，百度首页的活动窗口为com.baidu.searchbox.MainActivity。此处我们一般只填.MainActivity（这里有个点不要忘记啦）

6、appium:automationName
指定测试框架使用的自动化引擎：这个不是必填项，不填写 时，Appium 会尝试自动选择默认引擎（可能不准确）。
当前设备为Android15，因此推荐填写 UiAutomator2 。

7、appium:noReset
控制测试过程中是否重置应用状态：默认值: false，当设置为 true 时，Appium 不会在会话开始前重置应用状态。

8、appium:dontStopAppOnReset
控制测试会话开始时是否重置应用状态：设置为 true：Appium 不会停止当前运行的应用，而是直接附加到现有会话或重新连接。

与 noReset 的区别：
noReset：避免清除应用数据（如缓存、SharedPreferences）。
dontStopAppOnReset：仅控制是否停止应用进程，不涉及数据清理。

最终填写效果如下：

3、启动session

1、打开Appium，启动服务。

2、确定服务开启后，再去Appium Inspector中开启session

3、成功开启后会控制手机自动打开百度app，最后展示当前页面的所有元素

4、查看元素

点击页面任意位置，右侧会展示相应的参数。

---

总结

以上就是本文要讲的全部内容。详细介绍了如何安装Appium Inspector及其相关配置，并以连接安卓手机使用百度APP为例，讲解了如何开启Appium服务查看当前页面。