Json.NET is a popular high-performance JSON framework for .NET and the most used framework throughout the whole .NET ecosystem.
This repo is a fork of JamesNK/Newtonsoft.Json containing custom builds for regular standalone, but more importantly AOT targets such as all IL2CPP builds (WebGL, iOS, Android, Windows, Mac OS X) and portable .NET (UWP, WP8).
-
Expected always up-to-date fork of Newtonsoft.Json
-
Full Newtonsoft.Json.Tests test suite passes on Unity 2018.4.14f1 and 2019.2.11f1 with Mono and IL2CPP as scripting backend.
-
Precompiled as DLLs for faster builds
-
Full support for IL2CPP builds
-
Delivered via Unity Package Manager for easy updating and version switching
-
Newtonsoft.Json.Utility.AotHelper utility class for resolving common Ahead-Of-Time issues. (Read more about AOT)
-
(🌟 new!)Optional side package Newtonsoft.Json-for-Unity.Converters to help with converting Unity types, such as the Vector3, Quaternion, Color, and many, many more!
Click the header. It goes to the Wiki where the guide is now located. Here is the raw url:
- Source repository (github.com/JamesNK/Newtonsoft.Json)
- Homepage (www.newtonsoft.com/json)
- Documentation (www.newtonsoft.com/json/help)
- Release Notes on GitHub from source repository
- Stack Overflow posts tagged with
json.net
Thankful that you're even reading this :)
If you want to contribute, here's what you can do:
-
Spread the word! ❤ More users → more feedback → I get more will-power to work on this project. This is the best way to contribute!
-
Open an issue. Could be a feature request for a new converter, or maybe you've found a bug?
-
Tackle one of the unassigned issues. If it looks like a fun task to solve and no one is assigned, then just comment on it and say that you would like to try it out.
I realize that few of the issues are trivial, so if you wish to tackle something small then look at the list of unassigned issues over at the Unity converters package repoistory.
-
Open a PR with some new feature or issue solved. Remember to ask before starting to work on anything, so no two are working on the same thing.
Having a feature request or issue pop up and having the submitter suggesting themselves to later add a PR for a solution is the absolute greatest gift a repository maintainer could ever receive. 🎁
I have this CONTRIBUTING.md file that contains some guidelines. It may be good to read it beforehand.
Open the Src/Newtonsoft.Json.sln solution file in Visual Studio and start
hacking.
Rule of thumb: Don't commit edits of the Src/Newtonsoft.Json/,
Src/Newtonsoft.Json.Tests/, or Src/Newtonsoft.Json.TestConsole/ folders
for forking reasons. Exception is when doing a new release, as explained in
a section little further down below.
When using Visual Studio, open the Src/Newtonsoft.Json.sln solution and just
Ctrl+Shift+B 😜
When using command line, recommended to use MSBuild.exe for building and not the dotnet CLI.
PS> MSBuild.exe -t:build -restore .\Src\Newtonsoft.Json -p:Configuration=DebugRun the Newtonsoft.Json.Tests normally via the Test Runner inside Visual Studio.
For testing inside Unity locally, look inside the Src/Newtonsoft.Json-for-Unity.Tests/README.md for more information.
Common enough occurrence that we have a wiki page for just this.
Read the Working with branches, section "Merging changes from JamesNKs repo" wiki page.
This project, giving a stable Newtonsoft.Json experience to the Unity community, is a hobby project for me and will always stay free.
If this tool gave you something you value, consider giving a coin back into this tool. Sponsor me with a cup of coffee, I drink the cheap stuff! ☕
This package is licensed under The MIT License (MIT)
Copyright © 2019 Kalle Jillheden (jilleJr)
https://github.com/jilleJr/Newtonsoft.Json-for-Unity
See full copyrights in LICENSE.md inside repository