Merge branch 'main' into add-buildlayout-support

Author: timt-unity3d

Analyzer/AnalyzerTool.cs

@@ -60,6 +60,9 @@ public int Analyze(
             searchPattern,
             noRecursion ? SearchOption.TopDirectoryOnly : SearchOption.AllDirectories);
 
+        int countFailures = 0;
+        int countSuccess = 0;
+        int countIgnored = 0;
         int i = 1;
         foreach (var file in files)
         {
@@ -74,6 +77,7 @@ public int Analyze(
                     {
                         parser.Parse(file);
                         ReportProgress(Path.GetRelativePath(path, file), i, files.Length);
+                        countSuccess++;
                     }
                     catch (Exception e)
                     {                        
@@ -83,25 +87,27 @@ public int Analyze(
                         Console.WriteLine($"{e.GetType()}: {e.Message}");
                         if (m_Verbose)
                             Console.WriteLine(e.StackTrace);
+                        countFailures++;
                     }
                     ++i;
                 }
             }
             if (!foundParser)
             {
-                var relativePath = Path.GetRelativePath(path, file);
-
                 if (m_Verbose)
                 {
+                    var relativePath = Path.GetRelativePath(path, file);
                     Console.WriteLine();
                     Console.WriteLine($"Ignoring {relativePath}");
                 }
                 ++i;
+                countIgnored++;
+                continue;
             }
         }
 
         Console.WriteLine();
-        Console.WriteLine("Finalizing database...");
+        Console.WriteLine($"Finalizing database. Successfully processed files: {countSuccess}, Failed files: {countFailures}, Ignored files: {countIgnored}");
 
         writer.End();
         foreach (var parser in parsers)
@@ -116,6 +122,11 @@ public int Analyze(
         return 0;
     }
 
+    private bool ProcessFile(string file, string path, SQLiteWriter writer, int i, int length)
+    {
+        throw new NotImplementedException();
+    }
+
     int m_LastProgressMessageLength = 0;
 
     void ReportProgress(string relativePath, int fileIndex, int cntFiles)
@@ -138,7 +149,7 @@ void ReportProgress(string relativePath, int fileIndex, int cntFiles)
     void EraseProgressLine()
     {
         if (!m_Verbose)
-            Console.Write($"\r{new string(' ', m_LastProgressMessageLength)}");
+            Console.Write($"\r{new string(' ', m_LastProgressMessageLength)}\r");
         else
             Console.WriteLine();
     }

Documentation/AddressableBuildComparison.png

@@ -214,6 +214,10 @@ object_id             type         name            pretty_size  crc32
 3866367853307903194   Sprite       red             460.0 B      1811343945
 ```
 
+## Example: Finding differences between two builds
+
+This is a large subject, see [Comparing Builds](comparing-builds.md).
+
 ## Example: Matching content back to the source asset
 
 UnityDataTool works on the output of a Unity build, which, by its very nature, only contains the crucial data needed to efficiently load built content in the Player.  So it does not include any information about the assets and scenes in the project that was used to create that build.  However you may want to match content back to the original source asset or scene.  For example if the size of an AssetBundle has unexpectedly changed between builds then you may want to track down which source assets could be responsible for that change.  Or you may want to confirm that some particular image has been included in the build.