# uts iOS调试

uts在iOS上的调试HBuilderX版本支持如下

uni-app (x) 的uts插件调试(iOS17以下)需 HBuilderX 3.7.6+

uni-app x 的jscore调试 HBuilderX 4.31+

uni-app (x) 的uts插件调试(iOS17以上)需 HBuilderX 4.81+

# uni-app (x) uts插件调试

# 功能入口

运行uni-app项目运行到iOS,项目包含uts插件,运行成功后,HBuilder控制台点击红色虫子图标,下拉菜单选择【开启uts调试(swift)】,即可开启uts调试(swift)功能。

# 注意事项

  • 自定义基座首次使用【开启uts调试(swift)】,需要重新编译动态库,当遇到下面的确认弹窗时,请点击【确定】按钮。

  • 点击【开启uts调试(swift)】,uts调试(swift)显示连接成功后可能需要等待十几秒后方可使用。

  • 调试进程codelldb会占用较大的内存。

  • 调试模式下,uts插件修改导致后重装App可能安装失败。

  • 基座重装后如果需要再次调试需重新开启uts调试(swift)

# uni-app x jscore调试

uts调试功能,需 HBuilderX 4.31+

# 功能入口

运行uni-app x项目运行到iOS,如果项目包含uts插件,运行成功后,HBuilder控制台点击红色虫子图标,下拉菜单选择【开启uts调试(jscore)】,即可开启uts调试(jscore)功能。

# 注意事项

  • uts 调试需要手机在 “设置” > “Safari” > “高级” > “Web检查器” 设置为打开
  • uts调试(jscore)服务开启成功后,修改编译为jscore的代码,热更新后会自动重连调试。不需要调试需手动关闭调试服务。

# 添加/删除断点

打开要调试的uts文件,在代码行号上,鼠标右击或双击添加断点。

# 调试视图

开启调试后,即可在HBuilderX左侧视图,看到调试视图,具体如下:

调试视图分为5部分:

  • 调试工具栏
  • 变量窗口 (复制值复制表达式添加到监视)
  • 监视窗口(包含添加/编辑/删除表达式,以及复制值
  • 调用堆栈窗口
  • 断点窗口(包含删除/启用/禁用断点)

# 调试操作

  • 继续 F8
  • 下一步 F10
  • 进入 F11
  • 返回 Shift+F11

# 数据检查和查看变量

# 添加到监视

在【变量窗口】,选中变量,右键菜单,即可将变量添加到监视窗口。

# 悬停显示

断点调试过程中,将鼠标悬停在要查看的变量上,即可打开悬停窗口。

# 注意事项

  • 开启uts调试(swift)和开启uts调试(jscore),依赖uts调试插件,弹窗提示安装依赖插件,请务必点击安装,否则无法进行调试。

# 故障排查指南