推荐开源项目:Json.NET for Unity3D
在.NET领域,Newtonsoft的Json.NET无疑是处理JSON数据的事实标准。然而,Json.NET原生并不支持Unity3D。为此,我们带来了Json.NET for Unity3D,这是一个针对Unity3D程序员特别定制的Json.NET版本,让你能够轻松地在Unity3D项目中使用最新的Json.NET功能。
获取方式
你可以在项目发布页面获取最新版的Json.NET unity-package。对于IL2CPP构建设置,别忘了将link.xml添加到你的项目资源文件夹中。更多关于link.xml的信息,可以参考Unity官方文档。
解决了什么问题?
Unity3D使用的是基于.NET Framework 3.5(分支自Mono 2.6)的老版本,且缺少一些.NET 3.5中的类型,并且对于iOS平台,动态代码生成是被苹果App Store禁止的。这导致直接使用官方Json.NET dll会出现错误。Json.NET for Unity3D通过以下方式解决了这些问题:
- 基于Json.NET 9进行定制。
- 禁用IL生成以适应AOT环境,如iOS。
- 移除System.ComponentModel相关代码。
- 移除System.Data和EntityKey支持。
- 移除XML支持。
- 移除DiagnosticsTraceWriter支持。
- 针对Unity3D-Mono.NET的不同进行兼容性调整。
此外,还有一个更轻量级的Unity.Lite版本,移除了JsonLinq和Bson支持。
单元测试
该项目已针对UnityEditor Test Runner进行了单元测试,尽管在Unity3D-Mono环境下有些测试失败,但大部分测试在Microsoft .NET 3.5环境下都能成功通过。详细的测试结果可在这里查看。
Unity兼容性
该库已在Unity 4.7, 5.2 和 5.3上进行了测试。对于Windows Store的构建,可能出现与UWP的兼容性问题,你可以查阅工作绕行方案来解决。
常见问题
- 如果遇到
MissingMethodException
,可能是由于Unity3D删除了未使用的类,请确保你的项目中包含了link.xml
。 - 若在调用
CreateValueInternal
时遇到ExecutionEngineException
,可能是因为Unity3D剥离了一些实际用于序列化的类,只需在代码中引用这些类即可避免此问题。 - 出现
ArgumentNullException
并提示method
参数为空,这可能涉及到Json.NET内部类如CollectionWrapper<T>
,你需要在使用HashSet<T>
或Dictionary<TKey, TValue>
的地方引入相应的辅助方法。
总的来说,Json.NET for Unity3D是一个强大的工具,它可以帮你更顺利地在Unity3D项目中处理JSON数据,而无需担心平台兼容性和性能问题。现在就尝试将其整合到你的开发流程中,享受高效、稳定的JSON操作体验吧!