网硕互联帮助中心【免费下载链接】appium-inspector
A GUI inspector for mobile apps and more, powered by a (separately installed) Appium server
项目地址：
https://gitcode.com/gh_mirrors/ap/appium-inspector
点击查看 免费下载
Appium Inspector 的 Session Builder（会话构建器）界面顶部，专门用于配置服务器连接详情（Server Details），它决定了 Inspector 将以何种地址、何种协议连接到目标 Appium 服务器。本文以 docs/session-builder/server-details.md 为骨架，结合仓库源码深入讲解默认连接字段、20 余家云测试服务商接入方式以及高级网络设置，帮助你快速搭建可用的自动化测试会话。
一、Server Details 在 Session Builder 中的位置与作用
打开 Appium Inspector 后，Session Builder 界面的最上方就是服务器详情区域。它解决的核心问题是：Inspector 应该连接到哪里去建立会话。
默认情况下，选中的是 Appium Server 标签页，用于连接独立运行的本地或远程 Appium 服务器；同时，Inspector 也支持连接由云测试服务商提供的服务器（详见下文"云服务提供商"小节）。该标签页的切换与字段渲染逻辑由 ServerDetails 组件目录 下的各 ServerTab*.jsx 文件实现，每个云厂商对应一个独立的标签页组件。
二、默认服务器详情字段：四个参数即可建立连接
默认的 Appium Server 标签页包含 4 个字段，对应的 UI 实现位于 ServerTabCustom.jsx：
| Remote Host | 服务器主机地址 | 127.0.0.1 |
| Remote Port | 服务器监听端口 | 4723 |
| Remote Path | 访问服务器的基础路径 | / |
| SSL | 连接时是否使用 HTTPS | false |
这些默认值并非写死在组件里，而是统一定义在 webdriver.js 常量文件 的 DEFAULT_SERVER_PROPS 中：
export const DEFAULT_SERVER_PROPS = {
protocol: 'http',
hostname: '127.0.0.1',
port: 4723,
path: '/',
logLevel: process.env.NODE_ENV === 'development' ? 'info' : 'warn',
};
可以看到协议默认是 http，端口 4723 正是 Appium 服务器的标准监听端口。因此，如果保持占位默认值不变，Inspector 将尝试连接 http://127.0.0.1:4723/。
实战提示：如果你本地的 Appium 服务器是用默认参数启动的（appium 命令不带任何参数），它默认就监听 127.0.0.1:4723，与你填写的占位地址完全一致——此时直接点击 Start Session 即可，四个字段无需任何修改。
连接参数的底层流向
从源码看，这四个字段最终会被合并进 WebDriver 客户端配置。在 session-starter.js 中：
static async newSession(serverOpts, capabilities = {}) {
const safeServerOpts = {…DEFAULT_SERVER_PROPS, …serverOpts, capabilities};
const sessionClient = await webdriver.newSession(safeServerOpts);
return new WDSessionDriver(sessionClient);
}
即用户填写的 serverOpts（hostname、port、path、ssl 等）会与 DEFAULT_SERVER_PROPS 合并，再传给 webdriver.newSession() 发起真实的 WebDriver 请求。这意味着：
- Remote Path 用于拼接请求 URL 的基础路径。如果服务器设置了自定义路径（例如通过 Appium 的 –base-path 或代理服务器转发），需要在这里同步修改，否则会出现路由不匹配而无法建会话；
- SSL 勾选后，请求协议将从 http 切换为 https。典型场景是连接远程 Appium 服务器或云厂商的 WebDriver 端点。
三、云服务提供商：一键接入云端真机/模拟器
点击 Select Cloud Providers 按钮，会弹出一个包含多家云测试服务商的选取窗口，选中后即可在 Appium Server 标签旁新增对应厂商的标签页。
支持的服务商清单
从 CloudProviders.jsx 的注册表中可以看到，当前版本内置了 20 家云服务商（对应 session-builder.js 常量 中的 SERVER_TYPES）：
AstroFarm、BitBar、BrowserStack、Experitest、Fireflink Device Farm、HeadSpin、Kobiton、Mobitru、PCloudy、Perfecto、RabbitQA、RemoteTestKit、RobotActions、RobotQA、Sauce、Testcribe、TestingBot、TestMu AI、TVLabs、Webmate。
每个厂商在选取窗口中都以 Logo 卡片展示，并同时提供亮色/暗色两套 Logo（部分厂商只有一套），由 use-theme 钩子根据当前主题自动切换，见 CloudProviders.jsx。已选中的厂商卡片会显示蓝色边框，再次点击可取消选择。
不同厂商的字段差异
切换到某个厂商的标签页后，可用字段会随之改变——不同厂商要求的凭据与端点完全不同。例如 TestMu AI 只需要 username 和 access key 两项：
从各 ServerTab*.jsx 的实现中可以归纳出几类典型的字段设计：
1. 用户名 + Access Key 型（如 Sauce、BrowserStack、TestMu AI）
- Sauce 与 BrowserStack 的输入框占位符会智能提示：如果检测到环境变量（如 SAUCE_USERNAME、SAUCE_ACCESS_KEY、BROWSERSTACK_USERNAME、BROWSERSTACK_ACCESS_KEY、LAMBDATEST_USERNAME、LAMBDATEST_ACCESS_KEY），占位符会显示"using data found in 环境变量名"，否则显示"your username / your access key"，引导用户填写，见 ServerTabSauce.jsx 与 ServerTabTestMuAI.jsx；
- Sauce 还额外提供 Data Center 数据中心选择（us-west-1、us-east-4、eu-central-1）以及 Proxy Through SC（Sauce Connect）选项，启用后可指定本地代理的 host（默认 localhost）与端口（默认 4445）。
2. 自定义端点 URL 型（如 HeadSpin、Experitest、AstroFarm、Perfecto） 这类厂商要求直接填入 WebDriver 端点，PROVIDER_VALUES 常量 中预置了参考占位格式，例如：
- HeadSpin：https://xxxx.headspin.io:4723/v0/your-api-token/wd/hub
- Experitest：https://example.experitest.com + accessKey
- AstroFarm：https://astrofarm-domain/d/appium/your-authentication-token
- Perfecto：cloud.Perfectomobile.com
3. 用户名 + 主机 + Access Key 型（如 PCloudy） PCloudy 需要同时提供用户名（占位 username@pcloudy.com）、主机（占位 cloud.pcloudy.com）和 access key。
4. API Key 型（如 Testcribe、RabbitQA） 直接填写服务商发放的 API Key（占位 your-api-key）。
这些占位值仅用于提示输入格式，实际连接时必须替换为你自己的真实凭据与端点。
四、高级设置（Advanced Settings）：代理与证书
点击 Advanced Settings 折叠面板，可对服务器连接做进一步网络配置，其实现位于 AdvancedServerParams.jsx：
高级设置包含三个参数（见 SERVER_ADVANCED_PARAMS 常量）：
| Allow Unauthorized Certs | 允许连接使用未授权/自签名证书的服务器（跳过证书校验） | 勾选即可，适合企业内部证书或测试环境 |
| Use Proxy | 启用代理访问 Appium 服务器 | 勾选后下方的 Proxy URL 输入框变为可编辑 |
| Proxy URL | 代理服务器地址 | 仅在 Use Proxy 勾选时生效，例如 http://127.0.0.1:8888 |
源码中的两个细节值得注意：
五、常见问题与排查思路
六、小结
Server Details 是 Appium Inspector 会话构建的第一步：四个默认字段即可对接本地或远程 Appium 服务器；20 家云服务商标签页把各家差异化的端点与凭据输入封装为统一交互；Advanced Settings 则覆盖了代理与证书等企业网络场景。结合 ServerDetails 组件目录 与 session-starter.js 的源码实现，你可以清晰地理解每个输入项最终如何被拼装为一次真实的 WebDriver 会话请求，从而更高效地排查连接类问题。
赞
【免费下载链接】appium-inspector
A GUI inspector for mobile apps and more, powered by a (separately installed) Appium server
项目地址：
https://gitcode.com/gh_mirrors/ap/appium-inspector
点击查看 免费下载
相关推荐
GoBackup Web UI 使用教程：可视化管理和监控备份状态
BlenderGIS地理空间数据三维建模完全攻略
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
评论前必须登录！
注册