Skip to content

Commit d9b21ba

Browse files
Add documentation and scripts for comparing builds using UnityDataTool (#27)
Comparison of builds is a very common topic when trying to investigate non-determinism or other "unexpected" changes when a project is built. But there is no single "compare builds" tool or feature and UnityDataTools doesn't natively support comparison. This PR adds two "example" scripts that aid in the comparison of the sqlite database generated by "UnityDataTools analyze". It also frames the use of these scripts in a new documentation topic that also gets into using diff tools + WebExtract + UnityDataTools. The two examples try to touch on two common tricky scenarios: AssetBundles built by Addressables with hashes in the name texture changes inside .resS files Co-authored-by: Tim Thomas <timt@unity3d.com>
1 parent 4dc79d7 commit d9b21ba

13 files changed

Lines changed: 554 additions & 1 deletion
13.1 KB
Loading
56.1 KB
Loading
23.4 KB
Loading
12.7 KB
Loading

Documentation/RemoveHashName.png

53.1 KB
Loading
59.8 KB
Loading
11.8 KB
Loading
26.3 KB
Loading

Documentation/analyze-examples.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -214,6 +214,10 @@ object_id type name pretty_size crc32
214214
3866367853307903194 Sprite red 460.0 B 1811343945
215215
```
216216

217+
## Example: Finding differences between two builds
218+
219+
This is a large subject, see [Comparing Builds](comparing-builds.md).
220+
217221
## Example: Matching content back to the source asset
218222

219223
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.

Documentation/comparing-builds.md

Lines changed: 328 additions & 0 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)