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_cmake_snapshot

cmake_snapshot allows defining source packages for release outside of Android build tree. As a result of cmake_snapshot module build, a zip file is generated with CMake build definitions for selected source modules, their dependencies and optionally also the source code itself.

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_preprocess_no_configuration

cc_preprocess_no_configuration modules run the c preprocessor on a single input source file. They also have "no configuration", meaning they don't have an arch or os associated with them, they should be thought of as pure textual transformations of the input file. In some cases this is good, in others you might want to do different transformations depending on what arch the result will be compiled in, in which case you can use cc_object instead of this module.

cc_rustlibs_for_make

cc_rustlibs_for_make creates a static library which bundles together rust_ffi_static deps for Make. This should not be depended on in Soong, and is probably not the module you need unless you are sure of what you're doing. These should only be declared as dependencies in Make. To ensure inclusion, rust_ffi_static modules should be declared in the whole_static_libs property.

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/+/main/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_translation_package

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.

sanitizer_libraries_txt

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"],
	        },
	    },
	}