# 快速上手

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

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

# 下载安装 WMPF Service apk

请到 GitHub 仓库上 clone WMPF Client 示例代码，并在此基础上进行自定义的 WMPF Client 二次开发。

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

将前面我们在接入流程中获得的 productId 、keyVersion 、deviceId 、signature 依此填入 GuideActivity.kt getDeviceInfo 方法中。

将前面我们在接入流程的「创建移动应用」步骤中获取的 HostAppID 和 AppSecret 填入 build.gradle 的 buildConfigField 中。

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

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

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

在安卓设备上运行之前下载的 WMPF Service apk ，通过 Android Studio 上的真机调试功能，编译运行 WMPF Client apk ，然后按下列动图中的步骤操作，你就可以打开小程序了。

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

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

WMPF 调用通道（Invoke Channel）

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

WMPF 专有接口（JSAPI）

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

消息推送能力

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

刷脸支付能力

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

分包加载和预加载

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

横屏优化

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

在 WMPF Client 示例代码中有两个 flavor ，flavor 可以在 Android Studio 中切换。