真机调试

使用开发者工具对真机上的小程序页面进行真机调试，帮助开发者快速调试、定位问题。为方便在真实的移动设备上对百度 APP 客户端中的智能小程序进行调试，我们从开发者工具 3.26.0 版本，提供了新版的真机调试功能，支持 Android 系统 和 iOS 系统（百度 APP v12.9 及以上）。

前提条件

  1. 百度 APP 登录的账号，要是当前小程序 appid 的开发者；
  2. iOS 系统手机，百度 APP 客户端版本要 v12.9 及以上，v12.9 以下建议使用远程调试；
  3. 安卓系统手机，请按照百度 APP 版本号选择真机调试；
  4. 开发者工具和百度 APP 客户端在同一局域网内。

调试步骤

新版真机调试

整体流程：手机上扫描二维码后，会在手机上调起当前小程序，电脑上自动打开真机调试窗口；

  1. 打开开发者工具，单击工具栏上的『真机调试』按钮。
  2. 选择客户端 APP 对应的版本号（v12.9 及以上支持安卓和 iOS，v12.9 以下仅支持安卓）
  3. 等待生成调试二维码。

真机调试 - 图1

  1. 用百度 APP 扫描二维码。

    在扫码前，需要保证：
    1.杀掉当前手机上调试小程序的进程，注意是杀掉小程序进程，而不是点击小程序界面右上角按钮置于后台；
    2.关闭电脑上真机调试窗口。

  2. 二次打开真机调试：当再次编辑代码保存后，会生成新的真机调试二维码。进行真机调试前，需要杀掉手机上调试小程序进程和电脑上关闭真机调试窗口，然后重复上面步骤即可。

常见问题

Q：无线模式下，扫码失败，无响应。

A：操作步骤：

  1. 请保证手机和电脑在同一局域网；
  2. 安卓手机，百度 APP 版本 >= 11.10 ；
  3. 保证手机上调试小程序进程和 PC 上真机调试窗口都处于关闭状态下，扫描二维码进入调试；
  4. 上面前置条件都满足情况下，再扫码，如果还是未响应，请点击二维码上面的“刷新二维码”按钮。

Q：再次编辑后，如何真机调试？

A：由于真机调试现在不支持刷新功能，需要手动杀掉手机上调试小程序进程和 PC 上调试窗口的关闭。然后再重复首次流程，即扫码调试。

Q：真机调试的页面与预览不一致的问题。

A：真机调试的渲染页面分为两个，手机上的页面和电脑上的镜像页面，都是真机调试的页面，以手机上渲染的页面为准。因为电脑的镜像页面，没办法渲染 Native 的组件，如底部的 Tabbar、map 等组件。建议电脑上的镜像页面，仅仅作为调试页面结构和 CSS 使用。

Q：iOS 如何真机上调试？

A：iOS 百度 APP 版本在 v12.9及以上的可以使用新版的真机调试，APP 版本低于 v12.9 的暂时不支持真机调试，建议使用远程调试。

Q：其他真机调试相关问题或者建议。

A：真机调试相关的问题，可以联系客服微信：wx2swan-helper，验证信息 真机调试。