Folders and files
本工具用于重写Unity引擎的二进制文件，在没有源码的情况下，可以用它实现一些功能、修复一些问题
- 引用包com.modx.enginebinaryfilerewriter，参考格式：https://github.com/AlanLiu90/UnityBinaryFileRewriter.git?path=src/UnityBinaryFileRewriter/Packages/com.modx.enginebinaryfilerewriter#v0.7.0
- 在 Project Settings -> Engine Binary File Rewriter 中进行配置。配置方式可参考文章
支持Unity 2019~2022
- Android
- 只支持ARMv7、ARM64
- 支持直接构建apk/aab，也支持先导出Gradle工程，再构建apk/aab
- iOS
- 只支持在设备上运行的版本，不支持模拟器版本
- 支持在Windows、Mac和Linux上导出Xcode工程
- 2019只支持在Mac上导出
项目可以将ProjectSettings\EngineBinaryFileRewriterSettings.asset拷贝到自己的工程中，并启用需要的功能
在项目中使用前，请运行本工程的单元测试（Window -> General -> Test Runner）验证配置是否能在项目使用的Unity版本中生效
HybridCLR要求AssetBundle开启TypeTree或者禁用AssetBundle的兼容性检查，但Unity只对异步加载提供了接口禁用（文档）：
AssetBundleCreateRequest req = AssetBundle.LoadFromFileAsync(path);
req.SetEnableCompatibilityChecks(false); // 需要通过反射调用，并且存在线程竞争问题，有概率不起效本工具可以全局禁用掉AssetBundle的兼容性检查，从而让使用HybridCLR的项目可以关闭TypeTree
工程中包含了Android、iOS的开发版本和发布版本的配置。已测试版本：
- 2022.3.60f1
- 2021.3.45f1
- 2020.3.48f1
- 2019.4.40f1
- 打开工程：demo\HybridCLRTrial
- 执行菜单项Build -> Android
- 使用Android Studio打开Gradle工程，构建并安装到设备上。运行时可以看到一条日志：[InstantiateByAsset] text:..., 这个脚本通过挂载到资源的方式实例化
- 修改Assets\HotUpdate\InstantiateByAsset.cs，注释第一行代码
- 执行菜单项Build -> Android_Assets
- 在Android Studio中，重新构建、安装。运行时可以看到新的日志：[InstantiateByAsset] text:..., 这个脚本通过挂载到资源的方式实例化, count: 0
卡死时的调用栈示例（有其他的可能性，主要看是否是卡在AsyncResourceUploadBlocking里）：
#1 0x0000000190f53370 in _dispatch_sema4_wait () #2 0x0000000190f53a20 in _dispatch_semaphore_wait_slow () #3 0x000000011bceda44 in DarwinApi::detail::Acquire(UnityClassic::Baselib_SystemSemaphore_Handle, unsigned long long) [inlined] at /Users/bokken/build/output/unity/unity/External/baselib/builds/Source/Darwin/Baselib_SystemSemaphore_DarwinApi.inl.h:36 #4 0x000000011bceda38 in DarwinApi::Baselib_SystemSemaphore_Acquire(UnityClassic::Baselib_SystemSemaphore_Handle) [inlined] at /Users/bokken/build/output/unity/unity/External/baselib/builds/Source/Darwin/Baselib_SystemSemaphore_DarwinApi.inl.h:62 #5 0x000000011bceda38 in UnityClassic::Baselib_SystemSemaphore_Acquire(UnityClassic::Baselib_SystemSemaphore_Handle) at /Users/bokken/build/output/unity/unity/External/baselib/builds/Source/CProxy/Baselib_SystemSemaphore_CProxy.inl.h:19 #6 0x000000011b05c7bc in Baselib_CappedSemaphore_Acquire [inlined] at /Users/bokken/build/output/unity/unity/External/baselib/builds/Include/C/Internal/Baselib_CappedSemaphore_SemaphoreBased.inl.h:44 #7 0x000000011b05c7b4 in ::WaitForSignal() at /Users/bokken/build/output/unity/unity/Runtime/Threads/CappedSemaphore.h:29 #8 0x000000011b05c674 in ::AsyncResourceUploadBlocking() at /Users/bokken/build/output/unity/unity/Runtime/Graphics/AsyncUploadManager.cpp:524 #9 0x000000011b9312e0 in ::SyncAsyncResourceUpload() at /Users/bokken/build/output/unity/unity/Runtime/GfxDevice/GfxDevice.cpp:2320 #10 0x000000011bac2a44 in ::RunCommand() at /Users/bokken/build/output/unity/unity/Runtime/GfxDevice/threaded/GfxDeviceWorker.cpp:2521 #11 0x000000011bb6cc34 in GfxDeviceWorkerAutoreleasePoolProxy at /Users/bokken/build/output/unity/unity/Runtime/GfxDevice/metal/GfxDeviceMetal.mm:5876 #12 0x000000011babda08 in ::RunExt() at /Users/bokken/build/output/unity/unity/Runtime/GfxDevice/threaded/GfxDeviceWorker.cpp:375 #13 0x000000011babd928 in ::Run() at /Users/bokken/build/output/unity/unity/Runtime/GfxDevice/threaded/GfxDeviceWorker.cpp:353 #14 0x000000011babd5f0 in ::RunGfxDeviceWorker() at /Users/bokken/build/output/unity/unity/Runtime/GfxDevice/threaded/GfxDeviceWorker.cpp:332 #15 0x000000011b22562c in ::RunThreadWrapper() at /Users/bokken/build/output/unity/unity/Runtime/Threads/Thread.cpp:112 #16 0x00000001e5afe06c in _pthread_start ()
本工具通过调整信号量类中一个函数的指令规避这个问题，但是有性能损失
- 按照目前使用的项目的反馈，能确定可以大幅减少发生的概率，但不确定是否能完全避免
- Unity在6中修复了这个问题
工程中包含了Android、iOS的发布版本的配置。已测试版本：
- 2022.3.60f1
- 2020.3.48f1
- 打开工程: demo\FreezeRepro (复现工程来源)
- 执行菜单项: Freeze Repro -> Build Bundles
- 构建并安装到设备上
- 点击开始按钮，等待渲染线程卡死
- 在 Project Settings -> Engine Binary File Rewriter 中开启Fix Freezing in AsyncResourceUploadBlocking
- 重新执行第3步和第4步，确认渲染线程不再卡死
RefreshFQNCache会遍历所有程序集中的类型，当使用HybridCLR DHE时，可能会导致客户端卡住比较久（详见文章）
本工具可以屏蔽掉这个函数的调用，从而避免它引发的一系列问题
注意：这个函数和MovedFromAttribute有关，请确认项目没有依赖此功能，再屏蔽
工程中包含了Android、iOS的开发版本和发布版本的配置。已测试版本：
- 2022.3.57f1