Repository navigation
SSFramework v0.1.2 — 资源打包与 IL2CPP 裁剪修复
通过 Git / UPM 安装框架后,普通 IL2CPP 构建可能成功,但运行时资源初始化报“没有注册默认资源 Provider”。原因是 Package 内的 link.xml 未进入 UnityLinker,反射装配的 YooAsset Adapter 被裁剪。v0.1.2 修复了这条构建与运行路径。
- Framework Editor 构建回调自动汇总目标平台 Module 自带的保留规则,通过源码 Catalog 定位 Package 文件;无需手动复制到 Assets。
- 保留规则仍归各 Module 管理,删除 Module 后清除旧的汇总内容;无效 XML 会阻止构建并指出来源。
- 更新手动接入、资源构建与 Player 验收说明,接入工具默认固定到 v0.1.2。第三方依赖版本和 Runtime API 保持原有契约。
验证使用真实 Unity 6000.3.23f1 消费工程:574 项 Editor 测试分批通过(564 项既有测试 + 10 项新增回归),15 项 YooAsset PlayMode 测试通过。资源构建与非 Development Windows x64 IL2CPP 构建均为 0 错误 / 0 警告;解压后的 Player 在 RTX 3070 上通过计数命令、Offline 资源加载 / 释放 / 再加载、文本与 URP 材质检查,退出码为 0,可见画面截图检查通过。
接入工具的 30 组安装测试和 17 组包源测试分别在 Windows PowerShell 5.1 / PowerShell 7 通过。Player 验证源码为 b07620359798f02e421f3a68b8f91a409bfa8c0d;此发行版的 src/ 与其一致。本轮不覆盖 HybridCLR 代码热更新、Host/CDN 更新、其他平台 / 显卡或大规模 ECS 仿真;此前 769 项 PlayMode 全量结果属于 v0.1.1 的历史验证。
安装方式可自由选择:
- 下载接入工具 ZIP:解压后关闭目标 Unity 工程,运行
Setup-SSFramework.cmd,核对预览再应用。无需先安装框架;已有 Framework 版本会保留,工具不会自动升级已有工程。 - 手动安装与升级:配置包源后,在 Unity Package Manager 添加
https://github.com/heroliss/SSFramework.git#v0.1.2。已有工程也可用此地址显式升级,再核对并提交清单与锁文件。
不做代码热更新时继续关闭 HybridCLR 的 Enable。使用完整 Framework Editor Module 即可获得本次裁剪修复;物理删除该模块的精简工程需要提供等价保留入口。