2c4a9779cd
LLNDK version will be decoupled from SDK version. The ABI checker loads the reference ABI dumps from prebuilts/abi-dumps/vndk/<VendorApiLevel>. Test: m libnativewindow Bug: 314010764 Change-Id: I3e9f2cab58db0d1cc42f8c1abc13968617dacf14
2359 lines
89 KiB
Go
2359 lines
89 KiB
Go
// Copyright 2016 Google Inc. All rights reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package cc
|
|
|
|
import (
|
|
"fmt"
|
|
"io"
|
|
"log"
|
|
"path/filepath"
|
|
"regexp"
|
|
"strconv"
|
|
"strings"
|
|
"sync"
|
|
|
|
"android/soong/android"
|
|
|
|
"github.com/google/blueprint"
|
|
"github.com/google/blueprint/pathtools"
|
|
"github.com/google/blueprint/proptools"
|
|
)
|
|
|
|
// LibraryProperties is a collection of properties shared by cc library rules/cc.
|
|
type LibraryProperties struct {
|
|
// local file name to pass to the linker as -unexported_symbols_list
|
|
Unexported_symbols_list *string `android:"path,arch_variant"`
|
|
// local file name to pass to the linker as -force_symbols_not_weak_list
|
|
Force_symbols_not_weak_list *string `android:"path,arch_variant"`
|
|
// local file name to pass to the linker as -force_symbols_weak_list
|
|
Force_symbols_weak_list *string `android:"path,arch_variant"`
|
|
|
|
// rename host libraries to prevent overlap with system installed libraries
|
|
Unique_host_soname *bool
|
|
|
|
Aidl struct {
|
|
// export headers generated from .aidl sources
|
|
Export_aidl_headers *bool
|
|
}
|
|
|
|
Proto struct {
|
|
// export headers generated from .proto sources
|
|
Export_proto_headers *bool
|
|
}
|
|
|
|
Sysprop struct {
|
|
// Whether platform owns this sysprop library.
|
|
Platform *bool
|
|
} `blueprint:"mutated"`
|
|
|
|
Static_ndk_lib *bool
|
|
|
|
// Generate stubs to make this library accessible to APEXes.
|
|
Stubs struct {
|
|
// Relative path to the symbol map. The symbol map provides the list of
|
|
// symbols that are exported for stubs variant of this library.
|
|
Symbol_file *string `android:"path"`
|
|
|
|
// List versions to generate stubs libs for. The version name "current" is always
|
|
// implicitly added.
|
|
Versions []string
|
|
|
|
// Whether to not require the implementation of the library to be installed if a
|
|
// client of the stubs is installed. Defaults to true; set to false if the
|
|
// implementation is made available by some other means, e.g. in a Microdroid
|
|
// virtual machine.
|
|
Implementation_installable *bool
|
|
}
|
|
|
|
// set the name of the output
|
|
Stem *string `android:"arch_variant"`
|
|
|
|
// set suffix of the name of the output
|
|
Suffix *string `android:"arch_variant"`
|
|
|
|
// Properties for ABI compatibility checker.
|
|
Header_abi_checker headerAbiCheckerProperties
|
|
|
|
Target struct {
|
|
Vendor, Product struct {
|
|
// set suffix of the name of the output
|
|
Suffix *string `android:"arch_variant"`
|
|
|
|
Header_abi_checker headerAbiCheckerProperties
|
|
|
|
// Disable stubs for vendor/product variants
|
|
// This is a workaround to keep `stubs` only for "core" variant (not product/vendor).
|
|
// It would be nice if we could put `stubs` into a `target: { core: {} }`
|
|
// block but it's not supported in soong yet. This could be removed/simplified once we have
|
|
// a better syntax.
|
|
No_stubs bool
|
|
}
|
|
|
|
Platform struct {
|
|
Header_abi_checker headerAbiCheckerProperties
|
|
}
|
|
}
|
|
|
|
// Names of modules to be overridden. Listed modules can only be other shared libraries
|
|
// (in Make or Soong).
|
|
// This does not completely prevent installation of the overridden libraries, but if both
|
|
// binaries would be installed by default (in PRODUCT_PACKAGES) the other library will be removed
|
|
// from PRODUCT_PACKAGES.
|
|
Overrides []string
|
|
|
|
// Inject boringssl hash into the shared library. This is only intended for use by external/boringssl.
|
|
Inject_bssl_hash *bool `android:"arch_variant"`
|
|
|
|
// If this is an LLNDK library, properties to describe the LLNDK stubs. Will be copied from
|
|
// the module pointed to by llndk_stubs if it is set.
|
|
Llndk llndkLibraryProperties
|
|
|
|
// If this is a vendor public library, properties to describe the vendor public library stubs.
|
|
Vendor_public_library vendorPublicLibraryProperties
|
|
}
|
|
|
|
// StaticProperties is a properties stanza to affect only attributes of the "static" variants of a
|
|
// library module.
|
|
type StaticProperties struct {
|
|
Static StaticOrSharedProperties `android:"arch_variant"`
|
|
}
|
|
|
|
// SharedProperties is a properties stanza to affect only attributes of the "shared" variants of a
|
|
// library module.
|
|
type SharedProperties struct {
|
|
Shared StaticOrSharedProperties `android:"arch_variant"`
|
|
}
|
|
|
|
// StaticOrSharedProperties is an embedded struct representing properties to affect attributes of
|
|
// either only the "static" variants or only the "shared" variants of a library module. These override
|
|
// the base properties of the same name.
|
|
// Use `StaticProperties` or `SharedProperties`, depending on which variant is needed.
|
|
// `StaticOrSharedProperties` exists only to avoid duplication.
|
|
type StaticOrSharedProperties struct {
|
|
Srcs []string `android:"path,arch_variant"`
|
|
|
|
Tidy_disabled_srcs []string `android:"path,arch_variant"`
|
|
|
|
Tidy_timeout_srcs []string `android:"path,arch_variant"`
|
|
|
|
Sanitized Sanitized `android:"arch_variant"`
|
|
|
|
Cflags []string `android:"arch_variant"`
|
|
|
|
Enabled *bool `android:"arch_variant"`
|
|
Whole_static_libs []string `android:"arch_variant"`
|
|
Static_libs []string `android:"arch_variant"`
|
|
Shared_libs []string `android:"arch_variant"`
|
|
System_shared_libs []string `android:"arch_variant"`
|
|
|
|
Export_shared_lib_headers []string `android:"arch_variant"`
|
|
Export_static_lib_headers []string `android:"arch_variant"`
|
|
|
|
Apex_available []string `android:"arch_variant"`
|
|
|
|
Installable *bool `android:"arch_variant"`
|
|
}
|
|
|
|
type LibraryMutatedProperties struct {
|
|
// Build a static variant
|
|
BuildStatic bool `blueprint:"mutated"`
|
|
// Build a shared variant
|
|
BuildShared bool `blueprint:"mutated"`
|
|
// This variant is shared
|
|
VariantIsShared bool `blueprint:"mutated"`
|
|
// This variant is static
|
|
VariantIsStatic bool `blueprint:"mutated"`
|
|
|
|
// This variant is a stubs lib
|
|
BuildStubs bool `blueprint:"mutated"`
|
|
// This variant is the latest version
|
|
IsLatestVersion bool `blueprint:"mutated"`
|
|
// Version of the stubs lib
|
|
StubsVersion string `blueprint:"mutated"`
|
|
// List of all stubs versions associated with an implementation lib
|
|
AllStubsVersions []string `blueprint:"mutated"`
|
|
}
|
|
|
|
type FlagExporterProperties struct {
|
|
// list of directories relative to the Blueprints file that will
|
|
// be added to the include path (using -I) for this module and any module that links
|
|
// against this module. Directories listed in export_include_dirs do not need to be
|
|
// listed in local_include_dirs.
|
|
Export_include_dirs []string `android:"arch_variant,variant_prepend"`
|
|
|
|
// list of directories that will be added to the system include path
|
|
// using -isystem for this module and any module that links against this module.
|
|
Export_system_include_dirs []string `android:"arch_variant,variant_prepend"`
|
|
|
|
Target struct {
|
|
Vendor, Product struct {
|
|
// list of exported include directories, like
|
|
// export_include_dirs, that will be applied to
|
|
// vendor or product variant of this library.
|
|
// This will overwrite any other declarations.
|
|
Override_export_include_dirs []string
|
|
}
|
|
}
|
|
}
|
|
|
|
func init() {
|
|
RegisterLibraryBuildComponents(android.InitRegistrationContext)
|
|
}
|
|
|
|
func RegisterLibraryBuildComponents(ctx android.RegistrationContext) {
|
|
ctx.RegisterModuleType("cc_library_static", LibraryStaticFactory)
|
|
ctx.RegisterModuleType("cc_library_shared", LibrarySharedFactory)
|
|
ctx.RegisterModuleType("cc_library", LibraryFactory)
|
|
ctx.RegisterModuleType("cc_library_host_static", LibraryHostStaticFactory)
|
|
ctx.RegisterModuleType("cc_library_host_shared", LibraryHostSharedFactory)
|
|
}
|
|
|
|
// 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.
|
|
func LibraryFactory() android.Module {
|
|
module, _ := NewLibrary(android.HostAndDeviceSupported)
|
|
// Can be used as both a static and a shared library.
|
|
module.sdkMemberTypes = []android.SdkMemberType{
|
|
sharedLibrarySdkMemberType,
|
|
staticLibrarySdkMemberType,
|
|
staticAndSharedLibrarySdkMemberType,
|
|
}
|
|
return module.Init()
|
|
}
|
|
|
|
// cc_library_static creates a static library for a device and/or host binary.
|
|
func LibraryStaticFactory() android.Module {
|
|
module, library := NewLibrary(android.HostAndDeviceSupported)
|
|
library.BuildOnlyStatic()
|
|
module.sdkMemberTypes = []android.SdkMemberType{staticLibrarySdkMemberType}
|
|
return module.Init()
|
|
}
|
|
|
|
// cc_library_shared creates a shared library for a device and/or host.
|
|
func LibrarySharedFactory() android.Module {
|
|
module, library := NewLibrary(android.HostAndDeviceSupported)
|
|
library.BuildOnlyShared()
|
|
module.sdkMemberTypes = []android.SdkMemberType{sharedLibrarySdkMemberType}
|
|
return module.Init()
|
|
}
|
|
|
|
// cc_library_host_static creates a static library that is linkable to a host
|
|
// binary.
|
|
func LibraryHostStaticFactory() android.Module {
|
|
module, library := NewLibrary(android.HostSupported)
|
|
library.BuildOnlyStatic()
|
|
module.sdkMemberTypes = []android.SdkMemberType{staticLibrarySdkMemberType}
|
|
return module.Init()
|
|
}
|
|
|
|
// cc_library_host_shared creates a shared library that is usable on a host.
|
|
func LibraryHostSharedFactory() android.Module {
|
|
module, library := NewLibrary(android.HostSupported)
|
|
library.BuildOnlyShared()
|
|
module.sdkMemberTypes = []android.SdkMemberType{sharedLibrarySdkMemberType}
|
|
return module.Init()
|
|
}
|
|
|
|
// flagExporter is a separated portion of libraryDecorator pertaining to exported
|
|
// include paths and flags. Keeping this dependency-related information separate
|
|
// from the rest of library information is helpful in keeping data more structured
|
|
// and explicit.
|
|
type flagExporter struct {
|
|
Properties FlagExporterProperties
|
|
|
|
dirs android.Paths // Include directories to be included with -I
|
|
systemDirs android.Paths // System include directories to be included with -isystem
|
|
flags []string // Exported raw flags.
|
|
deps android.Paths
|
|
headers android.Paths
|
|
}
|
|
|
|
// exportedIncludes returns the effective include paths for this module and
|
|
// any module that links against this module. This is obtained from
|
|
// the export_include_dirs property in the appropriate target stanza.
|
|
func (f *flagExporter) exportedIncludes(ctx ModuleContext) android.Paths {
|
|
if ctx.inVendor() && f.Properties.Target.Vendor.Override_export_include_dirs != nil {
|
|
return android.PathsForModuleSrc(ctx, f.Properties.Target.Vendor.Override_export_include_dirs)
|
|
}
|
|
if ctx.inProduct() && f.Properties.Target.Product.Override_export_include_dirs != nil {
|
|
return android.PathsForModuleSrc(ctx, f.Properties.Target.Product.Override_export_include_dirs)
|
|
}
|
|
return android.PathsForModuleSrc(ctx, f.Properties.Export_include_dirs)
|
|
}
|
|
|
|
// exportIncludes registers the include directories and system include directories to be exported
|
|
// transitively to modules depending on this module.
|
|
func (f *flagExporter) exportIncludes(ctx ModuleContext) {
|
|
f.dirs = append(f.dirs, f.exportedIncludes(ctx)...)
|
|
f.systemDirs = append(f.systemDirs, android.PathsForModuleSrc(ctx, f.Properties.Export_system_include_dirs)...)
|
|
}
|
|
|
|
// exportIncludesAsSystem registers the include directories and system include directories to be
|
|
// exported transitively both as system include directories to modules depending on this module.
|
|
func (f *flagExporter) exportIncludesAsSystem(ctx ModuleContext) {
|
|
// all dirs are force exported as system
|
|
f.systemDirs = append(f.systemDirs, f.exportedIncludes(ctx)...)
|
|
f.systemDirs = append(f.systemDirs, android.PathsForModuleSrc(ctx, f.Properties.Export_system_include_dirs)...)
|
|
}
|
|
|
|
// reexportDirs registers the given directories as include directories to be exported transitively
|
|
// to modules depending on this module.
|
|
func (f *flagExporter) reexportDirs(dirs ...android.Path) {
|
|
f.dirs = append(f.dirs, dirs...)
|
|
}
|
|
|
|
// reexportSystemDirs registers the given directories as system include directories
|
|
// to be exported transitively to modules depending on this module.
|
|
func (f *flagExporter) reexportSystemDirs(dirs ...android.Path) {
|
|
f.systemDirs = append(f.systemDirs, dirs...)
|
|
}
|
|
|
|
// reexportFlags registers the flags to be exported transitively to modules depending on this
|
|
// module.
|
|
func (f *flagExporter) reexportFlags(flags ...string) {
|
|
if android.PrefixInList(flags, "-I") || android.PrefixInList(flags, "-isystem") {
|
|
panic(fmt.Errorf("Exporting invalid flag %q: "+
|
|
"use reexportDirs or reexportSystemDirs to export directories", flag))
|
|
}
|
|
f.flags = append(f.flags, flags...)
|
|
}
|
|
|
|
func (f *flagExporter) reexportDeps(deps ...android.Path) {
|
|
f.deps = append(f.deps, deps...)
|
|
}
|
|
|
|
// addExportedGeneratedHeaders does nothing but collects generated header files.
|
|
// This can be differ to exportedDeps which may contain phony files to minimize ninja.
|
|
func (f *flagExporter) addExportedGeneratedHeaders(headers ...android.Path) {
|
|
f.headers = append(f.headers, headers...)
|
|
}
|
|
|
|
func (f *flagExporter) setProvider(ctx android.ModuleContext) {
|
|
android.SetProvider(ctx, FlagExporterInfoProvider, FlagExporterInfo{
|
|
// Comes from Export_include_dirs property, and those of exported transitive deps
|
|
IncludeDirs: android.FirstUniquePaths(f.dirs),
|
|
// Comes from Export_system_include_dirs property, and those of exported transitive deps
|
|
SystemIncludeDirs: android.FirstUniquePaths(f.systemDirs),
|
|
// Used in very few places as a one-off way of adding extra defines.
|
|
Flags: f.flags,
|
|
// Used sparingly, for extra files that need to be explicitly exported to dependers,
|
|
// or for phony files to minimize ninja.
|
|
Deps: f.deps,
|
|
// For exported generated headers, such as exported aidl headers, proto headers, or
|
|
// sysprop headers.
|
|
GeneratedHeaders: f.headers,
|
|
})
|
|
}
|
|
|
|
// libraryDecorator wraps baseCompiler, baseLinker and baseInstaller to provide library-specific
|
|
// functionality: static vs. shared linkage, reusing object files for shared libraries
|
|
type libraryDecorator struct {
|
|
Properties LibraryProperties
|
|
StaticProperties StaticProperties
|
|
SharedProperties SharedProperties
|
|
MutatedProperties LibraryMutatedProperties
|
|
|
|
// For reusing static library objects for shared library
|
|
reuseObjects Objects
|
|
|
|
// table-of-contents file to optimize out relinking when possible
|
|
tocFile android.OptionalPath
|
|
|
|
flagExporter
|
|
flagExporterInfo *FlagExporterInfo
|
|
stripper Stripper
|
|
|
|
// For whole_static_libs
|
|
objects Objects
|
|
wholeStaticLibsFromPrebuilts android.Paths
|
|
|
|
// Uses the module's name if empty, but can be overridden. Does not include
|
|
// shlib suffix.
|
|
libName string
|
|
|
|
sabi *sabi
|
|
|
|
// Output archive of gcno coverage information files
|
|
coverageOutputFile android.OptionalPath
|
|
|
|
// linked Source Abi Dump
|
|
sAbiOutputFile android.OptionalPath
|
|
|
|
// Source Abi Diff
|
|
sAbiDiff android.Paths
|
|
|
|
// Location of the static library in the sysroot. Empty if the library is
|
|
// not included in the NDK.
|
|
ndkSysrootPath android.Path
|
|
|
|
// Location of the linked, unstripped library for shared libraries
|
|
unstrippedOutputFile android.Path
|
|
// Location of the linked, stripped library for shared libraries, strip: "all"
|
|
strippedAllOutputFile android.Path
|
|
|
|
// Location of the file that should be copied to dist dir when requested
|
|
distFile android.Path
|
|
|
|
versionScriptPath android.OptionalPath
|
|
|
|
postInstallCmds []string
|
|
|
|
// If useCoreVariant is true, the vendor variant of a VNDK library is
|
|
// not installed.
|
|
useCoreVariant bool
|
|
checkSameCoreVariant bool
|
|
|
|
skipAPIDefine bool
|
|
|
|
// Decorated interfaces
|
|
*baseCompiler
|
|
*baseLinker
|
|
*baseInstaller
|
|
|
|
collectedSnapshotHeaders android.Paths
|
|
|
|
apiListCoverageXmlPath android.ModuleOutPath
|
|
}
|
|
|
|
func GlobHeadersForSnapshot(ctx android.ModuleContext, paths android.Paths) android.Paths {
|
|
ret := android.Paths{}
|
|
|
|
// Headers in the source tree should be globbed. On the contrast, generated headers
|
|
// can't be globbed, and they should be manually collected.
|
|
// So, we first filter out intermediate directories (which contains generated headers)
|
|
// from exported directories, and then glob headers under remaining directories.
|
|
for _, path := range paths {
|
|
dir := path.String()
|
|
// Skip if dir is for generated headers
|
|
if strings.HasPrefix(dir, ctx.Config().OutDir()) {
|
|
continue
|
|
}
|
|
|
|
// libeigen wrongly exports the root directory "external/eigen". But only two
|
|
// subdirectories "Eigen" and "unsupported" contain exported header files. Even worse
|
|
// some of them have no extension. So we need special treatment for libeigen in order
|
|
// to glob correctly.
|
|
if dir == "external/eigen" {
|
|
// Only these two directories contains exported headers.
|
|
for _, subdir := range []string{"Eigen", "unsupported/Eigen"} {
|
|
globDir := "external/eigen/" + subdir + "/**/*"
|
|
glob, err := ctx.GlobWithDeps(globDir, nil)
|
|
if err != nil {
|
|
ctx.ModuleErrorf("glob of %q failed: %s", globDir, err)
|
|
return nil
|
|
}
|
|
for _, header := range glob {
|
|
if strings.HasSuffix(header, "/") {
|
|
continue
|
|
}
|
|
ext := filepath.Ext(header)
|
|
if ext != "" && ext != ".h" {
|
|
continue
|
|
}
|
|
ret = append(ret, android.PathForSource(ctx, header))
|
|
}
|
|
}
|
|
continue
|
|
}
|
|
globDir := dir + "/**/*"
|
|
glob, err := ctx.GlobWithDeps(globDir, nil)
|
|
if err != nil {
|
|
ctx.ModuleErrorf("glob of %q failed: %s", globDir, err)
|
|
return nil
|
|
}
|
|
isLibcxx := strings.HasPrefix(dir, "external/libcxx/include")
|
|
for _, header := range glob {
|
|
if isLibcxx {
|
|
// Glob all files under this special directory, because of C++ headers with no
|
|
// extension.
|
|
if strings.HasSuffix(header, "/") {
|
|
continue
|
|
}
|
|
} else {
|
|
// Filter out only the files with extensions that are headers.
|
|
found := false
|
|
for _, ext := range HeaderExts {
|
|
if strings.HasSuffix(header, ext) {
|
|
found = true
|
|
break
|
|
}
|
|
}
|
|
if !found {
|
|
continue
|
|
}
|
|
}
|
|
ret = append(ret, android.PathForSource(ctx, header))
|
|
}
|
|
}
|
|
return ret
|
|
}
|
|
|
|
func GlobGeneratedHeadersForSnapshot(_ android.ModuleContext, paths android.Paths) android.Paths {
|
|
ret := android.Paths{}
|
|
for _, header := range paths {
|
|
// TODO(b/148123511): remove exportedDeps after cleaning up genrule
|
|
if strings.HasSuffix(header.Base(), "-phony") {
|
|
continue
|
|
}
|
|
ret = append(ret, header)
|
|
}
|
|
return ret
|
|
}
|
|
|
|
// collectHeadersForSnapshot collects all exported headers from library.
|
|
// It globs header files in the source tree for exported include directories,
|
|
// and tracks generated header files separately.
|
|
//
|
|
// This is to be called from GenerateAndroidBuildActions, and then collected
|
|
// header files can be retrieved by snapshotHeaders().
|
|
func (l *libraryDecorator) collectHeadersForSnapshot(ctx android.ModuleContext) {
|
|
ret := android.Paths{}
|
|
|
|
// Headers in the source tree should be globbed. On the contrast, generated headers
|
|
// can't be globbed, and they should be manually collected.
|
|
// So, we first filter out intermediate directories (which contains generated headers)
|
|
// from exported directories, and then glob headers under remaining directories.
|
|
ret = append(ret, GlobHeadersForSnapshot(ctx, append(android.CopyOfPaths(l.flagExporter.dirs), l.flagExporter.systemDirs...))...)
|
|
|
|
// Collect generated headers
|
|
ret = append(ret, GlobGeneratedHeadersForSnapshot(ctx, append(android.CopyOfPaths(l.flagExporter.headers), l.flagExporter.deps...))...)
|
|
|
|
l.collectedSnapshotHeaders = ret
|
|
}
|
|
|
|
// This returns all exported header files, both generated ones and headers from source tree.
|
|
// collectHeadersForSnapshot() must be called before calling this.
|
|
func (l *libraryDecorator) snapshotHeaders() android.Paths {
|
|
if l.collectedSnapshotHeaders == nil {
|
|
panic("snapshotHeaders() must be called after collectHeadersForSnapshot()")
|
|
}
|
|
return l.collectedSnapshotHeaders
|
|
}
|
|
|
|
// linkerProps returns the list of properties structs relevant for this library. (For example, if
|
|
// the library is cc_shared_library, then static-library properties are omitted.)
|
|
func (library *libraryDecorator) linkerProps() []interface{} {
|
|
var props []interface{}
|
|
props = append(props, library.baseLinker.linkerProps()...)
|
|
props = append(props,
|
|
&library.Properties,
|
|
&library.MutatedProperties,
|
|
&library.flagExporter.Properties,
|
|
&library.stripper.StripProperties)
|
|
|
|
if library.MutatedProperties.BuildShared {
|
|
props = append(props, &library.SharedProperties)
|
|
}
|
|
if library.MutatedProperties.BuildStatic {
|
|
props = append(props, &library.StaticProperties)
|
|
}
|
|
|
|
return props
|
|
}
|
|
|
|
// linkerFlags takes a Flags struct and augments it to contain linker flags that are defined by this
|
|
// library, or that are implied by attributes of this library (such as whether this library is a
|
|
// shared library).
|
|
func (library *libraryDecorator) linkerFlags(ctx ModuleContext, flags Flags) Flags {
|
|
flags = library.baseLinker.linkerFlags(ctx, flags)
|
|
|
|
// MinGW spits out warnings about -fPIC even for -fpie?!) being ignored because
|
|
// all code is position independent, and then those warnings get promoted to
|
|
// errors.
|
|
if !ctx.Windows() {
|
|
flags.Global.CFlags = append(flags.Global.CFlags, "-fPIC")
|
|
}
|
|
|
|
if library.static() {
|
|
flags.Local.CFlags = append(flags.Local.CFlags, library.StaticProperties.Static.Cflags...)
|
|
} else if library.shared() {
|
|
flags.Local.CFlags = append(flags.Local.CFlags, library.SharedProperties.Shared.Cflags...)
|
|
}
|
|
|
|
if library.shared() {
|
|
libName := library.getLibName(ctx)
|
|
var f []string
|
|
if ctx.toolchain().Bionic() {
|
|
f = append(f,
|
|
"-nostdlib",
|
|
"-Wl,--gc-sections",
|
|
)
|
|
}
|
|
|
|
if ctx.Darwin() {
|
|
f = append(f,
|
|
"-dynamiclib",
|
|
"-install_name @rpath/"+libName+flags.Toolchain.ShlibSuffix(),
|
|
)
|
|
if ctx.Arch().ArchType == android.X86 {
|
|
f = append(f,
|
|
"-read_only_relocs suppress",
|
|
)
|
|
}
|
|
} else {
|
|
f = append(f, "-shared")
|
|
if !ctx.Windows() {
|
|
f = append(f, "-Wl,-soname,"+libName+flags.Toolchain.ShlibSuffix())
|
|
}
|
|
}
|
|
|
|
flags.Global.LdFlags = append(flags.Global.LdFlags, f...)
|
|
}
|
|
|
|
return flags
|
|
}
|
|
|
|
// compilerFlags takes a Flags and augments it to contain compile flags from global values,
|
|
// per-target values, module type values, per-module Blueprints properties, extra flags from
|
|
// `flags`, and generated sources from `deps`.
|
|
func (library *libraryDecorator) compilerFlags(ctx ModuleContext, flags Flags, deps PathDeps) Flags {
|
|
exportIncludeDirs := library.flagExporter.exportedIncludes(ctx)
|
|
if len(exportIncludeDirs) > 0 {
|
|
f := includeDirsToFlags(exportIncludeDirs)
|
|
flags.Local.CommonFlags = append(flags.Local.CommonFlags, f)
|
|
flags.Local.YasmFlags = append(flags.Local.YasmFlags, f)
|
|
}
|
|
|
|
flags = library.baseCompiler.compilerFlags(ctx, flags, deps)
|
|
if ctx.IsLlndk() {
|
|
// LLNDK libraries ignore most of the properties on the cc_library and use the
|
|
// LLNDK-specific properties instead.
|
|
// Wipe all the module-local properties, leaving only the global properties.
|
|
flags.Local = LocalOrGlobalFlags{}
|
|
}
|
|
if library.buildStubs() {
|
|
// Remove -include <file> when compiling stubs. Otherwise, the force included
|
|
// headers might cause conflicting types error with the symbols in the
|
|
// generated stubs source code. e.g.
|
|
// double acos(double); // in header
|
|
// void acos() {} // in the generated source code
|
|
removeInclude := func(flags []string) []string {
|
|
ret := flags[:0]
|
|
for _, f := range flags {
|
|
if strings.HasPrefix(f, "-include ") {
|
|
continue
|
|
}
|
|
ret = append(ret, f)
|
|
}
|
|
return ret
|
|
}
|
|
flags.Local.CommonFlags = removeInclude(flags.Local.CommonFlags)
|
|
flags.Local.CFlags = removeInclude(flags.Local.CFlags)
|
|
|
|
flags = addStubLibraryCompilerFlags(flags)
|
|
}
|
|
return flags
|
|
}
|
|
|
|
func (library *libraryDecorator) getHeaderAbiCheckerProperties(ctx android.BaseModuleContext) headerAbiCheckerProperties {
|
|
m := ctx.Module().(*Module)
|
|
variantProps := &library.Properties.Target.Platform.Header_abi_checker
|
|
if m.InVendor() {
|
|
variantProps = &library.Properties.Target.Vendor.Header_abi_checker
|
|
} else if m.InProduct() {
|
|
variantProps = &library.Properties.Target.Product.Header_abi_checker
|
|
}
|
|
props := library.Properties.Header_abi_checker
|
|
err := proptools.AppendProperties(&props, variantProps, nil)
|
|
if err != nil {
|
|
ctx.ModuleErrorf("Cannot merge headerAbiCheckerProperties: %s", err.Error())
|
|
}
|
|
return props
|
|
}
|
|
|
|
func (library *libraryDecorator) compile(ctx ModuleContext, flags Flags, deps PathDeps) Objects {
|
|
if ctx.IsLlndk() {
|
|
// This is the vendor variant of an LLNDK library, build the LLNDK stubs.
|
|
vndkVer := ctx.Module().(*Module).VndkVersion()
|
|
if !inList(vndkVer, ctx.Config().PlatformVersionActiveCodenames()) || vndkVer == "" {
|
|
// For non-enforcing devices, vndkVer is empty. Use "current" in that case, too.
|
|
vndkVer = "current"
|
|
}
|
|
if library.stubsVersion() != "" {
|
|
vndkVer = library.stubsVersion()
|
|
}
|
|
nativeAbiResult := parseNativeAbiDefinition(ctx,
|
|
String(library.Properties.Llndk.Symbol_file),
|
|
android.ApiLevelOrPanic(ctx, vndkVer), "--llndk")
|
|
objs := compileStubLibrary(ctx, flags, nativeAbiResult.stubSrc)
|
|
if !Bool(library.Properties.Llndk.Unversioned) {
|
|
library.versionScriptPath = android.OptionalPathForPath(
|
|
nativeAbiResult.versionScript)
|
|
}
|
|
return objs
|
|
}
|
|
if ctx.IsVendorPublicLibrary() {
|
|
nativeAbiResult := parseNativeAbiDefinition(ctx,
|
|
String(library.Properties.Vendor_public_library.Symbol_file),
|
|
android.FutureApiLevel, "")
|
|
objs := compileStubLibrary(ctx, flags, nativeAbiResult.stubSrc)
|
|
if !Bool(library.Properties.Vendor_public_library.Unversioned) {
|
|
library.versionScriptPath = android.OptionalPathForPath(nativeAbiResult.versionScript)
|
|
}
|
|
return objs
|
|
}
|
|
if library.buildStubs() {
|
|
symbolFile := String(library.Properties.Stubs.Symbol_file)
|
|
if symbolFile != "" && !strings.HasSuffix(symbolFile, ".map.txt") {
|
|
ctx.PropertyErrorf("symbol_file", "%q doesn't have .map.txt suffix", symbolFile)
|
|
return Objects{}
|
|
}
|
|
// b/239274367 --apex and --systemapi filters symbols tagged with # apex and #
|
|
// systemapi, respectively. The former is for symbols defined in platform libraries
|
|
// and the latter is for symbols defined in APEXes.
|
|
// A single library can contain either # apex or # systemapi, but not both.
|
|
// The stub generator (ndkstubgen) is additive, so passing _both_ of these to it should be a no-op.
|
|
// However, having this distinction helps guard accidental
|
|
// promotion or demotion of API and also helps the API review process b/191371676
|
|
var flag string
|
|
if ctx.Module().(android.ApexModule).NotInPlatform() {
|
|
flag = "--apex"
|
|
} else {
|
|
flag = "--systemapi"
|
|
}
|
|
// b/184712170, unless the lib is an NDK library, exclude all public symbols from
|
|
// the stub so that it is mandated that all symbols are explicitly marked with
|
|
// either apex or systemapi.
|
|
if !ctx.Module().(*Module).IsNdk(ctx.Config()) {
|
|
flag = flag + " --no-ndk"
|
|
}
|
|
nativeAbiResult := parseNativeAbiDefinition(ctx, symbolFile,
|
|
android.ApiLevelOrPanic(ctx, library.MutatedProperties.StubsVersion), flag)
|
|
objs := compileStubLibrary(ctx, flags, nativeAbiResult.stubSrc)
|
|
library.versionScriptPath = android.OptionalPathForPath(
|
|
nativeAbiResult.versionScript)
|
|
|
|
// Parse symbol file to get API list for coverage
|
|
if library.stubsVersion() == "current" && ctx.PrimaryArch() && !ctx.inRecovery() && !ctx.inProduct() && !ctx.inVendor() {
|
|
library.apiListCoverageXmlPath = parseSymbolFileForAPICoverage(ctx, symbolFile)
|
|
}
|
|
|
|
return objs
|
|
}
|
|
|
|
if !library.buildShared() && !library.buildStatic() {
|
|
if len(library.baseCompiler.Properties.Srcs) > 0 {
|
|
ctx.PropertyErrorf("srcs", "cc_library_headers must not have any srcs")
|
|
}
|
|
if len(library.StaticProperties.Static.Srcs) > 0 {
|
|
ctx.PropertyErrorf("static.srcs", "cc_library_headers must not have any srcs")
|
|
}
|
|
if len(library.SharedProperties.Shared.Srcs) > 0 {
|
|
ctx.PropertyErrorf("shared.srcs", "cc_library_headers must not have any srcs")
|
|
}
|
|
return Objects{}
|
|
}
|
|
if library.sabi.shouldCreateSourceAbiDump() {
|
|
exportIncludeDirs := library.flagExporter.exportedIncludes(ctx)
|
|
var SourceAbiFlags []string
|
|
for _, dir := range exportIncludeDirs.Strings() {
|
|
SourceAbiFlags = append(SourceAbiFlags, "-I"+dir)
|
|
}
|
|
for _, reexportedInclude := range library.sabi.Properties.ReexportedIncludes {
|
|
SourceAbiFlags = append(SourceAbiFlags, "-I"+reexportedInclude)
|
|
}
|
|
flags.SAbiFlags = SourceAbiFlags
|
|
totalLength := len(library.baseCompiler.Properties.Srcs) + len(deps.GeneratedSources) +
|
|
len(library.SharedProperties.Shared.Srcs) + len(library.StaticProperties.Static.Srcs)
|
|
if totalLength > 0 {
|
|
flags.SAbiDump = true
|
|
}
|
|
}
|
|
objs := library.baseCompiler.compile(ctx, flags, deps)
|
|
library.reuseObjects = objs
|
|
buildFlags := flagsToBuilderFlags(flags)
|
|
|
|
if library.static() {
|
|
srcs := android.PathsForModuleSrc(ctx, library.StaticProperties.Static.Srcs)
|
|
objs = objs.Append(compileObjs(ctx, buildFlags, android.DeviceStaticLibrary, srcs,
|
|
android.PathsForModuleSrc(ctx, library.StaticProperties.Static.Tidy_disabled_srcs),
|
|
android.PathsForModuleSrc(ctx, library.StaticProperties.Static.Tidy_timeout_srcs),
|
|
library.baseCompiler.pathDeps, library.baseCompiler.cFlagsDeps))
|
|
} else if library.shared() {
|
|
srcs := android.PathsForModuleSrc(ctx, library.SharedProperties.Shared.Srcs)
|
|
objs = objs.Append(compileObjs(ctx, buildFlags, android.DeviceSharedLibrary, srcs,
|
|
android.PathsForModuleSrc(ctx, library.SharedProperties.Shared.Tidy_disabled_srcs),
|
|
android.PathsForModuleSrc(ctx, library.SharedProperties.Shared.Tidy_timeout_srcs),
|
|
library.baseCompiler.pathDeps, library.baseCompiler.cFlagsDeps))
|
|
}
|
|
|
|
return objs
|
|
}
|
|
|
|
type libraryInterface interface {
|
|
versionedInterface
|
|
|
|
static() bool
|
|
shared() bool
|
|
objs() Objects
|
|
reuseObjs() Objects
|
|
toc() android.OptionalPath
|
|
|
|
// Returns true if the build options for the module have selected a static or shared build
|
|
buildStatic() bool
|
|
buildShared() bool
|
|
|
|
// Sets whether a specific variant is static or shared
|
|
setStatic()
|
|
setShared()
|
|
|
|
// Gets the ABI properties for vendor, product, or platform variant
|
|
getHeaderAbiCheckerProperties(ctx android.BaseModuleContext) headerAbiCheckerProperties
|
|
|
|
// Write LOCAL_ADDITIONAL_DEPENDENCIES for ABI diff
|
|
androidMkWriteAdditionalDependenciesForSourceAbiDiff(w io.Writer)
|
|
|
|
availableFor(string) bool
|
|
|
|
getAPIListCoverageXMLPath() android.ModuleOutPath
|
|
|
|
installable() *bool
|
|
}
|
|
|
|
type versionedInterface interface {
|
|
buildStubs() bool
|
|
setBuildStubs(isLatest bool)
|
|
hasStubsVariants() bool
|
|
isStubsImplementationRequired() bool
|
|
setStubsVersion(string)
|
|
stubsVersion() string
|
|
|
|
stubsVersions(ctx android.BaseMutatorContext) []string
|
|
setAllStubsVersions([]string)
|
|
allStubsVersions() []string
|
|
|
|
implementationModuleName(name string) string
|
|
hasLLNDKStubs() bool
|
|
hasLLNDKHeaders() bool
|
|
hasVendorPublicLibrary() bool
|
|
}
|
|
|
|
var _ libraryInterface = (*libraryDecorator)(nil)
|
|
var _ versionedInterface = (*libraryDecorator)(nil)
|
|
|
|
func (library *libraryDecorator) getLibNameHelper(baseModuleName string, inVendor bool, inProduct bool) string {
|
|
name := library.libName
|
|
if name == "" {
|
|
name = String(library.Properties.Stem)
|
|
if name == "" {
|
|
name = baseModuleName
|
|
}
|
|
}
|
|
|
|
suffix := ""
|
|
if inVendor {
|
|
suffix = String(library.Properties.Target.Vendor.Suffix)
|
|
} else if inProduct {
|
|
suffix = String(library.Properties.Target.Product.Suffix)
|
|
}
|
|
if suffix == "" {
|
|
suffix = String(library.Properties.Suffix)
|
|
}
|
|
|
|
return name + suffix
|
|
}
|
|
|
|
// getLibName returns the actual canonical name of the library (the name which
|
|
// should be passed to the linker via linker flags).
|
|
func (library *libraryDecorator) getLibName(ctx BaseModuleContext) string {
|
|
name := library.getLibNameHelper(ctx.baseModuleName(), ctx.inVendor(), ctx.inProduct())
|
|
|
|
// Replace name with VNDK ext as original lib only when VNDK is enabled
|
|
if ctx.IsVndkExt() {
|
|
if ctx.DeviceConfig().VndkVersion() != "" {
|
|
// vndk-ext lib should have the same name with original lib
|
|
ctx.VisitDirectDepsWithTag(vndkExtDepTag, func(module android.Module) {
|
|
originalName := module.(*Module).outputFile.Path()
|
|
name = strings.TrimSuffix(originalName.Base(), originalName.Ext())
|
|
})
|
|
} else {
|
|
// TODO(b/320208784) : Suggest a solution for former VNDK-ext libraries before VNDK deprecation.
|
|
log.Printf("VNDK Extension on module %s will not be available once VNDK is deprecated", ctx.baseModuleName())
|
|
}
|
|
}
|
|
|
|
if ctx.Host() && Bool(library.Properties.Unique_host_soname) {
|
|
if !strings.HasSuffix(name, "-host") {
|
|
name = name + "-host"
|
|
}
|
|
}
|
|
|
|
return name
|
|
}
|
|
|
|
var versioningMacroNamesListMutex sync.Mutex
|
|
|
|
func (library *libraryDecorator) linkerInit(ctx BaseModuleContext) {
|
|
location := InstallInSystem
|
|
if library.baseLinker.sanitize.inSanitizerDir() {
|
|
location = InstallInSanitizerDir
|
|
}
|
|
library.baseInstaller.location = location
|
|
library.baseLinker.linkerInit(ctx)
|
|
// Let baseLinker know whether this variant is for stubs or not, so that
|
|
// it can omit things that are not required for linking stubs.
|
|
library.baseLinker.dynamicProperties.BuildStubs = library.buildStubs()
|
|
|
|
if library.buildStubs() {
|
|
macroNames := versioningMacroNamesList(ctx.Config())
|
|
myName := versioningMacroName(ctx.ModuleName())
|
|
versioningMacroNamesListMutex.Lock()
|
|
defer versioningMacroNamesListMutex.Unlock()
|
|
if (*macroNames)[myName] == "" {
|
|
(*macroNames)[myName] = ctx.ModuleName()
|
|
} else if (*macroNames)[myName] != ctx.ModuleName() {
|
|
ctx.ModuleErrorf("Macro name %q for versioning conflicts with macro name from module %q ", myName, (*macroNames)[myName])
|
|
}
|
|
}
|
|
}
|
|
|
|
func (library *libraryDecorator) compilerDeps(ctx DepsContext, deps Deps) Deps {
|
|
if ctx.IsLlndk() {
|
|
// LLNDK libraries ignore most of the properties on the cc_library and use the
|
|
// LLNDK-specific properties instead.
|
|
return deps
|
|
}
|
|
|
|
deps = library.baseCompiler.compilerDeps(ctx, deps)
|
|
|
|
return deps
|
|
}
|
|
|
|
func (library *libraryDecorator) linkerDeps(ctx DepsContext, deps Deps) Deps {
|
|
if ctx.IsLlndk() {
|
|
// LLNDK libraries ignore most of the properties on the cc_library and use the
|
|
// LLNDK-specific properties instead.
|
|
deps.HeaderLibs = append([]string(nil), library.Properties.Llndk.Export_llndk_headers...)
|
|
deps.ReexportHeaderLibHeaders = append([]string(nil), library.Properties.Llndk.Export_llndk_headers...)
|
|
return deps
|
|
}
|
|
if ctx.IsVendorPublicLibrary() {
|
|
headers := library.Properties.Vendor_public_library.Export_public_headers
|
|
deps.HeaderLibs = append([]string(nil), headers...)
|
|
deps.ReexportHeaderLibHeaders = append([]string(nil), headers...)
|
|
return deps
|
|
}
|
|
|
|
if library.static() {
|
|
// Compare with nil because an empty list needs to be propagated.
|
|
if library.StaticProperties.Static.System_shared_libs != nil {
|
|
library.baseLinker.Properties.System_shared_libs = library.StaticProperties.Static.System_shared_libs
|
|
}
|
|
} else if library.shared() {
|
|
// Compare with nil because an empty list needs to be propagated.
|
|
if library.SharedProperties.Shared.System_shared_libs != nil {
|
|
library.baseLinker.Properties.System_shared_libs = library.SharedProperties.Shared.System_shared_libs
|
|
}
|
|
}
|
|
|
|
deps = library.baseLinker.linkerDeps(ctx, deps)
|
|
|
|
if library.static() {
|
|
deps.WholeStaticLibs = append(deps.WholeStaticLibs,
|
|
library.StaticProperties.Static.Whole_static_libs...)
|
|
deps.StaticLibs = append(deps.StaticLibs, library.StaticProperties.Static.Static_libs...)
|
|
deps.SharedLibs = append(deps.SharedLibs, library.StaticProperties.Static.Shared_libs...)
|
|
|
|
deps.ReexportSharedLibHeaders = append(deps.ReexportSharedLibHeaders, library.StaticProperties.Static.Export_shared_lib_headers...)
|
|
deps.ReexportStaticLibHeaders = append(deps.ReexportStaticLibHeaders, library.StaticProperties.Static.Export_static_lib_headers...)
|
|
} else if library.shared() {
|
|
if library.baseLinker.Properties.crt() {
|
|
deps.CrtBegin = append(deps.CrtBegin, ctx.toolchain().CrtBeginSharedLibrary()...)
|
|
deps.CrtEnd = append(deps.CrtEnd, ctx.toolchain().CrtEndSharedLibrary()...)
|
|
|
|
}
|
|
if library.baseLinker.Properties.crtPadSegment() {
|
|
deps.CrtEnd = append(deps.CrtEnd, ctx.toolchain().CrtPadSegmentSharedLibrary()...)
|
|
}
|
|
deps.WholeStaticLibs = append(deps.WholeStaticLibs, library.SharedProperties.Shared.Whole_static_libs...)
|
|
deps.StaticLibs = append(deps.StaticLibs, library.SharedProperties.Shared.Static_libs...)
|
|
deps.SharedLibs = append(deps.SharedLibs, library.SharedProperties.Shared.Shared_libs...)
|
|
|
|
deps.ReexportSharedLibHeaders = append(deps.ReexportSharedLibHeaders, library.SharedProperties.Shared.Export_shared_lib_headers...)
|
|
deps.ReexportStaticLibHeaders = append(deps.ReexportStaticLibHeaders, library.SharedProperties.Shared.Export_static_lib_headers...)
|
|
}
|
|
if ctx.inVendor() {
|
|
deps.WholeStaticLibs = removeListFromList(deps.WholeStaticLibs, library.baseLinker.Properties.Target.Vendor.Exclude_static_libs)
|
|
deps.SharedLibs = removeListFromList(deps.SharedLibs, library.baseLinker.Properties.Target.Vendor.Exclude_shared_libs)
|
|
deps.StaticLibs = removeListFromList(deps.StaticLibs, library.baseLinker.Properties.Target.Vendor.Exclude_static_libs)
|
|
deps.ReexportSharedLibHeaders = removeListFromList(deps.ReexportSharedLibHeaders, library.baseLinker.Properties.Target.Vendor.Exclude_shared_libs)
|
|
deps.ReexportStaticLibHeaders = removeListFromList(deps.ReexportStaticLibHeaders, library.baseLinker.Properties.Target.Vendor.Exclude_static_libs)
|
|
}
|
|
if ctx.inProduct() {
|
|
deps.WholeStaticLibs = removeListFromList(deps.WholeStaticLibs, library.baseLinker.Properties.Target.Product.Exclude_static_libs)
|
|
deps.SharedLibs = removeListFromList(deps.SharedLibs, library.baseLinker.Properties.Target.Product.Exclude_shared_libs)
|
|
deps.StaticLibs = removeListFromList(deps.StaticLibs, library.baseLinker.Properties.Target.Product.Exclude_static_libs)
|
|
deps.ReexportSharedLibHeaders = removeListFromList(deps.ReexportSharedLibHeaders, library.baseLinker.Properties.Target.Product.Exclude_shared_libs)
|
|
deps.ReexportStaticLibHeaders = removeListFromList(deps.ReexportStaticLibHeaders, library.baseLinker.Properties.Target.Product.Exclude_static_libs)
|
|
}
|
|
if ctx.inRecovery() {
|
|
deps.WholeStaticLibs = removeListFromList(deps.WholeStaticLibs, library.baseLinker.Properties.Target.Recovery.Exclude_static_libs)
|
|
deps.SharedLibs = removeListFromList(deps.SharedLibs, library.baseLinker.Properties.Target.Recovery.Exclude_shared_libs)
|
|
deps.StaticLibs = removeListFromList(deps.StaticLibs, library.baseLinker.Properties.Target.Recovery.Exclude_static_libs)
|
|
deps.ReexportSharedLibHeaders = removeListFromList(deps.ReexportSharedLibHeaders, library.baseLinker.Properties.Target.Recovery.Exclude_shared_libs)
|
|
deps.ReexportStaticLibHeaders = removeListFromList(deps.ReexportStaticLibHeaders, library.baseLinker.Properties.Target.Recovery.Exclude_static_libs)
|
|
}
|
|
if ctx.inRamdisk() {
|
|
deps.WholeStaticLibs = removeListFromList(deps.WholeStaticLibs, library.baseLinker.Properties.Target.Ramdisk.Exclude_static_libs)
|
|
deps.SharedLibs = removeListFromList(deps.SharedLibs, library.baseLinker.Properties.Target.Ramdisk.Exclude_shared_libs)
|
|
deps.StaticLibs = removeListFromList(deps.StaticLibs, library.baseLinker.Properties.Target.Ramdisk.Exclude_static_libs)
|
|
deps.ReexportSharedLibHeaders = removeListFromList(deps.ReexportSharedLibHeaders, library.baseLinker.Properties.Target.Ramdisk.Exclude_shared_libs)
|
|
deps.ReexportStaticLibHeaders = removeListFromList(deps.ReexportStaticLibHeaders, library.baseLinker.Properties.Target.Ramdisk.Exclude_static_libs)
|
|
}
|
|
if ctx.inVendorRamdisk() {
|
|
deps.WholeStaticLibs = removeListFromList(deps.WholeStaticLibs, library.baseLinker.Properties.Target.Vendor_ramdisk.Exclude_static_libs)
|
|
deps.SharedLibs = removeListFromList(deps.SharedLibs, library.baseLinker.Properties.Target.Vendor_ramdisk.Exclude_shared_libs)
|
|
deps.StaticLibs = removeListFromList(deps.StaticLibs, library.baseLinker.Properties.Target.Vendor_ramdisk.Exclude_static_libs)
|
|
deps.ReexportSharedLibHeaders = removeListFromList(deps.ReexportSharedLibHeaders, library.baseLinker.Properties.Target.Vendor_ramdisk.Exclude_shared_libs)
|
|
deps.ReexportStaticLibHeaders = removeListFromList(deps.ReexportStaticLibHeaders, library.baseLinker.Properties.Target.Vendor_ramdisk.Exclude_static_libs)
|
|
}
|
|
|
|
return deps
|
|
}
|
|
|
|
func (library *libraryDecorator) linkerSpecifiedDeps(specifiedDeps specifiedDeps) specifiedDeps {
|
|
specifiedDeps = library.baseLinker.linkerSpecifiedDeps(specifiedDeps)
|
|
var properties StaticOrSharedProperties
|
|
if library.static() {
|
|
properties = library.StaticProperties.Static
|
|
} else if library.shared() {
|
|
properties = library.SharedProperties.Shared
|
|
}
|
|
|
|
specifiedDeps.sharedLibs = append(specifiedDeps.sharedLibs, properties.Shared_libs...)
|
|
|
|
// Must distinguish nil and [] in system_shared_libs - ensure that [] in
|
|
// either input list doesn't come out as nil.
|
|
if specifiedDeps.systemSharedLibs == nil {
|
|
specifiedDeps.systemSharedLibs = properties.System_shared_libs
|
|
} else {
|
|
specifiedDeps.systemSharedLibs = append(specifiedDeps.systemSharedLibs, properties.System_shared_libs...)
|
|
}
|
|
|
|
specifiedDeps.sharedLibs = android.FirstUniqueStrings(specifiedDeps.sharedLibs)
|
|
if len(specifiedDeps.systemSharedLibs) > 0 {
|
|
// Skip this if systemSharedLibs is either nil or [], to ensure they are
|
|
// retained.
|
|
specifiedDeps.systemSharedLibs = android.FirstUniqueStrings(specifiedDeps.systemSharedLibs)
|
|
}
|
|
return specifiedDeps
|
|
}
|
|
|
|
func (library *libraryDecorator) moduleInfoJSON(ctx ModuleContext, moduleInfoJSON *android.ModuleInfoJSON) {
|
|
if library.static() {
|
|
moduleInfoJSON.Class = []string{"STATIC_LIBRARIES"}
|
|
moduleInfoJSON.Uninstallable = true
|
|
} else if library.shared() {
|
|
moduleInfoJSON.Class = []string{"SHARED_LIBRARIES"}
|
|
} else if library.header() {
|
|
moduleInfoJSON.Class = []string{"HEADER_LIBRARIES"}
|
|
moduleInfoJSON.Uninstallable = true
|
|
}
|
|
|
|
if library.buildStubs() && library.stubsVersion() != "" {
|
|
moduleInfoJSON.SubName += "." + library.stubsVersion()
|
|
}
|
|
|
|
// If a library providing a stub is included in an APEX, the private APIs of the library
|
|
// is accessible only inside the APEX. From outside of the APEX, clients can only use the
|
|
// public APIs via the stub. To enforce this, the (latest version of the) stub gets the
|
|
// name of the library. The impl library instead gets the `.bootstrap` suffix to so that
|
|
// they can be exceptionally used directly when APEXes are not available (e.g. during the
|
|
// very early stage in the boot process).
|
|
if len(library.Properties.Stubs.Versions) > 0 && !ctx.Host() && ctx.notInPlatform() &&
|
|
!ctx.inRamdisk() && !ctx.inVendorRamdisk() && !ctx.inRecovery() && !ctx.useVndk() && !ctx.static() {
|
|
if library.buildStubs() && library.isLatestStubVersion() {
|
|
moduleInfoJSON.SubName = ""
|
|
}
|
|
if !library.buildStubs() {
|
|
moduleInfoJSON.SubName = ".bootstrap"
|
|
}
|
|
}
|
|
|
|
library.baseLinker.moduleInfoJSON(ctx, moduleInfoJSON)
|
|
}
|
|
|
|
func (library *libraryDecorator) linkStatic(ctx ModuleContext,
|
|
flags Flags, deps PathDeps, objs Objects) android.Path {
|
|
|
|
library.objects = deps.WholeStaticLibObjs.Copy()
|
|
library.objects = library.objects.Append(objs)
|
|
library.wholeStaticLibsFromPrebuilts = android.CopyOfPaths(deps.WholeStaticLibsFromPrebuilts)
|
|
|
|
fileName := ctx.ModuleName() + staticLibraryExtension
|
|
outputFile := android.PathForModuleOut(ctx, fileName)
|
|
builderFlags := flagsToBuilderFlags(flags)
|
|
|
|
if Bool(library.baseLinker.Properties.Use_version_lib) {
|
|
if ctx.Host() {
|
|
versionedOutputFile := outputFile
|
|
outputFile = android.PathForModuleOut(ctx, "unversioned", fileName)
|
|
library.injectVersionSymbol(ctx, outputFile, versionedOutputFile)
|
|
} else {
|
|
versionedOutputFile := android.PathForModuleOut(ctx, "versioned", fileName)
|
|
library.distFile = versionedOutputFile
|
|
library.injectVersionSymbol(ctx, outputFile, versionedOutputFile)
|
|
}
|
|
}
|
|
|
|
transformObjToStaticLib(ctx, library.objects.objFiles, deps.WholeStaticLibsFromPrebuilts, builderFlags, outputFile, nil, objs.tidyDepFiles)
|
|
|
|
library.coverageOutputFile = transformCoverageFilesToZip(ctx, library.objects, ctx.ModuleName())
|
|
|
|
ctx.CheckbuildFile(outputFile)
|
|
|
|
if library.static() {
|
|
android.SetProvider(ctx, StaticLibraryInfoProvider, StaticLibraryInfo{
|
|
StaticLibrary: outputFile,
|
|
ReuseObjects: library.reuseObjects,
|
|
Objects: library.objects,
|
|
WholeStaticLibsFromPrebuilts: library.wholeStaticLibsFromPrebuilts,
|
|
|
|
TransitiveStaticLibrariesForOrdering: android.NewDepSetBuilder[android.Path](android.TOPOLOGICAL).
|
|
Direct(outputFile).
|
|
Transitive(deps.TranstiveStaticLibrariesForOrdering).
|
|
Build(),
|
|
})
|
|
}
|
|
|
|
if library.header() {
|
|
android.SetProvider(ctx, HeaderLibraryInfoProvider, HeaderLibraryInfo{})
|
|
}
|
|
|
|
return outputFile
|
|
}
|
|
|
|
func ndkSharedLibDeps(ctx ModuleContext) android.Paths {
|
|
if ctx.Module().(*Module).IsSdkVariant() {
|
|
// The NDK sysroot timestamp file depends on all the NDK
|
|
// sysroot header and shared library files.
|
|
return android.Paths{getNdkBaseTimestampFile(ctx)}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (library *libraryDecorator) linkShared(ctx ModuleContext,
|
|
flags Flags, deps PathDeps, objs Objects) android.Path {
|
|
|
|
var linkerDeps android.Paths
|
|
linkerDeps = append(linkerDeps, flags.LdFlagsDeps...)
|
|
linkerDeps = append(linkerDeps, ndkSharedLibDeps(ctx)...)
|
|
|
|
unexportedSymbols := ctx.ExpandOptionalSource(library.Properties.Unexported_symbols_list, "unexported_symbols_list")
|
|
forceNotWeakSymbols := ctx.ExpandOptionalSource(library.Properties.Force_symbols_not_weak_list, "force_symbols_not_weak_list")
|
|
forceWeakSymbols := ctx.ExpandOptionalSource(library.Properties.Force_symbols_weak_list, "force_symbols_weak_list")
|
|
if !ctx.Darwin() {
|
|
if unexportedSymbols.Valid() {
|
|
ctx.PropertyErrorf("unexported_symbols_list", "Only supported on Darwin")
|
|
}
|
|
if forceNotWeakSymbols.Valid() {
|
|
ctx.PropertyErrorf("force_symbols_not_weak_list", "Only supported on Darwin")
|
|
}
|
|
if forceWeakSymbols.Valid() {
|
|
ctx.PropertyErrorf("force_symbols_weak_list", "Only supported on Darwin")
|
|
}
|
|
} else {
|
|
if unexportedSymbols.Valid() {
|
|
flags.Local.LdFlags = append(flags.Local.LdFlags, "-Wl,-unexported_symbols_list,"+unexportedSymbols.String())
|
|
linkerDeps = append(linkerDeps, unexportedSymbols.Path())
|
|
}
|
|
if forceNotWeakSymbols.Valid() {
|
|
flags.Local.LdFlags = append(flags.Local.LdFlags, "-Wl,-force_symbols_not_weak_list,"+forceNotWeakSymbols.String())
|
|
linkerDeps = append(linkerDeps, forceNotWeakSymbols.Path())
|
|
}
|
|
if forceWeakSymbols.Valid() {
|
|
flags.Local.LdFlags = append(flags.Local.LdFlags, "-Wl,-force_symbols_weak_list,"+forceWeakSymbols.String())
|
|
linkerDeps = append(linkerDeps, forceWeakSymbols.Path())
|
|
}
|
|
}
|
|
if library.versionScriptPath.Valid() {
|
|
linkerScriptFlags := "-Wl,--version-script," + library.versionScriptPath.String()
|
|
flags.Local.LdFlags = append(flags.Local.LdFlags, linkerScriptFlags)
|
|
linkerDeps = append(linkerDeps, library.versionScriptPath.Path())
|
|
}
|
|
|
|
fileName := library.getLibName(ctx) + flags.Toolchain.ShlibSuffix()
|
|
outputFile := android.PathForModuleOut(ctx, fileName)
|
|
unstrippedOutputFile := outputFile
|
|
|
|
var implicitOutputs android.WritablePaths
|
|
if ctx.Windows() {
|
|
importLibraryPath := android.PathForModuleOut(ctx, pathtools.ReplaceExtension(fileName, "lib"))
|
|
|
|
flags.Local.LdFlags = append(flags.Local.LdFlags, "-Wl,--out-implib="+importLibraryPath.String())
|
|
implicitOutputs = append(implicitOutputs, importLibraryPath)
|
|
}
|
|
|
|
builderFlags := flagsToBuilderFlags(flags)
|
|
|
|
if ctx.Darwin() && deps.DarwinSecondArchOutput.Valid() {
|
|
fatOutputFile := outputFile
|
|
outputFile = android.PathForModuleOut(ctx, "pre-fat", fileName)
|
|
transformDarwinUniversalBinary(ctx, fatOutputFile, outputFile, deps.DarwinSecondArchOutput.Path())
|
|
}
|
|
|
|
// Optimize out relinking against shared libraries whose interface hasn't changed by
|
|
// depending on a table of contents file instead of the library itself.
|
|
tocFile := outputFile.ReplaceExtension(ctx, flags.Toolchain.ShlibSuffix()[1:]+".toc")
|
|
library.tocFile = android.OptionalPathForPath(tocFile)
|
|
TransformSharedObjectToToc(ctx, outputFile, tocFile)
|
|
|
|
stripFlags := flagsToStripFlags(flags)
|
|
needsStrip := library.stripper.NeedsStrip(ctx)
|
|
if library.buildStubs() {
|
|
// No need to strip stubs libraries
|
|
needsStrip = false
|
|
}
|
|
if needsStrip {
|
|
if ctx.Darwin() {
|
|
stripFlags.StripUseGnuStrip = true
|
|
}
|
|
strippedOutputFile := outputFile
|
|
outputFile = android.PathForModuleOut(ctx, "unstripped", fileName)
|
|
library.stripper.StripExecutableOrSharedLib(ctx, outputFile, strippedOutputFile, stripFlags)
|
|
}
|
|
library.unstrippedOutputFile = outputFile
|
|
|
|
outputFile = maybeInjectBoringSSLHash(ctx, outputFile, library.Properties.Inject_bssl_hash, fileName)
|
|
|
|
if Bool(library.baseLinker.Properties.Use_version_lib) {
|
|
if ctx.Host() {
|
|
versionedOutputFile := outputFile
|
|
outputFile = android.PathForModuleOut(ctx, "unversioned", fileName)
|
|
library.injectVersionSymbol(ctx, outputFile, versionedOutputFile)
|
|
} else {
|
|
versionedOutputFile := android.PathForModuleOut(ctx, "versioned", fileName)
|
|
library.distFile = versionedOutputFile
|
|
|
|
if library.stripper.NeedsStrip(ctx) {
|
|
out := android.PathForModuleOut(ctx, "versioned-stripped", fileName)
|
|
library.distFile = out
|
|
library.stripper.StripExecutableOrSharedLib(ctx, versionedOutputFile, out, stripFlags)
|
|
}
|
|
|
|
library.injectVersionSymbol(ctx, outputFile, versionedOutputFile)
|
|
}
|
|
}
|
|
|
|
// Generate an output file for dist as if strip: "all" is set on the module.
|
|
// Currently this is for layoutlib release process only.
|
|
for _, dist := range ctx.Module().(*Module).Dists() {
|
|
if dist.Tag != nil && *dist.Tag == "stripped_all" {
|
|
strippedAllOutputFile := android.PathForModuleOut(ctx, "stripped_all", fileName)
|
|
transformStrip(ctx, outputFile, strippedAllOutputFile, StripFlags{Toolchain: flags.Toolchain})
|
|
library.strippedAllOutputFile = strippedAllOutputFile
|
|
break
|
|
}
|
|
}
|
|
|
|
sharedLibs := deps.EarlySharedLibs
|
|
sharedLibs = append(sharedLibs, deps.SharedLibs...)
|
|
sharedLibs = append(sharedLibs, deps.LateSharedLibs...)
|
|
|
|
linkerDeps = append(linkerDeps, deps.EarlySharedLibsDeps...)
|
|
linkerDeps = append(linkerDeps, deps.SharedLibsDeps...)
|
|
linkerDeps = append(linkerDeps, deps.LateSharedLibsDeps...)
|
|
transformObjToDynamicBinary(ctx, objs.objFiles, sharedLibs,
|
|
deps.StaticLibs, deps.LateStaticLibs, deps.WholeStaticLibs,
|
|
linkerDeps, deps.CrtBegin, deps.CrtEnd, false, builderFlags, outputFile, implicitOutputs, objs.tidyDepFiles)
|
|
|
|
objs.coverageFiles = append(objs.coverageFiles, deps.StaticLibObjs.coverageFiles...)
|
|
objs.coverageFiles = append(objs.coverageFiles, deps.WholeStaticLibObjs.coverageFiles...)
|
|
objs.sAbiDumpFiles = append(objs.sAbiDumpFiles, deps.StaticLibObjs.sAbiDumpFiles...)
|
|
objs.sAbiDumpFiles = append(objs.sAbiDumpFiles, deps.WholeStaticLibObjs.sAbiDumpFiles...)
|
|
|
|
library.coverageOutputFile = transformCoverageFilesToZip(ctx, objs, library.getLibName(ctx))
|
|
library.linkSAbiDumpFiles(ctx, objs, fileName, unstrippedOutputFile)
|
|
|
|
var transitiveStaticLibrariesForOrdering *android.DepSet[android.Path]
|
|
if static := ctx.GetDirectDepsWithTag(staticVariantTag); len(static) > 0 {
|
|
s, _ := android.OtherModuleProvider(ctx, static[0], StaticLibraryInfoProvider)
|
|
transitiveStaticLibrariesForOrdering = s.TransitiveStaticLibrariesForOrdering
|
|
}
|
|
|
|
android.SetProvider(ctx, SharedLibraryInfoProvider, SharedLibraryInfo{
|
|
TableOfContents: android.OptionalPathForPath(tocFile),
|
|
SharedLibrary: unstrippedOutputFile,
|
|
TransitiveStaticLibrariesForOrdering: transitiveStaticLibrariesForOrdering,
|
|
Target: ctx.Target(),
|
|
})
|
|
|
|
addStubDependencyProviders(ctx)
|
|
|
|
return unstrippedOutputFile
|
|
}
|
|
|
|
func addStubDependencyProviders(ctx ModuleContext) {
|
|
stubs := ctx.GetDirectDepsWithTag(stubImplDepTag)
|
|
if len(stubs) > 0 {
|
|
var stubsInfo []SharedStubLibrary
|
|
for _, stub := range stubs {
|
|
stubInfo, _ := android.OtherModuleProvider(ctx, stub, SharedLibraryInfoProvider)
|
|
flagInfo, _ := android.OtherModuleProvider(ctx, stub, FlagExporterInfoProvider)
|
|
stubsInfo = append(stubsInfo, SharedStubLibrary{
|
|
Version: moduleLibraryInterface(stub).stubsVersion(),
|
|
SharedLibraryInfo: stubInfo,
|
|
FlagExporterInfo: flagInfo,
|
|
})
|
|
}
|
|
android.SetProvider(ctx, SharedLibraryStubsProvider, SharedLibraryStubsInfo{
|
|
SharedStubLibraries: stubsInfo,
|
|
IsLLNDK: ctx.IsLlndk(),
|
|
})
|
|
}
|
|
}
|
|
|
|
func (library *libraryDecorator) unstrippedOutputFilePath() android.Path {
|
|
return library.unstrippedOutputFile
|
|
}
|
|
|
|
func (library *libraryDecorator) strippedAllOutputFilePath() android.Path {
|
|
return library.strippedAllOutputFile
|
|
}
|
|
|
|
func (library *libraryDecorator) disableStripping() {
|
|
library.stripper.StripProperties.Strip.None = BoolPtr(true)
|
|
}
|
|
|
|
func (library *libraryDecorator) nativeCoverage() bool {
|
|
if library.header() || library.buildStubs() {
|
|
return false
|
|
}
|
|
return true
|
|
}
|
|
|
|
func (library *libraryDecorator) coverageOutputFilePath() android.OptionalPath {
|
|
return library.coverageOutputFile
|
|
}
|
|
|
|
func getRefAbiDumpFile(ctx android.ModuleInstallPathContext,
|
|
versionedDumpDir, fileName string) android.OptionalPath {
|
|
|
|
currentArchType := ctx.Arch().ArchType
|
|
primaryArchType := ctx.Config().DevicePrimaryArchType()
|
|
archName := currentArchType.String()
|
|
if currentArchType != primaryArchType {
|
|
archName += "_" + primaryArchType.String()
|
|
}
|
|
|
|
return android.ExistentPathForSource(ctx, versionedDumpDir, archName, "source-based",
|
|
fileName+".lsdump")
|
|
}
|
|
|
|
// Return the previous and current SDK versions for cross-version ABI diff.
|
|
func crossVersionAbiDiffSdkVersions(ctx ModuleContext, dumpDir string) (string, string) {
|
|
sdkVersionInt := ctx.Config().PlatformSdkVersion().FinalInt()
|
|
sdkVersionStr := ctx.Config().PlatformSdkVersion().String()
|
|
|
|
if ctx.Config().PlatformSdkFinal() {
|
|
return strconv.Itoa(sdkVersionInt - 1), sdkVersionStr
|
|
} else {
|
|
// The platform SDK version can be upgraded before finalization while the corresponding abi dumps hasn't
|
|
// been generated. Thus the Cross-Version Check chooses PLATFORM_SDK_VERION - 1 as previous version.
|
|
// This situation could be identified by checking the existence of the PLATFORM_SDK_VERION dump directory.
|
|
versionedDumpDir := android.ExistentPathForSource(ctx, dumpDir, sdkVersionStr)
|
|
if versionedDumpDir.Valid() {
|
|
return sdkVersionStr, strconv.Itoa(sdkVersionInt + 1)
|
|
} else {
|
|
return strconv.Itoa(sdkVersionInt - 1), sdkVersionStr
|
|
}
|
|
}
|
|
}
|
|
|
|
// Return the SDK version for same-version ABI diff.
|
|
func currRefAbiDumpSdkVersion(ctx ModuleContext) string {
|
|
if ctx.Config().PlatformSdkFinal() {
|
|
// After sdk finalization, the ABI of the latest API level must be consistent with the source code,
|
|
// so choose PLATFORM_SDK_VERSION as the current version.
|
|
return ctx.Config().PlatformSdkVersion().String()
|
|
} else {
|
|
return "current"
|
|
}
|
|
}
|
|
|
|
// sourceAbiDiff registers a build statement to compare linked sAbi dump files (.lsdump).
|
|
func (library *libraryDecorator) sourceAbiDiff(ctx android.ModuleContext, referenceDump android.Path,
|
|
baseName, nameExt string, isLlndkOrNdk, allowExtensions bool,
|
|
sourceVersion, errorMessage string) {
|
|
|
|
sourceDump := library.sAbiOutputFile.Path()
|
|
|
|
extraFlags := []string{"-target-version", sourceVersion}
|
|
headerAbiChecker := library.getHeaderAbiCheckerProperties(ctx)
|
|
if Bool(headerAbiChecker.Check_all_apis) {
|
|
extraFlags = append(extraFlags, "-check-all-apis")
|
|
} else {
|
|
extraFlags = append(extraFlags,
|
|
"-allow-unreferenced-changes",
|
|
"-allow-unreferenced-elf-symbol-changes")
|
|
}
|
|
if isLlndkOrNdk {
|
|
extraFlags = append(extraFlags, "-consider-opaque-types-different")
|
|
}
|
|
if allowExtensions {
|
|
extraFlags = append(extraFlags, "-allow-extensions")
|
|
}
|
|
extraFlags = append(extraFlags, headerAbiChecker.Diff_flags...)
|
|
|
|
library.sAbiDiff = append(
|
|
library.sAbiDiff,
|
|
transformAbiDumpToAbiDiff(ctx, sourceDump, referenceDump,
|
|
baseName, nameExt, extraFlags, errorMessage))
|
|
}
|
|
|
|
func (library *libraryDecorator) crossVersionAbiDiff(ctx android.ModuleContext, referenceDump android.Path,
|
|
baseName string, isLlndkOrNdk bool, sourceVersion, prevVersion string) {
|
|
|
|
errorMessage := "error: Please follow https://android.googlesource.com/platform/development/+/main/vndk/tools/header-checker/README.md#configure-cross_version-abi-check to resolve the ABI difference between your source code and version " + prevVersion + "."
|
|
|
|
library.sourceAbiDiff(ctx, referenceDump, baseName, prevVersion,
|
|
isLlndkOrNdk, true /* allowExtensions */, sourceVersion, errorMessage)
|
|
}
|
|
|
|
func (library *libraryDecorator) sameVersionAbiDiff(ctx android.ModuleContext, referenceDump android.Path,
|
|
baseName, nameExt string, isLlndkOrNdk bool) {
|
|
|
|
libName := strings.TrimSuffix(baseName, filepath.Ext(baseName))
|
|
errorMessage := "error: Please update ABI references with: $$ANDROID_BUILD_TOP/development/vndk/tools/header-checker/utils/create_reference_dumps.py -l " + libName
|
|
|
|
library.sourceAbiDiff(ctx, referenceDump, baseName, nameExt,
|
|
isLlndkOrNdk, false /* allowExtensions */, "current", errorMessage)
|
|
}
|
|
|
|
func (library *libraryDecorator) optInAbiDiff(ctx android.ModuleContext, referenceDump android.Path,
|
|
baseName, nameExt string, refDumpDir string) {
|
|
|
|
libName := strings.TrimSuffix(baseName, filepath.Ext(baseName))
|
|
errorMessage := "error: Please update ABI references with: $$ANDROID_BUILD_TOP/development/vndk/tools/header-checker/utils/create_reference_dumps.py -l " + libName + " -ref-dump-dir $$ANDROID_BUILD_TOP/" + refDumpDir
|
|
// Most opt-in libraries do not have dumps for all default architectures.
|
|
if ctx.Config().HasDeviceProduct() {
|
|
errorMessage += " -products " + ctx.Config().DeviceProduct()
|
|
}
|
|
|
|
library.sourceAbiDiff(ctx, referenceDump, baseName, nameExt,
|
|
false /* isLlndkOrNdk */, false /* allowExtensions */, "current", errorMessage)
|
|
}
|
|
|
|
func (library *libraryDecorator) linkSAbiDumpFiles(ctx ModuleContext, objs Objects, fileName string, soFile android.Path) {
|
|
if library.sabi.shouldCreateSourceAbiDump() {
|
|
exportIncludeDirs := library.flagExporter.exportedIncludes(ctx)
|
|
var SourceAbiFlags []string
|
|
for _, dir := range exportIncludeDirs.Strings() {
|
|
SourceAbiFlags = append(SourceAbiFlags, "-I"+dir)
|
|
}
|
|
for _, reexportedInclude := range library.sabi.Properties.ReexportedIncludes {
|
|
SourceAbiFlags = append(SourceAbiFlags, "-I"+reexportedInclude)
|
|
}
|
|
exportedHeaderFlags := strings.Join(SourceAbiFlags, " ")
|
|
headerAbiChecker := library.getHeaderAbiCheckerProperties(ctx)
|
|
currSdkVersion := currRefAbiDumpSdkVersion(ctx)
|
|
currVendorVersion := ctx.Config().VendorApiLevel()
|
|
library.sAbiOutputFile = transformDumpToLinkedDump(ctx, objs.sAbiDumpFiles, soFile, fileName, exportedHeaderFlags,
|
|
android.OptionalPathForModuleSrc(ctx, library.symbolFileForAbiCheck(ctx)),
|
|
headerAbiChecker.Exclude_symbol_versions,
|
|
headerAbiChecker.Exclude_symbol_tags,
|
|
currSdkVersion)
|
|
|
|
for _, tag := range classifySourceAbiDump(ctx) {
|
|
addLsdumpPath(string(tag) + ":" + library.sAbiOutputFile.String())
|
|
|
|
dumpDirName := tag.dirName()
|
|
if dumpDirName == "" {
|
|
continue
|
|
}
|
|
dumpDir := filepath.Join("prebuilts", "abi-dumps", dumpDirName)
|
|
isLlndk := (tag == llndkLsdumpTag)
|
|
isNdk := (tag == ndkLsdumpTag)
|
|
binderBitness := ctx.DeviceConfig().BinderBitness()
|
|
nameExt := ""
|
|
if isLlndk {
|
|
nameExt = "llndk"
|
|
}
|
|
// Check against the previous version.
|
|
var prevVersion, currVersion string
|
|
// If this release config does not define VendorApiLevel, fall back to the old policy.
|
|
if isLlndk && currVendorVersion != "" {
|
|
prevVersion = ctx.Config().PrevVendorApiLevel()
|
|
currVersion = currVendorVersion
|
|
} else {
|
|
prevVersion, currVersion = crossVersionAbiDiffSdkVersions(ctx, dumpDir)
|
|
}
|
|
prevDumpDir := filepath.Join(dumpDir, prevVersion, binderBitness)
|
|
prevDumpFile := getRefAbiDumpFile(ctx, prevDumpDir, fileName)
|
|
if prevDumpFile.Valid() {
|
|
library.crossVersionAbiDiff(ctx, prevDumpFile.Path(),
|
|
fileName, isLlndk || isNdk, currVersion, nameExt+prevVersion)
|
|
}
|
|
// Check against the current version.
|
|
if isLlndk && currVendorVersion != "" {
|
|
currVersion = currVendorVersion
|
|
} else {
|
|
currVersion = currSdkVersion
|
|
}
|
|
currDumpDir := filepath.Join(dumpDir, currVersion, binderBitness)
|
|
currDumpFile := getRefAbiDumpFile(ctx, currDumpDir, fileName)
|
|
if currDumpFile.Valid() {
|
|
library.sameVersionAbiDiff(ctx, currDumpFile.Path(),
|
|
fileName, nameExt, isLlndk || isNdk)
|
|
}
|
|
}
|
|
// Check against the opt-in reference dumps.
|
|
for i, optInDumpDir := range headerAbiChecker.Ref_dump_dirs {
|
|
optInDumpDirPath := android.PathForModuleSrc(ctx, optInDumpDir)
|
|
// Ref_dump_dirs are not versioned.
|
|
// They do not contain subdir for binder bitness because 64-bit binder has been mandatory.
|
|
optInDumpFile := getRefAbiDumpFile(ctx, optInDumpDirPath.String(), fileName)
|
|
if !optInDumpFile.Valid() {
|
|
continue
|
|
}
|
|
library.optInAbiDiff(ctx, optInDumpFile.Path(),
|
|
fileName, "opt"+strconv.Itoa(i), optInDumpDirPath.String())
|
|
}
|
|
}
|
|
}
|
|
|
|
func processLLNDKHeaders(ctx ModuleContext, srcHeaderDir string, outDir android.ModuleGenPath) (timestamp android.Path, installPaths android.WritablePaths) {
|
|
srcDir := android.PathForModuleSrc(ctx, srcHeaderDir)
|
|
srcFiles := ctx.GlobFiles(filepath.Join(srcDir.String(), "**/*.h"), nil)
|
|
|
|
for _, header := range srcFiles {
|
|
headerDir := filepath.Dir(header.String())
|
|
relHeaderDir, err := filepath.Rel(srcDir.String(), headerDir)
|
|
if err != nil {
|
|
ctx.ModuleErrorf("filepath.Rel(%q, %q) failed: %s",
|
|
srcDir.String(), headerDir, err)
|
|
continue
|
|
}
|
|
|
|
installPaths = append(installPaths, outDir.Join(ctx, relHeaderDir, header.Base()))
|
|
}
|
|
|
|
return processHeadersWithVersioner(ctx, srcDir, outDir, srcFiles, installPaths), installPaths
|
|
}
|
|
|
|
// link registers actions to link this library, and sets various fields
|
|
// on this library to reflect information that should be exported up the build
|
|
// tree (for example, exported flags and include paths).
|
|
func (library *libraryDecorator) link(ctx ModuleContext,
|
|
flags Flags, deps PathDeps, objs Objects) android.Path {
|
|
|
|
if ctx.IsLlndk() {
|
|
if len(library.Properties.Llndk.Export_preprocessed_headers) > 0 {
|
|
// This is the vendor variant of an LLNDK library with preprocessed headers.
|
|
genHeaderOutDir := android.PathForModuleGen(ctx, "include")
|
|
|
|
var timestampFiles android.Paths
|
|
for _, dir := range library.Properties.Llndk.Export_preprocessed_headers {
|
|
timestampFile, installPaths := processLLNDKHeaders(ctx, dir, genHeaderOutDir)
|
|
timestampFiles = append(timestampFiles, timestampFile)
|
|
library.addExportedGeneratedHeaders(installPaths.Paths()...)
|
|
}
|
|
|
|
if Bool(library.Properties.Llndk.Export_headers_as_system) {
|
|
library.reexportSystemDirs(genHeaderOutDir)
|
|
} else {
|
|
library.reexportDirs(genHeaderOutDir)
|
|
}
|
|
|
|
library.reexportDeps(timestampFiles...)
|
|
}
|
|
|
|
// override the module's export_include_dirs with llndk.override_export_include_dirs
|
|
// if it is set.
|
|
if override := library.Properties.Llndk.Override_export_include_dirs; override != nil {
|
|
library.flagExporter.Properties.Export_include_dirs = override
|
|
}
|
|
|
|
if Bool(library.Properties.Llndk.Export_headers_as_system) {
|
|
library.flagExporter.Properties.Export_system_include_dirs = append(
|
|
library.flagExporter.Properties.Export_system_include_dirs,
|
|
library.flagExporter.Properties.Export_include_dirs...)
|
|
library.flagExporter.Properties.Export_include_dirs = nil
|
|
}
|
|
}
|
|
|
|
if ctx.IsVendorPublicLibrary() {
|
|
// override the module's export_include_dirs with vendor_public_library.override_export_include_dirs
|
|
// if it is set.
|
|
if override := library.Properties.Vendor_public_library.Override_export_include_dirs; override != nil {
|
|
library.flagExporter.Properties.Export_include_dirs = override
|
|
}
|
|
}
|
|
|
|
// Linking this library consists of linking `deps.Objs` (.o files in dependencies
|
|
// of this library), together with `objs` (.o files created by compiling this
|
|
// library).
|
|
objs = deps.Objs.Copy().Append(objs)
|
|
var out android.Path
|
|
if library.static() || library.header() {
|
|
out = library.linkStatic(ctx, flags, deps, objs)
|
|
} else {
|
|
out = library.linkShared(ctx, flags, deps, objs)
|
|
}
|
|
|
|
// Export include paths and flags to be propagated up the tree.
|
|
library.exportIncludes(ctx)
|
|
library.reexportDirs(deps.ReexportedDirs...)
|
|
library.reexportSystemDirs(deps.ReexportedSystemDirs...)
|
|
library.reexportFlags(deps.ReexportedFlags...)
|
|
library.reexportDeps(deps.ReexportedDeps...)
|
|
library.addExportedGeneratedHeaders(deps.ReexportedGeneratedHeaders...)
|
|
|
|
// Optionally export aidl headers.
|
|
if Bool(library.Properties.Aidl.Export_aidl_headers) {
|
|
if library.baseCompiler.hasAidl(deps) {
|
|
if library.baseCompiler.hasSrcExt(".aidl") {
|
|
dir := android.PathForModuleGen(ctx, "aidl")
|
|
library.reexportDirs(dir)
|
|
}
|
|
if len(deps.AidlLibraryInfos) > 0 {
|
|
dir := android.PathForModuleGen(ctx, "aidl_library")
|
|
library.reexportDirs(dir)
|
|
}
|
|
|
|
library.reexportDeps(library.baseCompiler.aidlOrderOnlyDeps...)
|
|
library.addExportedGeneratedHeaders(library.baseCompiler.aidlHeaders...)
|
|
}
|
|
}
|
|
|
|
// Optionally export proto headers.
|
|
if Bool(library.Properties.Proto.Export_proto_headers) {
|
|
if library.baseCompiler.hasSrcExt(".proto") {
|
|
var includes android.Paths
|
|
if flags.proto.CanonicalPathFromRoot {
|
|
includes = append(includes, flags.proto.SubDir)
|
|
}
|
|
includes = append(includes, flags.proto.Dir)
|
|
library.reexportDirs(includes...)
|
|
|
|
library.reexportDeps(library.baseCompiler.protoOrderOnlyDeps...)
|
|
library.addExportedGeneratedHeaders(library.baseCompiler.protoHeaders...)
|
|
}
|
|
}
|
|
|
|
// If the library is sysprop_library, expose either public or internal header selectively.
|
|
if library.baseCompiler.hasSrcExt(".sysprop") {
|
|
dir := android.PathForModuleGen(ctx, "sysprop", "include")
|
|
if library.Properties.Sysprop.Platform != nil {
|
|
isOwnerPlatform := Bool(library.Properties.Sysprop.Platform)
|
|
|
|
// If the owner is different from the user, expose public header. That is,
|
|
// 1) if the user is product (as owner can only be platform / vendor)
|
|
// 2) if the owner is platform and the client is vendor
|
|
// We don't care Platform -> Vendor dependency as it's already forbidden.
|
|
if ctx.Device() && (ctx.ProductSpecific() || (isOwnerPlatform && ctx.inVendor())) {
|
|
dir = android.PathForModuleGen(ctx, "sysprop/public", "include")
|
|
}
|
|
}
|
|
|
|
// Make sure to only export headers which are within the include directory.
|
|
_, headers := android.FilterPathListPredicate(library.baseCompiler.syspropHeaders, func(path android.Path) bool {
|
|
_, isRel := android.MaybeRel(ctx, dir.String(), path.String())
|
|
return isRel
|
|
})
|
|
|
|
// Add sysprop-related directories to the exported directories of this library.
|
|
library.reexportDirs(dir)
|
|
library.reexportDeps(library.baseCompiler.syspropOrderOnlyDeps...)
|
|
library.addExportedGeneratedHeaders(headers...)
|
|
}
|
|
|
|
// Add stub-related flags if this library is a stub library.
|
|
library.exportVersioningMacroIfNeeded(ctx)
|
|
|
|
// Propagate a Provider containing information about exported flags, deps, and include paths.
|
|
library.flagExporter.setProvider(ctx)
|
|
|
|
return out
|
|
}
|
|
|
|
func (library *libraryDecorator) exportVersioningMacroIfNeeded(ctx android.BaseModuleContext) {
|
|
if library.buildStubs() && library.stubsVersion() != "" && !library.skipAPIDefine {
|
|
name := versioningMacroName(ctx.Module().(*Module).ImplementationModuleName(ctx))
|
|
apiLevel, err := android.ApiLevelFromUser(ctx, library.stubsVersion())
|
|
if err != nil {
|
|
ctx.ModuleErrorf("Can't export version macro: %s", err.Error())
|
|
}
|
|
library.reexportFlags("-D" + name + "=" + strconv.Itoa(apiLevel.FinalOrPreviewInt()))
|
|
}
|
|
}
|
|
|
|
// buildStatic returns true if this library should be built as a static library.
|
|
func (library *libraryDecorator) buildStatic() bool {
|
|
return library.MutatedProperties.BuildStatic &&
|
|
BoolDefault(library.StaticProperties.Static.Enabled, true)
|
|
}
|
|
|
|
// buildShared returns true if this library should be built as a shared library.
|
|
func (library *libraryDecorator) buildShared() bool {
|
|
return library.MutatedProperties.BuildShared &&
|
|
BoolDefault(library.SharedProperties.Shared.Enabled, true)
|
|
}
|
|
|
|
func (library *libraryDecorator) objs() Objects {
|
|
return library.objects
|
|
}
|
|
|
|
func (library *libraryDecorator) reuseObjs() Objects {
|
|
return library.reuseObjects
|
|
}
|
|
|
|
func (library *libraryDecorator) toc() android.OptionalPath {
|
|
return library.tocFile
|
|
}
|
|
|
|
func (library *libraryDecorator) installSymlinkToRuntimeApex(ctx ModuleContext, file android.Path) {
|
|
dir := library.baseInstaller.installDir(ctx)
|
|
dirOnDevice := android.InstallPathToOnDevicePath(ctx, dir)
|
|
// libc_hwasan has relative_install_dir set, which would mess up the dir.Base() logic.
|
|
// hardcode here because it's the only target, if we have other targets that use this
|
|
// we can generalise this.
|
|
var target string
|
|
if ctx.baseModuleName() == "libc_hwasan" {
|
|
target = "/" + filepath.Join("apex", "com.android.runtime", "lib64", "bionic", "hwasan", file.Base())
|
|
} else {
|
|
base := dir.Base()
|
|
target = "/" + filepath.Join("apex", "com.android.runtime", base, "bionic", file.Base())
|
|
}
|
|
ctx.InstallAbsoluteSymlink(dir, file.Base(), target)
|
|
library.postInstallCmds = append(library.postInstallCmds, makeSymlinkCmd(dirOnDevice, file.Base(), target))
|
|
}
|
|
|
|
func (library *libraryDecorator) install(ctx ModuleContext, file android.Path) {
|
|
if library.shared() {
|
|
if ctx.Device() && ctx.useVndk() {
|
|
// set subDir for VNDK extensions
|
|
if ctx.IsVndkExt() {
|
|
if ctx.isVndkSp() {
|
|
library.baseInstaller.subDir = "vndk-sp"
|
|
} else {
|
|
library.baseInstaller.subDir = "vndk"
|
|
}
|
|
}
|
|
|
|
// In some cases we want to use core variant for VNDK-Core libs.
|
|
// Skip product variant since VNDKs use only the vendor variant.
|
|
if ctx.isVndk() && !ctx.isVndkSp() && !ctx.IsVndkExt() && !ctx.inProduct() {
|
|
mayUseCoreVariant := true
|
|
|
|
if ctx.mustUseVendorVariant() {
|
|
mayUseCoreVariant = false
|
|
}
|
|
|
|
if ctx.Config().CFIEnabledForPath(ctx.ModuleDir()) {
|
|
mayUseCoreVariant = false
|
|
}
|
|
|
|
if mayUseCoreVariant {
|
|
library.checkSameCoreVariant = true
|
|
if ctx.DeviceConfig().VndkUseCoreVariant() {
|
|
library.useCoreVariant = true
|
|
}
|
|
}
|
|
}
|
|
|
|
// do not install vndk libs
|
|
// vndk libs are packaged into VNDK APEX
|
|
if ctx.isVndk() && !ctx.IsVndkExt() && !ctx.Config().IsVndkDeprecated() && !ctx.inProduct() {
|
|
return
|
|
}
|
|
} else if library.hasStubsVariants() && !ctx.Host() && ctx.directlyInAnyApex() {
|
|
// Bionic libraries (e.g. libc.so) is installed to the bootstrap subdirectory.
|
|
// The original path becomes a symlink to the corresponding file in the
|
|
// runtime APEX.
|
|
translatedArch := ctx.Target().NativeBridge == android.NativeBridgeEnabled
|
|
if InstallToBootstrap(ctx.baseModuleName(), ctx.Config()) && !library.buildStubs() &&
|
|
!translatedArch && !ctx.inRamdisk() && !ctx.inVendorRamdisk() && !ctx.inRecovery() {
|
|
if ctx.Device() {
|
|
library.installSymlinkToRuntimeApex(ctx, file)
|
|
}
|
|
library.baseInstaller.subDir = "bootstrap"
|
|
}
|
|
} else if ctx.directlyInAnyApex() && ctx.IsLlndk() && !isBionic(ctx.baseModuleName()) {
|
|
// Skip installing LLNDK (non-bionic) libraries moved to APEX.
|
|
ctx.Module().HideFromMake()
|
|
}
|
|
|
|
library.baseInstaller.install(ctx, file)
|
|
}
|
|
|
|
if Bool(library.Properties.Static_ndk_lib) && library.static() &&
|
|
!ctx.InVendorOrProduct() && !ctx.inRamdisk() && !ctx.inVendorRamdisk() && !ctx.inRecovery() && ctx.Device() &&
|
|
library.baseLinker.sanitize.isUnsanitizedVariant() &&
|
|
ctx.isForPlatform() && !ctx.isPreventInstall() {
|
|
installPath := getUnversionedLibraryInstallPath(ctx).Join(ctx, file.Base())
|
|
|
|
ctx.ModuleBuild(pctx, android.ModuleBuildParams{
|
|
Rule: android.Cp,
|
|
Description: "install " + installPath.Base(),
|
|
Output: installPath,
|
|
Input: file,
|
|
})
|
|
|
|
library.ndkSysrootPath = installPath
|
|
}
|
|
}
|
|
|
|
func (library *libraryDecorator) everInstallable() bool {
|
|
// Only shared and static libraries are installed. Header libraries (which are
|
|
// neither static or shared) are not installed.
|
|
return library.shared() || library.static()
|
|
}
|
|
|
|
// static returns true if this library is for a "static' variant.
|
|
func (library *libraryDecorator) static() bool {
|
|
return library.MutatedProperties.VariantIsStatic
|
|
}
|
|
|
|
// shared returns true if this library is for a "shared' variant.
|
|
func (library *libraryDecorator) shared() bool {
|
|
return library.MutatedProperties.VariantIsShared
|
|
}
|
|
|
|
// header returns true if this library is for a header-only variant.
|
|
func (library *libraryDecorator) header() bool {
|
|
// Neither "static" nor "shared" implies this library is header-only.
|
|
return !library.static() && !library.shared()
|
|
}
|
|
|
|
// setStatic marks the library variant as "static".
|
|
func (library *libraryDecorator) setStatic() {
|
|
library.MutatedProperties.VariantIsStatic = true
|
|
library.MutatedProperties.VariantIsShared = false
|
|
}
|
|
|
|
// setShared marks the library variant as "shared".
|
|
func (library *libraryDecorator) setShared() {
|
|
library.MutatedProperties.VariantIsStatic = false
|
|
library.MutatedProperties.VariantIsShared = true
|
|
}
|
|
|
|
// BuildOnlyStatic disables building this library as a shared library.
|
|
func (library *libraryDecorator) BuildOnlyStatic() {
|
|
library.MutatedProperties.BuildShared = false
|
|
}
|
|
|
|
// BuildOnlyShared disables building this library as a static library.
|
|
func (library *libraryDecorator) BuildOnlyShared() {
|
|
library.MutatedProperties.BuildStatic = false
|
|
}
|
|
|
|
// HeaderOnly disables building this library as a shared or static library;
|
|
// the library only exists to propagate header file dependencies up the build graph.
|
|
func (library *libraryDecorator) HeaderOnly() {
|
|
library.MutatedProperties.BuildShared = false
|
|
library.MutatedProperties.BuildStatic = false
|
|
}
|
|
|
|
// hasLLNDKStubs returns true if this cc_library module has a variant that will build LLNDK stubs.
|
|
func (library *libraryDecorator) hasLLNDKStubs() bool {
|
|
return String(library.Properties.Llndk.Symbol_file) != ""
|
|
}
|
|
|
|
// hasLLNDKStubs returns true if this cc_library module has a variant that will build LLNDK stubs.
|
|
func (library *libraryDecorator) hasLLNDKHeaders() bool {
|
|
return Bool(library.Properties.Llndk.Llndk_headers)
|
|
}
|
|
|
|
// hasVendorPublicLibrary returns true if this cc_library module has a variant that will build
|
|
// vendor public library stubs.
|
|
func (library *libraryDecorator) hasVendorPublicLibrary() bool {
|
|
return String(library.Properties.Vendor_public_library.Symbol_file) != ""
|
|
}
|
|
|
|
func (library *libraryDecorator) implementationModuleName(name string) string {
|
|
return name
|
|
}
|
|
|
|
func (library *libraryDecorator) buildStubs() bool {
|
|
return library.MutatedProperties.BuildStubs
|
|
}
|
|
|
|
func (library *libraryDecorator) symbolFileForAbiCheck(ctx ModuleContext) *string {
|
|
if props := library.getHeaderAbiCheckerProperties(ctx); props.Symbol_file != nil {
|
|
return props.Symbol_file
|
|
}
|
|
if ctx.Module().(*Module).IsLlndk() {
|
|
return library.Properties.Llndk.Symbol_file
|
|
}
|
|
if library.hasStubsVariants() && library.Properties.Stubs.Symbol_file != nil {
|
|
return library.Properties.Stubs.Symbol_file
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (library *libraryDecorator) hasStubsVariants() bool {
|
|
// Just having stubs.symbol_file is enough to create a stub variant. In that case
|
|
// the stub for the future API level is created.
|
|
return library.Properties.Stubs.Symbol_file != nil ||
|
|
len(library.Properties.Stubs.Versions) > 0
|
|
}
|
|
|
|
func (library *libraryDecorator) isStubsImplementationRequired() bool {
|
|
return BoolDefault(library.Properties.Stubs.Implementation_installable, true)
|
|
}
|
|
|
|
func (library *libraryDecorator) stubsVersions(ctx android.BaseMutatorContext) []string {
|
|
if !library.hasStubsVariants() {
|
|
return nil
|
|
}
|
|
|
|
if library.hasLLNDKStubs() && ctx.Module().(*Module).InVendorOrProduct() {
|
|
// LLNDK libraries only need a single stubs variant.
|
|
return []string{android.FutureApiLevel.String()}
|
|
}
|
|
|
|
// Future API level is implicitly added if there isn't
|
|
return addCurrentVersionIfNotPresent(library.Properties.Stubs.Versions)
|
|
}
|
|
|
|
func addCurrentVersionIfNotPresent(vers []string) []string {
|
|
if inList(android.FutureApiLevel.String(), vers) {
|
|
return vers
|
|
}
|
|
// In some cases, people use the raw value "10000" in the versions property.
|
|
// We shouldn't add the future API level in that case, otherwise there will
|
|
// be two identical versions.
|
|
if inList(strconv.Itoa(android.FutureApiLevel.FinalOrFutureInt()), vers) {
|
|
return vers
|
|
}
|
|
return append(vers, android.FutureApiLevel.String())
|
|
}
|
|
|
|
func (library *libraryDecorator) setStubsVersion(version string) {
|
|
library.MutatedProperties.StubsVersion = version
|
|
}
|
|
|
|
func (library *libraryDecorator) stubsVersion() string {
|
|
return library.MutatedProperties.StubsVersion
|
|
}
|
|
|
|
func (library *libraryDecorator) setBuildStubs(isLatest bool) {
|
|
library.MutatedProperties.BuildStubs = true
|
|
library.MutatedProperties.IsLatestVersion = isLatest
|
|
}
|
|
|
|
func (library *libraryDecorator) setAllStubsVersions(versions []string) {
|
|
library.MutatedProperties.AllStubsVersions = versions
|
|
}
|
|
|
|
func (library *libraryDecorator) allStubsVersions() []string {
|
|
return library.MutatedProperties.AllStubsVersions
|
|
}
|
|
|
|
func (library *libraryDecorator) isLatestStubVersion() bool {
|
|
return library.MutatedProperties.IsLatestVersion
|
|
}
|
|
|
|
func (library *libraryDecorator) availableFor(what string) bool {
|
|
var list []string
|
|
if library.static() {
|
|
list = library.StaticProperties.Static.Apex_available
|
|
} else if library.shared() {
|
|
list = library.SharedProperties.Shared.Apex_available
|
|
}
|
|
if len(list) == 0 {
|
|
return false
|
|
}
|
|
return android.CheckAvailableForApex(what, list)
|
|
}
|
|
|
|
func (library *libraryDecorator) installable() *bool {
|
|
if library.static() {
|
|
return library.StaticProperties.Static.Installable
|
|
} else if library.shared() {
|
|
return library.SharedProperties.Shared.Installable
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (library *libraryDecorator) makeUninstallable(mod *Module) {
|
|
if library.static() && library.buildStatic() && !library.buildStubs() {
|
|
// If we're asked to make a static library uninstallable we don't do
|
|
// anything since AndroidMkEntries always sets LOCAL_UNINSTALLABLE_MODULE
|
|
// for these entries. This is done to still get the make targets for NOTICE
|
|
// files from notice_files.mk, which other libraries might depend on.
|
|
return
|
|
}
|
|
mod.ModuleBase.MakeUninstallable()
|
|
}
|
|
|
|
func (library *libraryDecorator) getPartition() string {
|
|
return library.path.Partition()
|
|
}
|
|
|
|
func (library *libraryDecorator) getAPIListCoverageXMLPath() android.ModuleOutPath {
|
|
return library.apiListCoverageXmlPath
|
|
}
|
|
|
|
func (library *libraryDecorator) overriddenModules() []string {
|
|
return library.Properties.Overrides
|
|
}
|
|
|
|
var _ overridable = (*libraryDecorator)(nil)
|
|
|
|
var versioningMacroNamesListKey = android.NewOnceKey("versioningMacroNamesList")
|
|
|
|
// versioningMacroNamesList returns a singleton map, where keys are "version macro names",
|
|
// and values are the module name responsible for registering the version macro name.
|
|
//
|
|
// Version macros are used when building against stubs, to provide version information about
|
|
// the stub. Only stub libraries should have an entry in this list.
|
|
//
|
|
// For example, when building against libFoo#ver, __LIBFOO_API__ macro is set to ver so
|
|
// that headers from libFoo can be conditionally compiled (this may hide APIs
|
|
// that are not available for the version).
|
|
//
|
|
// This map is used to ensure that there aren't conflicts between these version macro names.
|
|
func versioningMacroNamesList(config android.Config) *map[string]string {
|
|
return config.Once(versioningMacroNamesListKey, func() interface{} {
|
|
m := make(map[string]string)
|
|
return &m
|
|
}).(*map[string]string)
|
|
}
|
|
|
|
// alphanumeric and _ characters are preserved.
|
|
// other characters are all converted to _
|
|
var charsNotForMacro = regexp.MustCompile("[^a-zA-Z0-9_]+")
|
|
|
|
// versioningMacroName returns the canonical version macro name for the given module.
|
|
func versioningMacroName(moduleName string) string {
|
|
macroName := charsNotForMacro.ReplaceAllString(moduleName, "_")
|
|
macroName = strings.ToUpper(macroName)
|
|
return "__" + macroName + "_API__"
|
|
}
|
|
|
|
// NewLibrary builds and returns a new Module corresponding to a C++ library.
|
|
// Individual module implementations which comprise a C++ library (or something like
|
|
// a C++ library) should call this function, set some fields on the result, and
|
|
// then call the Init function.
|
|
func NewLibrary(hod android.HostOrDeviceSupported) (*Module, *libraryDecorator) {
|
|
module := newModule(hod, android.MultilibBoth)
|
|
|
|
library := &libraryDecorator{
|
|
MutatedProperties: LibraryMutatedProperties{
|
|
BuildShared: true,
|
|
BuildStatic: true,
|
|
},
|
|
baseCompiler: NewBaseCompiler(),
|
|
baseLinker: NewBaseLinker(module.sanitize),
|
|
baseInstaller: NewBaseInstaller("lib", "lib64", InstallInSystem),
|
|
sabi: module.sabi,
|
|
}
|
|
|
|
module.compiler = library
|
|
module.linker = library
|
|
module.installer = library
|
|
module.library = library
|
|
|
|
return module, library
|
|
}
|
|
|
|
// connects a shared library to a static library in order to reuse its .o files to avoid
|
|
// compiling source files twice.
|
|
func reuseStaticLibrary(mctx android.BottomUpMutatorContext, static, shared *Module) {
|
|
if staticCompiler, ok := static.compiler.(*libraryDecorator); ok {
|
|
sharedCompiler := shared.compiler.(*libraryDecorator)
|
|
|
|
// Check libraries in addition to cflags, since libraries may be exporting different
|
|
// include directories.
|
|
if len(staticCompiler.StaticProperties.Static.Cflags) == 0 &&
|
|
len(sharedCompiler.SharedProperties.Shared.Cflags) == 0 &&
|
|
len(staticCompiler.StaticProperties.Static.Whole_static_libs) == 0 &&
|
|
len(sharedCompiler.SharedProperties.Shared.Whole_static_libs) == 0 &&
|
|
len(staticCompiler.StaticProperties.Static.Static_libs) == 0 &&
|
|
len(sharedCompiler.SharedProperties.Shared.Static_libs) == 0 &&
|
|
len(staticCompiler.StaticProperties.Static.Shared_libs) == 0 &&
|
|
len(sharedCompiler.SharedProperties.Shared.Shared_libs) == 0 &&
|
|
// Compare System_shared_libs properties with nil because empty lists are
|
|
// semantically significant for them.
|
|
staticCompiler.StaticProperties.Static.System_shared_libs == nil &&
|
|
sharedCompiler.SharedProperties.Shared.System_shared_libs == nil {
|
|
|
|
mctx.AddInterVariantDependency(reuseObjTag, shared, static)
|
|
sharedCompiler.baseCompiler.Properties.OriginalSrcs =
|
|
sharedCompiler.baseCompiler.Properties.Srcs
|
|
sharedCompiler.baseCompiler.Properties.Srcs = nil
|
|
sharedCompiler.baseCompiler.Properties.Generated_sources = nil
|
|
}
|
|
|
|
// This dep is just to reference static variant from shared variant
|
|
mctx.AddInterVariantDependency(staticVariantTag, shared, static)
|
|
}
|
|
}
|
|
|
|
// LinkageMutator adds "static" or "shared" variants for modules depending
|
|
// on whether the module can be built as a static library or a shared library.
|
|
func LinkageMutator(mctx android.BottomUpMutatorContext) {
|
|
ccPrebuilt := false
|
|
if m, ok := mctx.Module().(*Module); ok && m.linker != nil {
|
|
_, ccPrebuilt = m.linker.(prebuiltLibraryInterface)
|
|
}
|
|
if ccPrebuilt {
|
|
library := mctx.Module().(*Module).linker.(prebuiltLibraryInterface)
|
|
|
|
// Differentiate between header only and building an actual static/shared library
|
|
buildStatic := library.buildStatic()
|
|
buildShared := library.buildShared()
|
|
if buildStatic || buildShared {
|
|
// Always create both the static and shared variants for prebuilt libraries, and then disable the one
|
|
// that is not being used. This allows them to share the name of a cc_library module, which requires that
|
|
// all the variants of the cc_library also exist on the prebuilt.
|
|
modules := mctx.CreateLocalVariations("static", "shared")
|
|
static := modules[0].(*Module)
|
|
shared := modules[1].(*Module)
|
|
|
|
static.linker.(prebuiltLibraryInterface).setStatic()
|
|
shared.linker.(prebuiltLibraryInterface).setShared()
|
|
|
|
if buildShared {
|
|
mctx.AliasVariation("shared")
|
|
} else if buildStatic {
|
|
mctx.AliasVariation("static")
|
|
}
|
|
|
|
if !buildStatic {
|
|
static.linker.(prebuiltLibraryInterface).disablePrebuilt()
|
|
}
|
|
if !buildShared {
|
|
shared.linker.(prebuiltLibraryInterface).disablePrebuilt()
|
|
}
|
|
} else {
|
|
// Header only
|
|
}
|
|
|
|
} else if library, ok := mctx.Module().(LinkableInterface); ok && library.CcLibraryInterface() {
|
|
|
|
// Non-cc.Modules may need an empty variant for their mutators.
|
|
variations := []string{}
|
|
if library.NonCcVariants() {
|
|
variations = append(variations, "")
|
|
}
|
|
|
|
isLLNDK := false
|
|
if m, ok := mctx.Module().(*Module); ok {
|
|
isLLNDK = m.IsLlndk()
|
|
}
|
|
buildStatic := library.BuildStaticVariant() && !isLLNDK
|
|
buildShared := library.BuildSharedVariant()
|
|
if buildStatic && buildShared {
|
|
variations := append([]string{"static", "shared"}, variations...)
|
|
|
|
modules := mctx.CreateLocalVariations(variations...)
|
|
static := modules[0].(LinkableInterface)
|
|
shared := modules[1].(LinkableInterface)
|
|
|
|
static.SetStatic()
|
|
shared.SetShared()
|
|
|
|
if _, ok := library.(*Module); ok {
|
|
reuseStaticLibrary(mctx, static.(*Module), shared.(*Module))
|
|
}
|
|
mctx.AliasVariation("shared")
|
|
} else if buildStatic {
|
|
variations := append([]string{"static"}, variations...)
|
|
|
|
modules := mctx.CreateLocalVariations(variations...)
|
|
modules[0].(LinkableInterface).SetStatic()
|
|
mctx.AliasVariation("static")
|
|
} else if buildShared {
|
|
variations := append([]string{"shared"}, variations...)
|
|
|
|
modules := mctx.CreateLocalVariations(variations...)
|
|
modules[0].(LinkableInterface).SetShared()
|
|
mctx.AliasVariation("shared")
|
|
} else if len(variations) > 0 {
|
|
mctx.CreateLocalVariations(variations...)
|
|
mctx.AliasVariation(variations[0])
|
|
}
|
|
}
|
|
}
|
|
|
|
// normalizeVersions modifies `versions` in place, so that each raw version
|
|
// string becomes its normalized canonical form.
|
|
// Validates that the versions in `versions` are specified in least to greatest order.
|
|
func normalizeVersions(ctx android.BaseModuleContext, versions []string) {
|
|
var previous android.ApiLevel
|
|
for i, v := range versions {
|
|
ver, err := android.ApiLevelFromUser(ctx, v)
|
|
if err != nil {
|
|
ctx.PropertyErrorf("versions", "%s", err.Error())
|
|
return
|
|
}
|
|
if i > 0 && ver.LessThanOrEqualTo(previous) {
|
|
ctx.PropertyErrorf("versions", "not sorted: %v", versions)
|
|
}
|
|
versions[i] = ver.String()
|
|
previous = ver
|
|
}
|
|
}
|
|
|
|
func createVersionVariations(mctx android.BottomUpMutatorContext, versions []string) {
|
|
// "" is for the non-stubs (implementation) variant for system modules, or the LLNDK variant
|
|
// for LLNDK modules.
|
|
variants := append(android.CopyOf(versions), "")
|
|
|
|
m := mctx.Module().(*Module)
|
|
isLLNDK := m.IsLlndk()
|
|
isVendorPublicLibrary := m.IsVendorPublicLibrary()
|
|
isImportedApiLibrary := m.isImportedApiLibrary()
|
|
|
|
modules := mctx.CreateLocalVariations(variants...)
|
|
for i, m := range modules {
|
|
|
|
if variants[i] != "" || isLLNDK || isVendorPublicLibrary || isImportedApiLibrary {
|
|
// A stubs or LLNDK stubs variant.
|
|
c := m.(*Module)
|
|
c.sanitize = nil
|
|
c.stl = nil
|
|
c.Properties.PreventInstall = true
|
|
lib := moduleLibraryInterface(m)
|
|
isLatest := i == (len(versions) - 1)
|
|
lib.setBuildStubs(isLatest)
|
|
|
|
if variants[i] != "" {
|
|
// A non-LLNDK stubs module is hidden from make and has a dependency from the
|
|
// implementation module to the stubs module.
|
|
c.Properties.HideFromMake = true
|
|
lib.setStubsVersion(variants[i])
|
|
mctx.AddInterVariantDependency(stubImplDepTag, modules[len(modules)-1], modules[i])
|
|
}
|
|
}
|
|
}
|
|
mctx.AliasVariation("")
|
|
latestVersion := ""
|
|
if len(versions) > 0 {
|
|
latestVersion = versions[len(versions)-1]
|
|
}
|
|
mctx.CreateAliasVariation("latest", latestVersion)
|
|
}
|
|
|
|
func createPerApiVersionVariations(mctx android.BottomUpMutatorContext, minSdkVersion string) {
|
|
from, err := nativeApiLevelFromUser(mctx, minSdkVersion)
|
|
if err != nil {
|
|
mctx.PropertyErrorf("min_sdk_version", err.Error())
|
|
return
|
|
}
|
|
|
|
versionStrs := ndkLibraryVersions(mctx, from)
|
|
modules := mctx.CreateLocalVariations(versionStrs...)
|
|
|
|
for i, module := range modules {
|
|
module.(*Module).Properties.Sdk_version = StringPtr(versionStrs[i])
|
|
module.(*Module).Properties.Min_sdk_version = StringPtr(versionStrs[i])
|
|
}
|
|
}
|
|
|
|
func canBeOrLinkAgainstVersionVariants(module interface {
|
|
Host() bool
|
|
InRamdisk() bool
|
|
InVendorRamdisk() bool
|
|
}) bool {
|
|
return !module.Host() && !module.InRamdisk() && !module.InVendorRamdisk()
|
|
}
|
|
|
|
func canBeVersionVariant(module interface {
|
|
Host() bool
|
|
InRamdisk() bool
|
|
InVendorRamdisk() bool
|
|
CcLibraryInterface() bool
|
|
Shared() bool
|
|
}) bool {
|
|
return canBeOrLinkAgainstVersionVariants(module) &&
|
|
module.CcLibraryInterface() && module.Shared()
|
|
}
|
|
|
|
func moduleLibraryInterface(module blueprint.Module) libraryInterface {
|
|
if m, ok := module.(*Module); ok {
|
|
return m.library
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// setStubsVersions normalizes the versions in the Stubs.Versions property into MutatedProperties.AllStubsVersions.
|
|
func setStubsVersions(mctx android.BottomUpMutatorContext, library libraryInterface, module *Module) {
|
|
if !library.buildShared() || !canBeVersionVariant(module) {
|
|
return
|
|
}
|
|
versions := library.stubsVersions(mctx)
|
|
if len(versions) <= 0 {
|
|
return
|
|
}
|
|
normalizeVersions(mctx, versions)
|
|
if mctx.Failed() {
|
|
return
|
|
}
|
|
// Set the versions on the pre-mutated module so they can be read by any llndk modules that
|
|
// depend on the implementation library and haven't been mutated yet.
|
|
library.setAllStubsVersions(versions)
|
|
}
|
|
|
|
// versionMutator splits a module into the mandatory non-stubs variant
|
|
// (which is unnamed) and zero or more stubs variants.
|
|
func versionMutator(mctx android.BottomUpMutatorContext) {
|
|
if mctx.Os() != android.Android {
|
|
return
|
|
}
|
|
|
|
m, ok := mctx.Module().(*Module)
|
|
if library := moduleLibraryInterface(mctx.Module()); library != nil && canBeVersionVariant(m) {
|
|
setStubsVersions(mctx, library, m)
|
|
|
|
createVersionVariations(mctx, library.allStubsVersions())
|
|
return
|
|
}
|
|
|
|
if ok {
|
|
if m.SplitPerApiLevel() && m.IsSdkVariant() {
|
|
createPerApiVersionVariations(mctx, m.MinSdkVersion())
|
|
}
|
|
}
|
|
}
|
|
|
|
// maybeInjectBoringSSLHash adds a rule to run bssl_inject_hash on the output file if the module has the
|
|
// inject_bssl_hash or if any static library dependencies have inject_bssl_hash set. It returns the output path
|
|
// that the linked output file should be written to.
|
|
// TODO(b/137267623): Remove this in favor of a cc_genrule when they support operating on shared libraries.
|
|
func maybeInjectBoringSSLHash(ctx android.ModuleContext, outputFile android.ModuleOutPath,
|
|
inject *bool, fileName string) android.ModuleOutPath {
|
|
// TODO(b/137267623): Remove this in favor of a cc_genrule when they support operating on shared libraries.
|
|
injectBoringSSLHash := Bool(inject)
|
|
ctx.VisitDirectDeps(func(dep android.Module) {
|
|
if tag, ok := ctx.OtherModuleDependencyTag(dep).(libraryDependencyTag); ok && tag.static() {
|
|
if cc, ok := dep.(*Module); ok {
|
|
if library, ok := cc.linker.(*libraryDecorator); ok {
|
|
if Bool(library.Properties.Inject_bssl_hash) {
|
|
injectBoringSSLHash = true
|
|
}
|
|
}
|
|
}
|
|
}
|
|
})
|
|
if injectBoringSSLHash {
|
|
hashedOutputfile := outputFile
|
|
outputFile = android.PathForModuleOut(ctx, "unhashed", fileName)
|
|
|
|
rule := android.NewRuleBuilder(pctx, ctx)
|
|
rule.Command().
|
|
BuiltTool("bssl_inject_hash").
|
|
FlagWithInput("-in-object ", outputFile).
|
|
FlagWithOutput("-o ", hashedOutputfile)
|
|
rule.Build("injectCryptoHash", "inject crypto hash")
|
|
}
|
|
|
|
return outputFile
|
|
}
|