cc_api_headers

cc_api_library

cc_api_variant

cc_benchmark

cc_benchmark compiles an executable binary that performs benchmark testing of a specific component in a device. Additional files such as test suites and test configuration are installed on the side of the compiled executed binary.

cc_benchmark_host

cc_benchmark_host compiles an executable binary that performs benchmark testing of a specific component in the host. Additional files such as test suites and test configuration are installed on the side of the compiled executed binary.

cc_binary

cc_binary produces a binary that is runnable on a device.

cc_binary_host

cc_binary_host produces a binary that is runnable on a host.

cc_defaults

cc_defaults provides a set of properties that can be inherited by other cc modules. A module can use the properties from a cc_defaults using `defaults: ["<:default_module_name>"]`. Properties of both modules are merged (when possible) by prepending the default module's values to the depending module's values.

cc_fuzz

cc_fuzz creates a host/device fuzzer binary. Host binaries can be found at $ANDROID_HOST_OUT/fuzz/, and device binaries can be found at /data/fuzz on your device, or $ANDROID_PRODUCT_OUT/data/fuzz in your build tree.

cc_genrule

cc_genrule is a genrule that can depend on other cc_* objects. The cmd may be run multiple times, once for each of the different arch/etc variations. The following environment variables will be set when the command execute:

	CC_ARCH           the name of the architecture the command is being executed for

	CC_MULTILIB       "lib32" if the architecture the command is being executed for is 32-bit,
	                  "lib64" if it is 64-bit.

	CC_NATIVE_BRIDGE  the name of the subdirectory that native bridge libraries are stored in if
	                  the architecture has native bridge enabled, empty if it is disabled.

	CC_OS             the name of the OS the command is being executed for.

cc_library

cc_library creates both static and/or shared libraries for a device and/or host. By default, a cc_library has a single variant that targets the device. Specifying `host_supported: true` also creates a library that targets the host.

cc_library_headers

cc_library_headers contains a set of c/c++ headers which are imported by other soong cc modules using the header_libs property. For best practices, use export_include_dirs property or LOCAL_EXPORT_C_INCLUDE_DIRS for Make.

cc_library_host_shared

cc_library_host_shared creates a shared library that is usable on a host.

cc_library_host_static

cc_library_host_static creates a static library that is linkable to a host binary.

cc_library_shared

cc_library_shared creates a shared library for a device and/or host.

cc_library_static

cc_library_static creates a static library for a device and/or host binary.

cc_object

cc_object runs the compiler without running the linker. It is rarely necessary, but sometimes used to generate .s files from .c files to use as input to a cc_genrule module.

cc_prebuilt_binary

cc_prebuilt_binary installs a precompiled executable in srcs property in the device's directory, for both the host and device

cc_prebuilt_library

cc_prebuilt_library installs a precompiled shared library that are listed in the srcs property in the device's directory.

cc_prebuilt_library_headers

cc_prebuilt_library_headers is a prebuilt version of cc_library_headers

cc_prebuilt_library_shared

cc_prebuilt_library_shared installs a precompiled shared library that are listed in the srcs property in the device's directory.

cc_prebuilt_library_static

cc_prebuilt_library_static installs a precompiled static library that are listed in the srcs property in the device's directory.

cc_prebuilt_object

cc_prebuilt_test_library_shared

cc_prebuilt_test_library_shared installs a precompiled shared library to be used as a data dependency of a test-related module (such as cc_test, or cc_test_library).

cc_test

cc_test generates a test config file and an executable binary file to test specific functionality on a device. The executable binary gets an implicit static_libs dependency on libgtests unless the gtest flag is set to false.

cc_test_host

cc_test_host compiles a test host binary.

cc_test_library

cc_test_library creates an archive of files (i.e. .o files) which is later referenced by another module (such as cc_test, cc_defaults or cc_test_library) for archiving or linking.

fdo_profile

kernel_headers

kernel_headers retrieves the list of kernel headers directories from TARGET_BOARD_KERNEL_HEADERS and TARGET_PRODUCT_KERNEL_HEADERS variables in a makefile for compilation. See https://android.googlesource.com/platform/build/+/master/core/config.mk for more details on them.

llndk_libraries_txt

llndk_libraries_txt is a singleton module whose content is a list of LLNDK libraries generated by Soong but can be referenced by other modules. For example, apex_vndk can depend on these files as prebuilt. Make uses LLNDK_LIBRARIES to determine which libraries to install. HWASAN is only part of the LL-NDK in builds in which libc depends on HWASAN. Therefore, by removing the library here, we cause it to only be installed if libc depends on it.

ndk_headers

ndk_headers installs the sets of ndk headers defined in the srcs property to the sysroot base + "usr/include" + to directory + directory component. ndk_headers requires the license file to be specified. Example:

	Given:
	sysroot base = "ndk/sysroot"
	from = "include/foo"
	to = "bar"
	header = "include/foo/woodly/doodly.h"
	output path = "ndk/sysroot/usr/include/bar/woodly/doodly.h"

ndk_library

ndk_library creates a library that exposes a stub implementation of functions and variables for use at build time only.

ndk_prebuilt_shared_stl

ndk_prebuilt_shared_stl exports a precompiled ndk shared standard template library (stl) library for linking operation. The soong's module name format is ndk_<NAME>.so where the library is located under ./prebuilts/ndk/current/sources/cxx-stl/llvm-libc++/libs/$(HOST_ARCH)/<NAME>.so.

ndk_prebuilt_static_stl

