真机调试

了解通过扫码和 USB 两种方式来调试快应用

通过本节你将学会：

• 调试前准备
• 扫码调试快应用
• USB 调试快应用

调试前准备

安装调试器和预览版

若未安装调试器和预览版，需要先安装调试器和预览版，点击菜单「工具」「更新手机环境」，IDE 会自动安装调试器和预览版。

注意：

• 确保手机连上电脑，可通过模拟器上方的手机按钮是否为绿色判断。
• 需要在手机上打开 USB 调试权限，并在手机上确认安装。

日志输出准备

1. 修改日志等级

打开工程根目录下的 src 文件夹的 manifest.json，找到 config 配置，将 logLevel 修改为最低级别 debug，即：允许所有级别的日志输出

修改后 <ProjectName>/src/manifest.json 中 config 配置代码如下：

{
  "config": {
    "logLevel": "debug"
  }
}

1. 在 js 中输出日志

当 js 代码未按需求正确运行，输出日志能帮助开发者快速定位问题；与传统前端开发一致，使用 console 对象输出日志，如下：

console.debug('debug')
console.log('log')
console.info('info')
console.warn('warn')
console.error('error')

1. 查看日志

开发者可以通过 IDE 弹出的 调试器开发者工具 进行日志的查看。

扫码调试

扫码调试需要手机和电脑在同一局域网内，在手机环境安装好之后，可以通过扫二维码调试应用

在手机调试器中关闭开启 USB 调试功能

此时在 开启 usb 调试 下面会出现 扫码安装 功能，如上图所示。

点击开发工具右上角的显示二维码按钮并进行扫码

扫码成功后，此时手机与开发工具将建立连接，手机调试器将自动打开安装的 rpk 效果。

扫码安装成功后，在手机调试器右下角可以选择 “开始调试” 进行调试

注意：

• 手机调试器扫过一次二维码后将和开发工具建立连接，之后只需要使用「开始调试」进行调试。

USB 调试快应用

USB 调试可以调试安装至手机的 rpk，无需手机和电脑在同一局域网内。

开启 USB 调试

准备一台安卓手机, 在 设置 里进入 开发者选项 页面，打开 USB 调试开关。如下图所示：

如果 设置 中没找到 开发者选项 一栏，可尝试进入 关于手机 页面，多次点击 软件版本号 直到提示已打开开发者模式为止。

开始调试

• 点击工具栏的「USB 调试」（或者快捷键 F5 ），即可执行 USB 调试，如下图所示：

  

• 每次运行调试时，开发者工具会检测您的手机是否安装了【快应用预览版】【快应用调试器】。如果未安装，开发者工具将自动安装。

• 快应用预览版首次打开会提示用户授理存储权限，同样调试器在运行过程中也会提示授理存储权限，为了确保正常开启调试请点击允许。如下图所示：

  

• 以上授权成功后，需要重新运行调试才能进入正常的调试流程。

调试预览：

调试运行成功后，电脑端会打开调试页面。如下图所示