1# Difftool 2 3This directory contains tools to compare build artifacts from two separate 4build invocations as a way of gauging build correctness and debugging 5potential problems with build systems under development. 6 7# Usage 8 9Use of these tools requires a multistep process: 10 111. Build using legacy build system: 12 ``` 13 $ m libc 14 ``` 152. Collect results to a tmp directory. 16 ``` 17 $ ./collect.py out/combined-aosp_flame.ninja \ 18 out/target/product/flame/obj/libc.so \ 19 /tmp/legacyFiles 20 ``` 213. Build using the new build system: 22 ``` 23 $ m --bazel-mode-dev libc 24 ``` 254. Collect results to a tmp directory. 26 ``` 27 $ ./collect.py out/combined-aosp_flame.ninja \ 28 out/target/product/flame/obj/libc.so \ 29 /tmp/newFiles 30 ``` 315. Run comparative analysis on the two tmp directories. (See 32 documentation of difftool.py for exact usage.) 33 ``` 34 $ ./difftool.py /tmp/legacyFiles \ 35 out/target/product/flame/obj/libc.so \ 36 /tmp/newFiles \ 37 out/target/product/flame/obj/libc.so 38 ``` 39 40Use `./collect.py -h` or `./difftool.py -h` for full usage information of 41these subtools. 42 43