ndk_prebuilt_static_stl exports a precompiled ndk static standard template library (stl) library for linking operation. The soong's module name format is ndk_<NAME>.a where the library is located under ./prebuilts/ndk/current/sources/cxx-stl/llvm-libc++/libs/$(HOST_ARCH)/<NAME>.a.

preprocessed_ndk_headers

preprocessed_ndk_headers preprocesses all the ndk headers listed in the srcs property by executing the command defined in the preprocessor property.

recovery_snapshot

recovery_snapshot_binary

recovery_snapshot_binary is a special prebuilt executable binary which is auto-generated by development/vendor_snapshot/update.py. As a part of recovery snapshot, recovery_snapshot_binary overrides the recovery variant of the cc binary with the same name, if BOARD_VNDK_VERSION is set.

recovery_snapshot_header

recovery_snapshot_header is a special header library which is auto-generated by development/vendor_snapshot/update.py. As a part of recovery snapshot, recovery_snapshot_header overrides the recovery variant of the cc header library with the same name, if BOARD_VNDK_VERSION is set.

recovery_snapshot_object

recovery_snapshot_object is a special prebuilt compiled object file which is auto-generated by development/vendor_snapshot/update.py. As a part of recovery snapshot, recovery_snapshot_object overrides the recovery variant of the cc object with the same name, if BOARD_VNDK_VERSION is set.

recovery_snapshot_shared

recovery_snapshot_shared is a special prebuilt shared library which is auto-generated by development/vendor_snapshot/update.py. As a part of recovery snapshot, recovery_snapshot_shared overrides the recovery variant of the cc shared library with the same name, if BOARD_VNDK_VERSION is set.

recovery_snapshot_static

recovery_snapshot_static is a special prebuilt static library which is auto-generated by development/vendor_snapshot/update.py. As a part of recovery snapshot, recovery_snapshot_static overrides the recovery variant of the cc static library with the same name, if BOARD_VNDK_VERSION is set.

vendor_snapshot

vendor_snapshot_binary

vendor_snapshot_binary is a special prebuilt executable binary which is auto-generated by development/vendor_snapshot/update.py. As a part of vendor snapshot, vendor_snapshot_binary overrides the vendor variant of the cc binary with the same name, if BOARD_VNDK_VERSION is set.

vendor_snapshot_header

vendor_snapshot_header is a special header library which is auto-generated by development/vendor_snapshot/update.py. As a part of vendor snapshot, vendor_snapshot_header overrides the vendor variant of the cc header library with the same name, if BOARD_VNDK_VERSION is set.

vendor_snapshot_object

vendor_snapshot_object is a special prebuilt compiled object file which is auto-generated by development/vendor_snapshot/update.py. As a part of vendor snapshot, vendor_snapshot_object overrides the vendor variant of the cc object with the same name, if BOARD_VNDK_VERSION is set.

vendor_snapshot_shared

vendor_snapshot_shared is a special prebuilt shared library which is auto-generated by development/vendor_snapshot/update.py. As a part of vendor snapshot, vendor_snapshot_shared overrides the vendor variant of the cc shared library with the same name, if BOARD_VNDK_VERSION is set.

vendor_snapshot_static

vendor_snapshot_static is a special prebuilt static library which is auto-generated by development/vendor_snapshot/update.py. As a part of vendor snapshot, vendor_snapshot_static overrides the vendor variant of the cc static library with the same name, if BOARD_VNDK_VERSION is set.

versioned_ndk_headers

versioned_ndk_headers preprocesses the headers with the bionic versioner: https://android.googlesource.com/platform/bionic/+/master/tools/versioner/README.md. Unlike the ndk_headers soong module, versioned_ndk_headers operates on a directory level specified in `from` property. This is only used to process the bionic/libc/include directory.

vndk_prebuilt_shared

vndk_prebuilt_shared installs Vendor Native Development kit (VNDK) snapshot shared libraries for system build. Example:

	vndk_prebuilt_shared {
	    name: "libfoo",
	    version: "27",
	    target_arch: "arm64",
	    vendor_available: true,
	    product_available: true,
	    vndk: {
	        enabled: true,
	    },
	    export_include_dirs: ["include/external/libfoo/vndk_include"],
	    arch: {
	        arm64: {
	            srcs: ["arm/lib64/libfoo.so"],
	        },
	        arm: {
	            srcs: ["arm/lib/libfoo.so"],
	        },
	    },
	}

vndkcore_libraries_txt

vndkcore_libraries_txt is a singleton module whose content is a list of VNDK core libraries generated by Soong but can be referenced by other modules. For example, apex_vndk can depend on these files as prebuilt.

vndkcorevariant_libraries_txt

vndkcorevariant_libraries_txt is a singleton module whose content is a list of VNDK libraries that are using the core variant, generated by Soong but can be referenced by other modules. For example, apex_vndk can depend on these files as prebuilt.

vndkprivate_libraries_txt

vndkprivate_libraries_txt is a singleton module whose content is a list of VNDK private libraries generated by Soong but can be referenced by other modules. For example, apex_vndk can depend on these files as prebuilt.

vndkproduct_libraries_txt

vndkproduct_libraries_txt is a singleton module whose content is a list of VNDK product libraries generated by Soong but can be referenced by other modules. For example, apex_vndk can depend on these files as prebuilt.

vndksp_libraries_txt

vndksp_libraries_txt is a singleton module whose content is a list of VNDKSP libraries generated by Soong but can be referenced by other modules. For example, apex_vndk can depend on these files as prebuilt.