Newtonsoft Json.NET is a de facto standard JSON library in .NET ecosystem. But it doesn't support Unity3D, so it's a little bit hard to use JSON.NET just after getting Json.NET package. This package is for Unity3D programmers that need to use latest Json.NET in Unity3D.
Visit Release page to get latest Json.NET unity-package.
To use this library in IL2CPP build settings, you need to add link.xml to your project's asset folder. For detailed information about link.xml, read unity manual about this.
Unity3D has old-fashioned and bizarre .NET Framework like these :)
- Basically based on .NET Framework 3.5 (forked Mono 2.6)
- Runtime lacks some types in .NET Framework 3.5 (like System.ComponentModel.AddingNewEventHandler)
- For iOS, dynamic code emission is forbidden by Apple AppStore.
Because Newtonsoft Json.NET doesn't handle these limitations, errors will welcome you when you use official Json.NET dll targetting .NET 3.5 Framework.
Following works are done to make Json.NET support Unity3D.
- Based on Newtonsoft Json.NET 8.
- Disable IL generation to work well under AOT environment like iOS.
- Remove code related with System.ComponentModel.
- Remove System.Data and EntityKey support.
- Remove XML support.
- Remove JPath class to reduce size of DLL.
- Remove DiagnosticsTraceWriter support.
- Workaround for differences between Microsoft.NET & Unity3D-Mono.NET
For Unity.Lite version, additional works are done to make more lite.
- Remove JsonLinq (JToken, ...)
- Remove Bson
Tests in Json.NET are updated to be able to run under UnityEditor Test Runner. All tests pass under Microsoft .NET 3.5 but with UnityEditor some of them fail because there are not-implemented features and bugs in Unity3D-Mono framework.
Test Result:
| Profile | ✅ Passed | ❌ Failed | ⚪ Ignored |
|---|---|---|---|
| Microsoft.NET | 1448 | 0 | 1 |
| Unity3D-Mono | 1435 | 13 | 1 |
Detailed Description is here to tell you what failed and why.
This library is tested on Unity 4.7, 5.2 and 5.3. For AOT environment like iOS, you need to use IL2CPP instead of obsolute Mono-AOT because IL2CPP handles generic code better than Mono-AOT. With Mono-AOT configuration, AOT related exception would be thrown.
- Q: App stops throwing MissingMethodException for ComponentModel.TypeConverter like this.
MissingMethodException: Method not found:
'Default constructor not found...ctor() of System.ComponentModel.TypeConverter'.
- A: link.xml should be added to your project.