7
HowToCompile
李若辰 edited this page 2026-03-17 10:54:16 +08:00

回到主页

注意事项

[>0.5.0 - < 0.6.0] [>2025-07-04]

插件本体jsondll切换为了il2cpp的版本,和web版保持了一致。 此举目的是为了暂时性的兼容项目,快速调试。 后续会逐步将newtonesoftjson依赖移除。

[>0.3.6] [>2025-06-21]

插件编译源移动到了外层,不再需要手动执行多余的设置了,只需要打开vs工程编译一遍即可,上手更快。 同时之前的数学库项目已经在逐步添加测试案例了,可以直观看到使用方法,及性能基准。

[<0.3.5] [<2025-06-20]

此插件分为unity编译部分与源码编译部分,源码部分文件需要设置首先为设置为被unity忽略的状态,整个源码文件完全展开后将有1个gb以上的体积,这个体积是由于不同项目中包含重复的依赖项,以及各种重复的打包文件,所以完全不可以参与unity的编译。

如何编译

流程很简单。

下载源码版本的插件,目录形似:

- .git
- Developer
- Release
- .gitignore
- CHANGELOG.md
- README.md

其中Developer目录是源码,Realase是发布源,发布版本的仓库内容就是截取自Release目录。
找到文件:\Developer\MainSolution\MainSolution.sln,使用自己喜欢的编译器打开,确保MainSolution就是启动项目,点击启动就可以了。
项目会自动编译所有依赖,并放在Release目录下的特定位置。

如果报错,可能是dll的依赖出现了缺失,根据报错的命名空间进行解决即可,确保插件使用的依赖可以在unity环境下找到,并且也是以dll的形式存在的。

项目中只会提供一些封装的用法工具集,因为文件太多了会导致编译时间变长,而封装到dll中,一个是编译速度会变快,另一个是用法隔离。
在项目前期快速实施阶段,将所有的用法工具集拿来即插即用非常快速,后续如果有优化需求,可以手动将里面的用法重新剥离出来。

依赖项目

xeric目前依赖的主要是NewToneSoft.Json,主要的兼容性问题也来源于这个组件。
是的然后就没有其他主要依赖了,毕竟这是被其他组件依赖的库,不可以有太多奇怪的内容。
如果要自己更改的话,也确保不要添加额外的依赖,避免出现冲突。

问题解决

根据unity版本不同,遭遇错误的解决方案都不同。

插件编译更新后,untiy报错与找不到插件命名空间相关的内容

手动"Preferences -> External Tools -> Regenerate project files"刷新一下项目。

与同事git版本同步后,unity报错与找不到插件命名空间相关的内容

通过git url直接在unity中获取插件,可以获得完整的package化管理功能,但如果package.json文件被修改,插件也会相应被自动卸载。 可以重新在git中退回package相关文件,或重新使用git url下载。