ad818dcbea
Add "LOCAL_JAVAC_SHARD_SIZE" to represent the number of java source path entries in each shard. Sharding is not allowed when "LOCAL_JAVAC_SHARD_SIZE" and "LOCAL_JAR_PROCESSORS" are both enabled. Limitation: 1. 0 <= LOCAL_JAVAC_SHARD_SIZE <= 8192 1. 0 < NUM(java_sources) <= 8192 2. 0 <= NUM(shards) <= 100 Performance Compare: <Unsharded Build------------------------------------------------> 1. Build from clean state rm -r -f out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/ && time m out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes-full-debug.jar real 1m2.720s user 5m26.604s sys 0m39.552s 2. Incremental build m out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes-full-debug.jar && touch frameworks/base/core/java/android/net/http/HttpResponseCache.java && time m out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes-full-debug.jar real 0m37.586s user 5m47.804s sys 0m50.388s <Sharded Build--------------------------------------------------> 1. Build from clean state rm -r -f out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/ && time m out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes-full-debug.jar Javac Shard Size: 50----real 1m10.163s user 25m59.008s sys 1m58.460s Javac Shard Size: 100---real 1m2.115s user 21m3.600s sys 1m15.964s Javac Shard Size: 150---real 0m59.520s user 18m10.544s sys 1m12.628s Javac Shard Size: 200---real 0m56.894s user 15m39.244s sys 1m11.608s Javac Shard Size: 250---real 0m55.991s user 14m38.716s sys 1m2.292s Javac Shard Size: 300---real 0m55.114s user 13m6.568s sys 1m8.200s Javac Shard Size: 350---real 0m53.144s user 12m7.740s sys 1m3.836s Javac Shard Size: 400---real 0m54.929s user 12m9.324s sys 1m4.340s Javac Shard Size: 450---real 1m30.194s user 25m31.468s sys 1m52.416s Javac Shard Size: 500---real 0m53.976s user 10m35.500s sys 0m55.160s 2. Incremental build m out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes-full-debug.jar && touch frameworks/base/core/java/android/net/http/HttpResponseCache.java && time m out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes-full-debug.jar Javac Shard Size: 50-----real 0m16.322s user 1m8.648s sys 0m31.700s Javac Shard Size: 100----real 0m16.163s user 1m22.932s sys 0m29.440s Javac Shard Size: 150----real 0m16.611s user 1m37.828s sys 0m21.168s Javac Shard Size: 200----real 0m16.936s user 1m49.248s sys 0m28.636s Javac Shard Size: 250----real 0m17.509s user 1m54.944s sys 0m32.768s Javac Shard Size: 300----real 0m18.868s user 1m54.088s sys 0m28.824s Javac Shard Size: 350----real 0m17.629s user 1m54.108s sys 0m31.056s Javac Shard Size: 400----real 0m18.658s user 2m7.712s sys 0m30.636s Javac Shard Size: 450----real 0m18.874s user 2m8.808s sys 0m33.540s Javac Shard Size: 500----real 0m19.432s user 2m24.400s sys 0m30.368s time m nothing: real 0m5.799s user 0m7.236s sys 0m3.068s Test: m clean && m -j checkbuild Bug: b/67424047 Change-Id: Id0766d2b7de7c4546d29bbc7f8a0dd0e4b9ad45b |
||
---|---|---|
core | ||
target | ||
tests | ||
tools | ||
.gitignore | ||
Android.mk | ||
CleanSpec.mk | ||
OWNERS | ||
README.txt | ||
buildspec.mk.default | ||
envsetup.sh | ||
help.sh |
README.txt
Android build system usage: m [-j] [<targets>] [<variable>=<value>...] Ways to specify what to build: The common way to specify what to build is to set that information in the environment via: # Set up the shell environment. source build/envsetup.sh # Run "hmm" after sourcing for more info # Select the device and variant to target. If no argument is given, it # will list choices and prompt. lunch [<product>-<variant>] # Selects the device and variant to target. # Invoke the configured build. m [<options>] [<targets>] [<variable>=<value>...] <product> is the device that the created image is intended to be run on. This is saved in the shell environment as $TARGET_PRODUCT by `lunch`. <variant> is one of "user", "userdebug", or "eng", and controls the amount of debugging to be added into the generated image. This gets saved in the shell environment as $TARGET_BUILD_VARIANT by `lunch`. Each of <options>, <targets>, and <variable>=<value> is optional. If no targets are specified, the build system will build the images for the configured product and variant. An alternative to setting $TARGET_PRODUCT and $TARGET_BUILD_VARIANT, which you may see in build servers, is to execute: make PRODUCT-<product>-<variant> A target may be a file path. For example, out/host/linux-x86/bin/adb . Note that when giving a relative file path as a target, that path is interpreted relative to the root of the source tree (rather than relative to the current working directory). A target may also be any other target defined within a Makefile. Run `m help` to view the names of some common targets. To view the modules and targets defined in a particular directory, look for: files named *.mk (most commonly Android.mk) these files are defined in Make syntax files named Android.bp these files are defined in Blueprint syntax For now, the full (extremely large) compiled list of targets can be found (after running the build once), split among these two files: ${OUT}/build-<product>*.ninja ${OUT}/soong/build.ninja If you find yourself interacting with these files, you are encouraged to provide a more convenient tool for browsing targets, and to mention the tool here. Targets that adjust an existing build: showcommands Display the individual commands run to implement the build dist Copy into ${DIST_DIR} the portion of the build that must be distributed Flags -j <N> Run <N> processes at once -j Autodetect the number of processes to run at once, and run that many Variables Variables can either be set in the surrounding shell environment or can be passed as command-line arguments. For example: export I_AM_A_SHELL_VAR=1 I_AM_ANOTHER_SHELL_VAR=2 make droid I_AM_A_MAKE_VAR=3 Here are some common variables and their meanings: TARGET_PRODUCT The <product> to build # as described above TARGET_BUILD_VARIANT The <variant> to build # as described above DIST_DIR The directory in which to place the distribution artifacts. OUT_DIR The directory in which to place non-distribution artifacts. There is not yet known a convenient method by which to discover the full list of supported variables. Please mention it here when there is.