# 快速上手

在完成[接入流程](process)中的所有步骤后，就可以正式开始 WMPF Client 的代码开发。

> WMPF Client 是通过 Kotlin 编写，应该由熟悉安卓开发的同学进行项目开发

## 下载安装 WMPF Service apk

请到 [WMPF 发布页面](download)下载：

## WMPF Client 开发

请到 GitHub 仓库上 clone [WMPF Client 示例代码](https://github.com/wmpf/wmpf_demo_external)，并在此基础上进行自定义的 WMPF Client 二次开发。

### 1. 在 Android Studio 导入项目

在 Android Studio 中导入运行示例代码的 `wmpf-demo` 目录，将 flavor 切换为 `guide`。

### 2. 填入硬件信息

将前面我们在[接入流程](process)中获得的 `productId` 、`keyVersion` 、`deviceId` 、`signature` 依此填入 [GuideActivity.kt](https://github.com/wmpf/wmpf_demo_external/blob/master/wmpf-demo/app/src/guide/java/com/tencent/wmpf/demo/activity/GuideActivity.kt) `getDeviceInfo` 方法中。

### 3. 填入移动应用信息

将前面我们在接入流程的「[创建移动应用](bind-app)」步骤中获取的 HostAppID 和 AppSecret 填入 [build.gradle](https://github.com/wmpf/wmpf_demo_external/blob/master/wmpf-demo/app/build.gradle) 的 `buildConfigField` 中。

**注意：AppSecret 需要严格保密，不应流出服务端后台环境，更不应该放到客户端代码中。此处仅作为临时测试使用，相关能力需开发者后台封装接口提供给客户端调用，而不能在客户的直接调用微信提供的服务端接口。**

### 4. 集成 aar 文件

> wmpf-demo 已经集成了 wmpf-cli.aar，开发者可以按需更新。

在 Android Studio 中集成最新的 [wmpf-cli.aar](download) ，这样 WMPF Client 才能与 WMPF Service 进行交互通信。

### 5. 真机运行应用

在安卓设备上运行之前下载的 WMPF Service apk ，通过 Android Studio 上的[真机调试](https://developer.android.google.cn/training/basics/firstapp/running-app?hl=zh-cn)功能，编译运行 WMPF Client apk ，然后按下列动图中的步骤操作，你就可以打开小程序了。

![](https://res8.wxqcloud.qq.com.cn/wxdoc/d2ed599e-86ae-4572-b6fc-d22713d0d46c.gif)

### 6. IPC 交互协议

在成功编译运行 WMPF Client apk 后，WMPF 会依据之前提供的硬件注册信息进行设备实时激活，激活成功后才可正常使用。时序图见下方：

![](https://res8.wxqcloud.qq.com.cn/wxdoc/fb204b10-f45c-4347-a8dc-35c6e7babce0.png)

阅读 [Client 与 Service 的 IPC 交互协议](client-service)，了解 WMPF Client 如何与 WMPF Service 进行通信，并成功激活设备和 Launch 你自己的小程序。

### 7. 优化 WMPF

**WMPF 调用通道（Invoke Channel）**

若设备需要调用特殊的本地能力，而手机微信小程序并未定义相关接口，可通过该通道透传相关信息。具体请访问 [WMPF 调用通道文档](invoke-channel)。

**WMPF 专有接口（JSAPI）**

关于未在小程序中定义的特殊安卓接口，部分常用硬件（如[打印机](printer)、[设备 SN 码](device-sn)）可以通过 WMPF 专有接口来直接调用。

**消息推送能力**

小程序未在前台运行时，也可以通过服务器向 WMPF push 消息，开发者可自行定义 push 消息的样式；也可从消息中跳转到小程序或小程序内的指定页面。本能力适用于场景较丰富，同时使用的小程序较多的场景。具体请访问[消息推送能力文档](push)。

**刷脸支付能力**

我们可以在刷脸支付的设备上接入小程序，让设备更好地连接微信。具体请访问[刷脸支付能力文档](face-pay)。

**分包加载和预加载**

对于硬件性能较差，或网络状况较差的情况，可以通过分包加载来提升小程序启动时的流畅程度；也可启用预加载功能，小程序首次启动后部分数据将存储在本地，下次启动速度会明显优化。具体请访问 [Client 与 Service 的 IPC 交互协议文档](api/client/PreloadRuntime)，并查看 `PreloadRuntime` 参数。

**横屏优化**

如果你的设备屏幕方向为横向，但是需要使用手机上为竖屏设计的小程序，可以打开横屏强制居中显示。具体请访问 [Client 与 Service 的 IPC 交互协议文档](api/client/LaunchWxaApp)，并查看 `LaunchWxaApp` 参数。

## 注意

在 [WMPF Client 示例代码](https://github.com/wmpf/wmpf_demo_external)中有两个 flavor ，flavor 可以在 Android Studio 中切换。

* guide：在正式激活硬件后使用，可在此基础上做修改定制后正式上线使用
* experience：用于在不正式激活硬件的情况下体验 WMPF ，不能用于生产环境