# 快速体验（安卓）

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

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

## 1. 获取体验包

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

### 1.1 直接下载

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

下载地址：
  - wmpf-demo.apk: [下载](https://dldir1.qq.com/WechatWebDev/wmpf/wmpf-demo.apk)
  - WMPF Service APK: [下载 64 位](https://dldir1.qq.com/WechatWebDev/wmpf/wmpf-arm64-alpha-release-v2.1.0-9010017-signed.apk) / [下载 32 位](https://dldir1.qq.com/WechatWebDev/wmpf/wmpf-arm-alpha-release-v2.1.0-9010017-signed.apk)

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

### 1.2 从 WMPF Client Demo 代码编译

> 步骤略繁琐，及时更新

开发者可以从 GitHub 仓库上 clone [WMPF Client 示例代码](https://github.com/wmpf/wmpf_demo_external)，并按下列步骤编译安装应用。

- 在 [WMPF 发布页面](download)下载最新的 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

![](https://res8.wxqcloud.qq.com.cn/wxdoc/3c610a85-7038-4d91-b1fc-8ff31fcc832d.png)

### 2.2 绑定并生成 ticket

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

![](https://res8.wxqcloud.qq.com.cn/wxdoc/1cd5e20d-7956-46a3-984f-84bb18fd9d27.png)

## 3. 启动小程序

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

## 注意：

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