打开 uni-app
项目的页面,点 HBuilderX 右上角的预览按钮,可以在内置浏览器里打开 H5 运行结果,也可以点右键打开控制台调试。
修改保存工程源码时,右边的浏览器内容可以自动刷新。
在 HBuilderX 控制台里,可以直接看到内置浏览器打印的日志。
打开内置浏览器的控制台的 Sources
栏,可以给 js 打断点调试。
在 Page
下找到 webpack
里的工程目录,可直接找到对应的vue
页面进行断点调试;或按 Ctrl+P
搜文件名,进入页面调试;也可点击控制台的 log
信息,进入对应的页面进行调试。
点击工具栏的运行 -> 运行到浏览器 -> 选择 Chrome
,也可将 uni-app
运行到 浏览器,可参考 运行 uni-app。
uni-app
运行到微信 web 开发者工具等小程序开发工具里,可在这些工具的控制台查看 console
信息,网络请求等信息等。
页面样式调试和一般的web
项目一样,通过调试的箭头选中元素即可查看相应的节点和样式,如下图:
调试 js
时需要切换到 Sources
栏,根据 sourcemap,找到 webpack
里正确的目录,选中想要调试的那个页面的js
,进行调试(如果js
代码是压缩过的,点击右下角的{}可格式化代码),如下图:
常规开发里,在 HBuilderX 的运行菜单里运行 App,手机端的错误或 console.log 日志信息会直接打印到控制台。
如果需要更多功能,比如审查元素、打断点 debug,则需要启动调试模式。自 HBuilderX 2.0.3+
版本起开始支持 App
端的调试。
在 HBuilderX
中,正确运行项目: 运行 --> 运行到手机或模拟器 --> 选择设备
,项目启动后,在下方的控制台选择 debug
图标。
正确打开调试窗口后,显示如下:
根据上一步,启动完成debug
窗口后,可以看到Elements
。Elements
主要显示当前页面的组织结构,目前Elements
只支持nvue
。
console.log
是我们日常开发最常用的调试方法,HBuilderX
中当然也不能少。
App 端提供真机运行的console.log
日志输出,运行到真机或模拟器时,不用点debug
按钮,操作手机,会在HBuilderX
的控制台直接输出日志。
如果是比较复杂的逻辑,那就推荐使用调试工具中的console
了。根据上一步,启动完成debug
窗口后,执行console.log
方法就可以看到打印的内容了。
debug
窗口中看console.log
的方法如下图:
在调试窗口控制台的 Sources
(图中指示 1) 栏,可以给 js
打断点调试。
在 uniapp
(图中指示 2)下找到需要调试的页面,单击打开 ,在右侧可以看到我们需要调试的内容(图中指示 3)。在需要调试的代码行号的位置,点击打上断点(图中指示 4)。
之后,在设备上进行操作,进入断点位置,可以方便我们跟踪调试代码。
在控制台众多代码中寻找要调试的代码是比较麻烦的一件事,HBuilderX
的调试还提供一个便利的功能,可直接在编辑器中打断点,断点会自动同步到调试工具中。
操作步骤:在 HBuilderX 编辑器中对目标行的行号处点右键,在右键菜单中选择“同步断点到调试器”,然后调试控制台会自动打开对应的代码并在指定行处标记断点。演示如下:
Tip
vue
和 nvue
页面均支持断点调试nvue
页面审查元素,vue
页面暂不支持,以及 Android
平台的 nvue
审查元素暂不支持查看 style
console.log
日志输出,运行到真机或模拟器时,不用点debug
按钮,运行手机 App,会在HBuilderX
的控制台直接输出日志。App
的界面和常规 API,推荐编译到 H5 端,点HBuilderX
右上角的预览,在内置浏览器里调Dom
,保存后立即看到结果,调试更方便。并且 H5 端也支持titleNView
的各种复杂设置。唯一要注意的就是css
兼容性,使用太新的css
在pc
上预览可能正常,但低端Android
上异常,具体可查询caniuse
等网站。pc
上使用内置浏览器预览调 dom,运行到真机上看console.log
。如果是很复杂的问题才使用debug
。Dom
和网络和存储等调试工具相对而言更完善些。
注意:即使不发布微信小程序、只发布App
,也需要安装微信开发者工具。