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 即可,工具根据平台进行适配。

图示

详细配置 #

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

图示

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

入口配置 #

此功能可以快速配置 hyqrn 的入口,并在 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)。感谢您的关注!