A rule for building projects using the Ninja build tool
Rule for building external libraries with Ninja.
A unique name for this target.
Optional additional inputs to be declared as needed for the shell script action.Not used by the shell script part in cc_external_rule_impl.
Optional additional tools needed for the building. Not used by the shell script part in cc_external_rule_impl.
Optional. if true, link all the object files from the static library, even if they are not used.
A list of arguments to pass to the call to
Files needed by this rule at runtime. May list file or rule targets. Generally allows any target.
Optional compilation definitions to be passed to the dependencies of this library. They are NOT passed to the compiler, you should duplicate them in the configuration options.
Optional dependencies to be copied into the directory structure. Typically those directly required for the external building of the library/binaries. (i.e. those that the external buidl system will be looking for and paths to which are provided by the calling rule)
A directory to pass as the
-C argument. The rule will always use the root directory of the
lib_sources attribute if this attribute is not set
Environment variables to set during the build.
$(execpath) macros may be used to point at files which are listed as data deps, tools_deps, or additional_tools, but unlike with other rules, these will be replaced with absolute paths to those files, because the build does not run in the exec root. No other macros are supported.
Library name. Defines the name of the install directory and the name of the static library, if no output files parameters are defined (any of static_libraries, shared_libraries, interface_libraries, binaries_names) Optional. If not defined, defaults to the target's name.
Label with source code to build. Typically a filegroup for the source of remote repository. Mandatory.
Optional link options to be passed up to the dependencies of this library
Optional name of the output subdirectory with the binary files, defaults to 'bin'.
Optional names of the resulting binaries.
Flag variable to indicate that the library produces only headers
Optional name of the output subdirectory with the header files, defaults to 'include'.
Optional names of the resulting interface libraries.
Optional name of the output subdirectory with the library files, defaults to 'lib'.
Optional names of the resulting shared libraries.
Optional names of the resulting static libraries. Note that if
out_binaries are not set, default
lib_name.lib static library is assumed
Optional part of the shell script to be added after the make commands
A list of targets with in the foreign build system to produce. An empty string (
"") will result in a call to the underlying build system with no explicit target set
Optional tools to be copied into the directory structure. Similar to deps, those directly required for the external building of the library/binaries.