Add Unity Hub projects scanning and JSON parser

Scan Unity Hub's projects-v1.json and include those projects before registry results. Added VisitProjectsInUnityHubJson to parse hub entries (path, title, lastModified (ms), version, buildTarget, renderPipeline), merge with GetProjectInfo, avoid duplicates, and add projects to history. Introduced a minimal Helpers/JsonParser.cs with FindMatchingBrace, GetStringValue and GetNumberValue to extract values without a full JSON dependency. Also refactored Tools to add GetTargetPlatformFromRaw

Author: ekt-

UnityLauncherPro/GetProjects.cs

@@ -13,12 +13,31 @@ public static class GetProjects
         static readonly string[] registryPathsToCheck = new string[] { @"SOFTWARE\Unity Technologies\Unity Editor 5.x", @"SOFTWARE\Unity Technologies\Unity Editor 4.x" };
 
         // convert target platform name into valid buildtarget platform name, NOTE this depends on unity version, now only 2019 and later are supported
-        public static Dictionary<string, string> remapPlatformNames = new Dictionary<string, string> { { "StandaloneWindows64", "Win64" }, { "StandaloneWindows", "Win" }, { "Android", "Android" }, { "WebGL", "WebGL" } };
+        public static Dictionary<string, string> remapPlatformNames = new Dictionary<string, string> { 
+            { "StandaloneWindows64", "Win64" },             
+            { "StandaloneWindows", "Win" }, 
+            { "Android", "Android" }, 
+            { "WebGL", "WebGL" } };
 
         public static List<Project> Scan(bool getGitBranch = false, bool getPlasticBranch = false, bool getArguments = false, bool showMissingFolders = false, bool showTargetPlatform = false, StringCollection AllProjectPaths = null, bool searchGitbranchRecursively = false, bool showSRP = false)
         {
             List<Project> projectsFound = new List<Project>();
 
+            // first, scan projects from unity hub json file
+            VisitProjectsInUnityHubJson
+            (
+                getGitBranch, getPlasticBranch, getArguments, 
+                showMissingFolders, showTargetPlatform , searchGitbranchRecursively , showSRP, 
+                project =>
+            {
+                if (!projectsFound.ContainsProjectWithPath(project.Path))
+                    projectsFound.Add(project);
+
+                // add found projects to history also (gets added only if its not already there)
+                Tools.AddProjectToHistory(project.Path);
+            });
+
+            // then scan projects from registry
             VisitProjectsInRegistry
             (
                 getGitBranch, getPlasticBranch, getArguments, 
@@ -127,6 +146,85 @@ private static void VisitProjectsInRegistry(
             } // for each registry root
         } // VisitProjectsInRegistry()
 
+        private static void VisitProjectsInUnityHubJson(            
+            bool getGitBranch, bool getPlasticBranch, bool getArguments, 
+            bool showMissingFolders, bool showTargetPlatform , bool searchGitbranchRecursively , bool showSRP, 
+            Action<Project> visitor)
+        {
+            string hubProjectsFile = Path.Combine(
+                Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
+                "UnityHub", "projects-v1.json");
+
+            if (!File.Exists(hubProjectsFile)) 
+                return;
+
+            string json;
+            try { json = File.ReadAllText(hubProjectsFile); }
+            catch { return; }
+
+            int dataIndex = json.IndexOf("\"data\":");
+            if (dataIndex == -1) return;
+
+            // find the opening { of the data object
+            int dataStart = json.IndexOf('{', dataIndex + 7);
+            if (dataStart == -1) return;
+
+            int searchFrom = dataStart + 1;
+            while (true)
+            {
+                // find the start of the next project entry object
+                int entryStart = json.IndexOf('{', searchFrom);
+                if (entryStart == -1) break;
+
+                // find the matching closing }
+                int entryEnd = JsonParser.FindMatchingBrace(json, entryStart);
+                if (entryEnd == -1) break;
+
+                string entry = json.Substring(entryStart, entryEnd - entryStart + 1);
+
+                string projectPath = JsonParser.GetStringValue(entry, "path");
+                if (!string.IsNullOrEmpty(projectPath))
+                {
+                    // unescape JSON backslashes and convert to normal path separators
+                    projectPath = projectPath.Replace(@"\\", @"/");
+
+                    // collect project info from disk, but override with hub json data where its more authoritative
+                    // todo: an optimization could be to only get data from disk that is missing from json, 
+                    // instead of getting all data and then overriding. 
+                    var p = GetProjectInfo(projectPath, getGitBranch, getPlasticBranch, getArguments, showMissingFolders, showTargetPlatform, searchGitbranchRecursively, showSRP);
+                    if (p != null)
+                    {
+                        string title = JsonParser.GetStringValue(entry, "title");
+                        if (!string.IsNullOrEmpty(title)) p.Title = title;
+
+                        // lastModified is a Unix millisecond timestamp
+                        string lastModifiedStr = JsonParser.GetNumberValue(entry, "lastModified");
+                        if (long.TryParse(lastModifiedStr, out long lastModifiedMs))
+                            p.Modified = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc).AddMilliseconds(lastModifiedMs).ToLocalTime();
+
+                        string version = JsonParser.GetStringValue(entry, "version");
+                        if (!string.IsNullOrEmpty(version)) p.Version = version;
+
+                        if (showTargetPlatform)
+                        {
+                            string buildTarget = JsonParser.GetStringValue(entry, "buildTarget");                            
+                            p.TargetPlatform = Tools.GetTargetPlatformFromRaw(buildTarget);                                                        
+                        }
+
+                        if (showSRP)
+                        {
+                            string renderPipeline = JsonParser.GetStringValue(entry, "renderPipeline");
+                            if (!string.IsNullOrEmpty(renderPipeline)) p.SRP = renderPipeline;
+                        }
+
+                        visitor(p);
+                    }
+                }
+
+                searchFrom = entryEnd + 1;
+            }
+        }
+
         private static bool ContainsProjectWithPath(this List<Project> projects, string projectPath)
         {
             foreach (var p in projects)

UnityLauncherPro/Helpers/JsonParser.cs

@@ -0,0 +1,41 @@
+namespace UnityLauncherPro
+{
+    internal static class JsonParser
+    {
+        // finds the index of the closing } matching the opening { at startIndex
+        internal static int FindMatchingBrace(string json, int startIndex)
+        {
+            int depth = 0;
+            for (int i = startIndex; i < json.Length; i++)
+            {
+                if (json[i] == '{') depth++;
+                else if (json[i] == '}') { depth--; if (depth == 0) return i; }
+            }
+            return -1;
+        }
+
+        // extracts a JSON string value for the given key
+        internal static string GetStringValue(string json, string key)
+        {
+            int keyIndex = json.IndexOf("\"" + key + "\":");
+            if (keyIndex == -1) return null;
+            int valueStart = json.IndexOf('"', keyIndex + key.Length + 2) + 1;
+            if (valueStart == 0) return null;
+            int valueEnd = json.IndexOf('"', valueStart);
+            if (valueEnd == -1) return null;
+            return json.Substring(valueStart, valueEnd - valueStart);
+        }
+
+        // extracts a JSON number value for the given key (returned as string for flexibility)
+        internal static string GetNumberValue(string json, string key)
+        {
+            int keyIndex = json.IndexOf("\"" + key + "\":");
+            if (keyIndex == -1) return null;
+            int valueStart = keyIndex + key.Length + 3; // skip past "key":
+            while (valueStart < json.Length && json[valueStart] == ' ') valueStart++;
+            int valueEnd = valueStart;
+            while (valueEnd < json.Length && (char.IsDigit(json[valueEnd]) || json[valueEnd] == '-')) valueEnd++;
+            return valueEnd > valueStart ? json.Substring(valueStart, valueEnd - valueStart) : null;
+        }
+    }
+}

UnityLauncherPro/Tools.cs

@@ -1626,6 +1626,11 @@ public static string GetTargetPlatform(string projectPath)
         {
             var rawPlatformName = GetTargetPlatformRaw(projectPath);
 
+            return GetTargetPlatformFromRaw(rawPlatformName);
+        }
+
+        public static string GetTargetPlatformFromRaw(string rawPlatformName)
+        {
             if (string.IsNullOrEmpty(rawPlatformName) == false && GetProjects.remapPlatformNames.ContainsKey(rawPlatformName))
             {
                 return GetProjects.remapPlatformNames[rawPlatformName];

UnityLauncherPro/UnityLauncherPro.csproj

@@ -107,6 +107,7 @@
     <Compile Include="GetProjects.cs" />
     <Compile Include="GetUnityInstallations.cs" />
     <Compile Include="GetUnityUpdates.cs" />
+    <Compile Include="Helpers\JsonParser.cs" />
     <Compile Include="Helpers\ObservableDictionary.cs" />
     <Compile Include="Helpers\ProcessHandler.cs" />
     <Compile Include="Libraries\ExtractTarGz.cs" />