Install Converters via Git in UPM

Unity Package Manager, or UPM for short, is Unity's new solution for managing packages so they don't need to be included inside the /Assets folder.

Have a look at the Unity Package Manager docs for more info.

This guide shows how to install the jilleJr/Newtonsoft.Json-for-Unity.Converters project using Git via UPM.

The converters project contains lots of converters to be able to successfully read and write JSON data that uses Unity types, such as Vector3, Quaternion, Bounds, LayerMask, et.al.

Prerequisites

1. Requires Unity Editor 2018.1 or above, as UPM was first shipped with 2018.1.

2. Git installed on your machine. See download instructions here: https://git-scm.com/downloads

3. You already have installed Newtonsoft.Json installed to your Unity project.

   You may visit the any of the "Getting started > Install Newtonsoft.Json-for-Unity" wiki pages to install that beforehand.

Installing the package

1. Find your version in the list of tags: https://github.com/jilleJr/Newtonsoft.Json-for-Unity.Converters/tags

2. First find the version you wish to install as instructed above.

3. Open <project>/Packages/manifest.json, add the package in the list of dependencies.

À la:

{
  "dependencies": {
    "jillejr.newtonsoft.json-for-unity.converters": "https://github.com/jilleJr/Newtonsoft.Json-for-Unity.Converters.git#1.0.0",

    /* ... rest of Unity packages ... */
  }
}

Done!

Updating the package

1. Find which version you want to upgrade to in the list of tags: https://github.com/jilleJr/Newtonsoft.Json-for-Unity.Converters/tags

2. Open <project>/Packages/manifest.json, change the version of the package in the list of dependencies by changing the value after the pound sign. For example, from #1.0.0 to #1.1.0.

3. Then also remove the version lock for the package to force UPM to fetch the new version of the package.

Sample changeset:

@@ Packages/manifest.json @@
{
  "dependencies": {
-    "jillejr.newtonsoft.json-for-unity.converters": "https://github.com/jilleJr/Newtonsoft.Json-for-Unity.Converters.git#1.0.0",
+    "jillejr.newtonsoft.json-for-unity.converters": "https://github.com/jilleJr/Newtonsoft.Json-for-Unity.Converters.git#1.1.0",

    /* ... rest of Unity packages ... */
  },
  "lock": {
-    "jillejr.newtonsoft.json-for-unity.converters": {
-      "hash": "9b9871e395be2f53e53f830af9ab586ee6e1ee3d",
-      "revision": "1.0.0"
-    }
  }
}