# 调试 WMPF 小程序

开发者可以先使用「WMPF Mock 插件」完成 WMPF 小程序的开发。即可以不用关心 WMPF Client 端的实现，在开发者工具上调用或者自定义 Mock WMPF 相关的 JS API 。

在完成 WMPF 小程序开发后，如果需要让小程序运行到真正的设备上，可以在开发者工具上通过扫描二维码进行调试。

## WMPF Mock 插件

### 安装插件

开发者可以在微信开发者工具的「设置」- 「扩展设置」-「模拟器插件」中找到 WMPF Mock 插件进行安装。

安装插件成功后，重启微信开发者工具，选择「硬件框架小程序模式」，接下来就可以在工具上调用 WMPF 相关的所有 JS API 。

![image-20211118194940083](https://res8.wxqcloud.qq.com.cn/wxdoc/30aa16be-9ccc-4d60-abd0-751be4757ee3.png)

### WMPF Mock 面板

开发者还可以通过 WMPF Mock 面板自己填写相关接口的**参数、返回数据**，从而模拟 API 的调用结果。

#### 使用方法

首先按照下图步骤打开 WMPF Mock 面板。

![image-20211118200121118](https://res8.wxqcloud.qq.com.cn/wxdoc/149f12c8-286f-4401-9c63-cdac45559e2c.png)

然后启用 WMPF Mock 能力并点击「+」新建规则。

![image-20211118200745842](https://res8.wxqcloud.qq.com.cn/wxdoc/df5a1e6f-ed18-46cc-8845-7d68eb94c6ce.png)

规则示例如下：

![image-20211118203014609](https://res8.wxqcloud.qq.com.cn/wxdoc/57aafab1-601e-4956-af26-682c8b873dbd.png)

运行如下代码：

```js
wmpf.wxFacePay.facePay({
  success(res) {
    console.log(res)
  }
})
```

将命中上述规则，并返回数据如下：

![image-20211118203403940](https://res8.wxqcloud.qq.com.cn/wxdoc/534002df-d64d-4e27-b514-4dd94dbaeb86.png)

##### 规则导入导出

当需要与项目中其他成员共享规则时，可以在 Mock 中导出规则配置，再把配置文件发送给其他成员导入即可，操作入口如图：

![image-20211118203629305](https://res8.wxqcloud.qq.com.cn/wxdoc/e5dc5fdc-6964-4de2-b6d5-4a9bb0f92d4a.png)

#### 注意

* 只有安装了「WMPF Mock 插件」并且切换到「硬件框架小程序模式」后，才能在开发者工具上调用 `wmpf.xxx` 相关接口。
* 如果一个 API 配置了多个规则，**靠前的规则，会优先匹配**。当一条规则被命中，后面的规则将不会再执行。
* API 为监听回调事件时，不用填 callback ，如有其他参数，仍以 JSON 格式填写。
* 如果模拟的 API 没有参数或者返回数据，应该填写 `{}` 空对象。
* 目前支持自定义 Mock 的 API 列表：
  * wmpf.Channel.invoke
  * wmpf.Channel.on
  * wmpf.wxFacePay.getFaceCode
  * wmpf.wxFacePay.facePay
  * wmpf.getWmpfPushToken
  * wmpf.getDeviceSerialNumber
  * wmpf.printer

## 真机调试

在微信开发者工具上，WMPF 支持「二维码预览小程序」与「二维码真机调试小程序」功能。

对于有摄像头的安卓设备，在 WMPF Client 端调用 [`IPCInvokerTask_LaunchWxaAppByQrCode`](api/client/LaunchWxaAppByQrCode) 或者 [`LaunchWxaAppByScanInvoker.launchWxaByScanUI`](api/client/LaunchWxaAppByQrCode) 接口即可进行开发调试。