# 真机预览

真机预览可以无需发布快速验证小程序的真机表现。

## 使用条件

### 环境配置

- 登录飞书开发者工具
- 需要移动端飞书版本 >= 3.12.0

### 项目配置

- 配置项目AppID（AppID获取访问 [开发者后台](https://open.larkoffice.com/app?lang=zh-CN)）

## 移动端

### 预览

#### 开始预览

- 从工具栏点击「**预览**」，选择移动端，使用飞书移动端扫码即可预览。
![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/17d424caef40a5f3a5b7057caf630d52_IDDncuE7AA.png?height=1956&lazyload=true&width=2220)

**注意：代码修改后需要点击「重新编译」，等待编译上传完成后，重新使用飞书移动端扫码预览。**

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/91444e7c320802bad8e5f92a0bb89901_kJE7DvdgdJ.png?height=1826&lazyload=true&width=2586)

### 实时预览

真机实时预览功能支持监听代码的修改，当代码发生修改并保存后，开发者工具会实时编译并将编译后的小程序推送给飞书移动端。**可以实现编写小程序时快速预览，免去了每次查看小程序效果时都要扫码的麻烦。**

#### 使用条件

- 真机实时预览功能依赖局域网通信，需要保证当前设备和手机在同一网络下。
- 飞书-鸿蒙版暂不支持「实时预览」功能。

#### 开始实时预览

开启实时预览的操作步骤：
- 点击工具栏中的「**预览**」。
- 勾选「**实时预览**」。
- 点击「**重新编译**」，等待编译上传完成。
- 使用飞书移动端扫描二维码。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/07e8e17d3fe8ca7845a1f6cc91e63751_O8Iq7I99Jz.png?height=1826&lazyload=true&width=2588)

**注意：开启移动端实时预览后，即使关闭小程序或重启飞书移动端，只要代码发生变化并保存，仍会推送给飞书移动端并唤起小程序。**

#### 结束实时预览

关闭实时预览的操作步骤：
- 点击工具栏中的「**预览**」。
- 取消勾选「**实时预览**」。
- 点击「**重新编译**」，等待编译上传完成。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/20b9ffb34276a3b6c5e34ef8a40f203d_CNHoFfxd2W.png?height=1826&lazyload=true&width=2586)

## PC端

### 预览

- 点击工具栏「**预览**」按钮。
- 选择「**PC端**」。
- 选择需要的运行模式并等待编译完成。
- 编译完成后「开发者小助手」会发送预览链接给在「飞书开发者工具」登录的账号，点击「预览」即可开始预览。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/1f2d43e3dbf6bfd8594e03c998de18a3_DlcE6wCtct.png?height=1826&lazyload=true&width=2580)
四种不同运行模式区别参考 [桌面端小程序的运行模式](https://open.larkoffice.com/document/client-docs/gadget/introduction/-pc-gadget#b11caf33) ，PC端「实时预览」暂不可用。

## 常见问题

1. ### 无效的AppID，请进入开发者后台/凭证与基础信息 复制AppID信息

**问题原因**：未配置AppID或者AppID无效。

**解决方案**：在[开发者后台](https://open.larkoffice.com/app?lang=zh-CN)获取AppID后，可以通过下面两种方式配置 ：
- 在 `project.config.json` 文件中配置
![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/d69a275a5ce7503c6f071a58dd2c43ab_0KoSxIE6gD.png?height=1134&lazyload=true&width=1128)
- 通过开发者工具的配置界面进行设置
![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/1b9a561e5cf3fc0b6a3868c0b1725e1d_HDh0ZoJgPW.png?height=1826&lazyload=true&width=2676)

2. ### 飞书移动端无操作情况下自动唤起小程序

**问题描述**：在开启实时预览功能后，即使没有主动操作，飞书移动端也可能自动唤起小程序。

**原因分析**：这是实时预览功能的正常行为。当代码发生变化并保存后，开发者工具会自动将更新推送到移动端并唤起小程序进行预览。

**解决方案**：如需避免此情况，请按照「**移动端**」-「**实时预览**」-「**结束实时预览**」步骤关闭实时预览功能，或者重启飞书开发者工具。