[Unity] ILoader该怎么写? ILoader.ReadFile返回的debugpath有什么用? 为什么无法断点(Unbound breakpoint)?

[throw-out]

ILoader区分环境分别实现

• Editor环境

  • 可以直接使用System.IO.File读取js脚本, 在开发阶段非常方便

• Unity打包

  • 打包后只能读取Resources StreamingAssets下的资源(而且是只读的), 为了达到更新丶替换js脚本的目的, 我们一般不会将脚本资源直接放在Resources/StreamingAssets下.
  • js脚本也是普通的文本丶二进制资源, 我们可以从网络 Application.persistentDataPath 本地压缩文件等途径获取它, 因此ILoader实例可以先读取这些文件来创建缓存(例如: Dictionary<string, string>), 之后Puerts.JsEnv实例再从缓存中读取

• 实例

  • 注: 建议使用DefaultLoader来加载内置js脚本(Puerts.JsEnv在创建实例时需要加载内置js脚本).
    随着版本迭代puerts可能更改内置脚本格式/扩展名, 而DefaultLoader是随版本修改和内置脚本兼容的, 我们使用DefaultLoader加载内置js脚本就可以随意切换版本而无需额外修改代码

    var loader = new PackageLoader();
    loader.AddLoader(new Puerts.DefaultLoader(), int.MaxValue);
#if UNITY_EDITY
    loader.AddLoader(new CustomEditorLoader());
#else
    loader.AddLoader(new CustomLoader1());
    loader.AddLoader(new CustomLoader2());
#endif
    ...

查看PackageLoader示例

debugpath应该怎么处理

quickjs环境不支持调试, 仅v8/nodejs环境支持调试.

• debugpath参数需返回js源文件的绝对路径, 这样js engine才能理解模块的结构, 后续Debugger才能正常命中断点.

  • 使用vscode调试时, debugpath返回值中不能包含相对路径写法(字符串/../和/./), 可使用System.IO.Path.GetFullPath处理成绝对路径. Windows平台上需要使用字符串\替换/

• 在ILoader中无需处理文件匹配/文件搜索, js engine本身会进行模块解析, 我们直接拼接字符串再检查文件状态即可.
  (如果我们自行去处理文件匹配/文件搜索, 可能与js engine本身的模块解析逻辑冲突, 从而导致js脚本多次加载以及更严重的原型链错乱问题)

  • 如果你想使用source-map-support且js文件移动过位置, 那么debugpath应该返回原始的js文件位置, 这样source-map-support才能正确读取sourceMap信息以及映射ts文件位置
  • 修改文件扩展名也可看成移动位置

• 调试:
  如仍未能正常调试, 可参考Puerts Inspector指南（一）在UE4和Unity里调试Javascript一文使用chrome内核浏览器连接调试查看源代码 - 页面 - file://界面, 检查已加载的js脚本结构是否与工程项目一致

  • chrome调试: devtools://devtools/bundled/inspector.html?v8only=true&ws=127.0.0.1:8080
  • debugger代码强断: 在需要断点的地方写下debugger;语句, 当代码执行到此位置时调试器将强制进入断点模式

• 示例:

  • 这是一个ILoader示例(UNITY_EDITOR), 它可以加载typescript编译目录dist/*和npm安装目录node_modules/*下的脚本:

查看示例

示例工程结构