Analyze - Support BuildReport files (#45)

Adds comprehensive support for analyzing Unity BuildReport files, enabling detailed inspection of build contents and source asset tracking.

Author: SkowronskiAndrew

AGENTS.md

@@ -47,6 +47,23 @@ dotnet test --filter "FullyQualifiedName~SerializedFile"
 
 Test projects: UnityFileSystem.Tests, Analyzer.Tests, UnityDataTool.Tests, TestCommon (helper library)
 
+### Code Style
+
+#### Comments
+
+* Write comments that explain "why".  A few high level comments explaining the purpose of classes or methods is very helpful.  Comments explaining tricky code are also helpful.
+* Avoid comments that are redundant with the code.  Do not comment before each line of code explaining what it does unless there is something that is not obvious going on.
+* Do not use formal C# XML format when commenting methods, unless it is in an important interface class like UnityFileSystem.
+
+#### Formatting
+
+To repair white space or style issues, run:
+
+```
+dotnet format whitespace . --folder
+dotnet format style
+```
+
 ### Running the Tool
 ```bash
 # Show all commands

Analyzer/Properties/Resources.Designer.cs

@@ -127,6 +127,9 @@
   <data name="AudioClip" type="System.Resources.ResXFileRef, System.Windows.Forms">
     <value>..\Resources\AudioClip.sql;System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089;utf-8</value>
   </data>
+  <data name="BuildReport" type="System.Resources.ResXFileRef, System.Windows.Forms">
+    <value>..\Resources\BuildReport.sql;System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089;utf-8</value>
+  </data>
   <data name="Finalize" type="System.Resources.ResXFileRef, System.Windows.Forms">
     <value>..\Resources\Finalize.sql;System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089;Windows-1252</value>
   </data>
@@ -226,4 +229,7 @@
   <data name="MonoScript" type="System.Resources.ResXFileRef, System.Windows.Forms">
     <value>..\Resources\MonoScript.sql;System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089;utf-8</value>
   </data>
+  <data name="PackedAssets" type="System.Resources.ResXFileRef, System.Windows.Forms">
+    <value>..\Resources\PackedAssets.sql;System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089;utf-8</value>
+  </data>
 </root>

Analyzer/Properties/Resources.resx

@@ -0,0 +1,52 @@
+CREATE TABLE IF NOT EXISTS build_reports(
+    id INTEGER,
+    build_type TEXT,
+    build_result TEXT,
+    platform_name TEXT,
+    subtarget INTEGER,
+    start_time TEXT,
+    end_time TEXT,
+    total_time_seconds INTEGER,
+    total_size INTEGER,
+    build_guid TEXT,
+    total_errors INTEGER,
+    total_warnings INTEGER,
+    options INTEGER,
+    asset_bundle_options INTEGER,
+    output_path TEXT,
+    crc INTEGER,
+    PRIMARY KEY (id)
+);
+
+CREATE TABLE IF NOT EXISTS build_report_files(
+    build_report_id INTEGER NOT NULL,
+    file_index INTEGER NOT NULL,
+    path TEXT NOT NULL,
+    role TEXT NOT NULL,
+    size INTEGER NOT NULL,
+    PRIMARY KEY (build_report_id, file_index),
+    FOREIGN KEY (build_report_id) REFERENCES build_reports(id)
+);
+
+CREATE TABLE IF NOT EXISTS build_report_archive_contents(
+    build_report_id INTEGER NOT NULL,
+    assetbundle TEXT NOT NULL,
+    assetbundle_content TEXT NOT NULL,
+    PRIMARY KEY (build_report_id, assetbundle_content),
+    FOREIGN KEY (build_report_id) REFERENCES build_reports(id)
+);
+
+CREATE VIEW build_report_files_view AS
+SELECT
+    o.serialized_file,
+    br.id AS build_report_id,
+    br.build_type,
+    br.platform_name,
+    brf.file_index,
+    brf.path,
+    brf.role,
+    brf.size
+FROM build_report_files brf
+INNER JOIN build_reports br ON brf.build_report_id = br.id
+INNER JOIN object_view o ON br.id = o.id;
+

Analyzer/Resources/BuildReport.sql

@@ -0,0 +1,61 @@
+CREATE TABLE IF NOT EXISTS build_report_packed_assets(
+    id INTEGER,
+    path TEXT,
+    file_header_size INTEGER,
+    PRIMARY KEY (id)
+);
+
+CREATE TABLE IF NOT EXISTS build_report_source_assets(
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    source_asset_guid TEXT NOT NULL,
+    build_time_asset_path TEXT NOT NULL,
+    UNIQUE(source_asset_guid, build_time_asset_path)
+);
+
+CREATE TABLE IF NOT EXISTS build_report_packed_asset_info(
+    packed_assets_id INTEGER,
+    object_id INTEGER,
+    type INTEGER,
+    size INTEGER,
+    offset INTEGER,
+    source_asset_id INTEGER NOT NULL,
+    FOREIGN KEY (packed_assets_id) REFERENCES build_report_packed_assets(id),
+    FOREIGN KEY (source_asset_id) REFERENCES build_report_source_assets(id)
+);
+
+CREATE VIEW build_report_packed_assets_view AS
+SELECT
+    pa.id,
+    o.object_id,
+    brac.assetbundle,
+    pa.path,
+    pa.file_header_size,
+    br_obj.id as build_report_id,
+    sf.name as build_report_filename
+FROM build_report_packed_assets pa
+INNER JOIN objects o ON pa.id = o.id
+INNER JOIN serialized_files sf ON o.serialized_file = sf.id
+LEFT JOIN objects br_obj ON o.serialized_file = br_obj.serialized_file AND br_obj.type = 1125
+LEFT JOIN build_report_archive_contents brac ON br_obj.id = brac.build_report_id AND pa.path = brac.assetbundle_content;
+
+CREATE VIEW build_report_packed_asset_contents_view AS
+SELECT
+    sf.name as serialized_file,
+    brac.assetbundle,
+    pa.path,
+    pac.packed_assets_id,
+    pac.object_id,
+    pac.type,
+    pac.size,
+    pac.offset,
+    sa.source_asset_guid,
+    sa.build_time_asset_path,
+    br_obj.id as build_report_id
+FROM build_report_packed_asset_info pac
+LEFT JOIN build_report_packed_assets pa ON pac.packed_assets_id = pa.id
+LEFT JOIN objects o ON o.id = pa.id
+INNER JOIN serialized_files sf ON o.serialized_file = sf.id
+LEFT JOIN build_report_source_assets sa ON pac.source_asset_id = sa.id
+LEFT JOIN objects br_obj ON o.serialized_file = br_obj.serialized_file AND br_obj.type = 1125
+LEFT JOIN build_report_archive_contents brac ON br_obj.id = brac.build_report_id AND pa.path = brac.assetbundle_content;
+