App Helper 是一款超好用的、直击痛点的 App 开发、调试工具，其面向基于 去哪儿客户端 进行 开发、调试、测试 的 技术人员，解决其在工作过程中入口配置、环境配置等痛点。

本使用说明，主要对 App Helper 工具的使用方式进行详细阐述和指导。

开始 #

App Helper 需要 PC 和 App 端配合使用。PC 端的入口在 UED 站点 中，App 端的入口在 Debug 工具 中。

具体操作可以查看下面的视频：

常用列表 #

使用者生成数字码和二维码后，都可以输入 要设置的名称 后，可以将这个 Scheme 保存至 常用列表，以便下次使用。

常用列表同样也支持 多端同步。

图示

基础协议配置 #

对于不同的 App，调用其 Scheme 时，使用的 Procotol 是不同的，使用者可以选择已有的去哪儿客户端的 Procotol，或者使用 开发者自定义 的方式，自定义 Procotol。

图示

对于开发者自定义，有一个小技巧，如果你的 App 在 iOS/Android 的协议分别是 qunariphoneSome/qunaraphoneSome , 那么可以在自定义输入框内，填入 schemeSome 即可，工具根据平台进行适配。

图示

详细配置 #

选择完基础协议配置后进行详细配置，主要分四类，分别是：

图示

  • 入口配置：可以快速配置 hy 和 qrn 的入口，并在 App 中打开。
  • 信息查询：可以快速查询 App 信息 和 离线包版本信息，并可以快速将相应信息传至 PC 页面中。
  • 环境配置：可以快速配置 App 的 Host 和 环境配置，并可在 App 间 快速同步。
  • 其他：包括 自定义 Scheme 和 执行代码。

入口配置 #

此功能可以快速配置 hy 和 qrn 的入口，并在 App 中打开。下面以 hy 为例进行说明。

a.操作说明 #

使用者可以通过 配置相应选项 构成 相应的 Scheme，用于 预览 或 使用 App 打开。

图示

点击 『显示 Scheme』，可以展示当前配置对应的 Scheme。

图示

点击 『生成数字码/二维码』，可以生成相应内容，供 App 端使用。 要注意的是，最长生效时间为 1 个小时。

图示

b.具体使用步骤 #

在 App 中输入相应数字码 或者 用 App 扫描二维码 即可打开相应的 Scheme。具体操作步骤如下：

c.保存到常用列表 #

使用者输入 要设置的名称 后，可以将这个 Scheme 保存至 常用列表。

信息查询 #

使用这可以通过这个功能，方便的查到 App 的信息 或者 离线包的版本信息。

a. App 信息查询 #

App 信息查询有两种方式：

  • 第一种是由 PC 端发起，用于 使用者主动查询 时。操作步骤如下：
  • 第二种是有 App 端主动发起，用于 使用者主动上报 时。操作步骤如下：

注：显示在 PC 端的 App 信息，均可以 点击复制，并可以点击按钮复制整个 JSON。

b.查询离线包版本号 #

在 PC 端输入 相应 Hybridid 即可查询相应的离线包版本号。

图示

图示

环境配置 #

环境配置功能可以快速配置 App 的 Host 和 环境配置，并可在 App 间 快速同步。

为了 Host，我们经历过 Fiddler / Charles 的洗礼，也熬过 智能 Wifi 的艰辛，这时常让我们认为遇到的是一个假 App。不过，现在真正的 App 已经敢于支持 Host，并勇于接受大家的狂风暴雨。

a.如何快速设置： #

需要注意的是，这个功能只能在 Dev/Beta 包里使用，不能在 线上 包里使用。

使用者再也不用在 App 狭小的屏幕中配置相关设置了，只需要在 PC 端配置好，通过 App Helper 就可以很快速的将配置同步设置到 App。具体操作步骤如下：

b.如何快速同步： #

世间最烦的事，莫过于配置 App 环境；比配置 App 环境更烦的事，莫过于给多个 App 配同样的环境。

因此，世间应该有一个 同步设置 的功能！

使用者可以通过 『查看客户端配置』 进入到 设置详情页，点击页面尾部的 『分享配置』 按钮，即可生成 数字码和二维码，其他 App 通过 输入数字码 或者 扫描二维码 的形式，就能 同步设置 此 App 分享的配置。具体操作步骤如下：

其他 #

a. 自定义 Scheme #

可以执行任意 Scheme，实例如下：

图示

b. 执行代码 #

可以在 Hytive WebView 中执行相应代码，实例如下：

图示

常见问题 #

  • 使用范围？—— 除环境配置外，其他功能没有限制，可用在 Online/Beta/Dev 包中。
  • 线上包工具入口？ —— 线上包没有 Debug 工具，所以没有 App Helper 的入口。可以手机浏览器中直接访问 https://ued.qunar.com/apphelper/ 进行使用。
  • 移动设备上 App Helper 的常用列表怎么存储？ —— 打开 存储模式。

最后祝您身体健康，万事如意，再也不烦 App 项目的开发调试。有什么问题和需求，都可以联系 林洋（@adwon.lin）或 刘超（@chaos.liu）。感谢您的关注！