# 快速体验(安卓)

通过使用快速体验包,接入方能够更快捷的体验在设备上通过 WMPF 运行指定小程序的效果,初步评估接入 WMPF 的实际效果和开发成本。

在体验完小程序运行在设备上的效果后,如果你想要真正接入 WMPF,请依次完成后续的接入步骤和开发工作。

# 1. 获取体验包

可以从下列两种方式中选择一种。

# 1.1 直接下载

操作方便,但更新可能较慢。更新时间 2023-11-29

下载地址:

使用说明:

  • 将 wmpf-demo.apk 和 WMPF Service Apk(根据设备选择 32/64 位版本)安装到设备中。
  • 启动并保证两个 apk 处于运行状态,其中 WMPF Demo apk 界面保持在前台。

# 1.2 从 WMPF Client Demo 代码编译

步骤略繁琐,及时更新

开发者可以从 GitHub 仓库上 clone WMPF Client 示例代码,并按下列步骤编译安装应用。

  • WMPF 发布页面下载最新的 WMPF Service Apk,例如 wmpf-arm64-alpha-release-v2.1.0-9010017-signed.apk,并安装到设备上。
  • 在 Android Studio 中导入运行示例代码的 wmpf-demo 目录,将 flavor 切换为 experience
  • 连接真机后,编译并运行项目,在设备上安装 WMPF Demo apk。
  • 启动并保证两个 apk 处于运行状态,其中 WMPF Demo apk 界面保持在前台。

# 2. 绑定小程序

在运行指定小程序前,需要先在「微信终端合作平台」绑定小程序的 appId。

# 2.1 获取小程序 appId

  • 在手机微信中启动小程序
  • 点击右上角「...」
  • 点击小程序名称,进入小程序信息页
  • 点击「更多资料」,查看小程序 appid

# 2.2 绑定并生成 ticket

在「微信终端合作平台」上输入小程序 appid,点击搜索按钮,生成 ticket(有效期 2 小时)。

# 3. 启动小程序

根据指引,将 appId 和 生成的 ticket 输入到设备上运行的 WMPF Demo apk 中,从而启动小程序。

# 注意:

  • 在正式开发中,需要绑定小程序之后才能在设备中运行小程序,为了使体验 Demo 获得运行小程序的权限,ticket 会作为小程序的临时启动凭证,过期需要重新获取 ticket。
  • ticket 仅供快速体验使用,因此不应该用于开发环境,更不能用于生产环境。
  • WMPF Demo apk 支持运行正式版、体验版和开发版小程序。
  • WMPF Demo apk 本质上是一种简易的 WMPF Client ,你可以在其基础上进行二次开发,低成本地验证 WMPF Client 的开发周期。