// Copyright 2017 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" "path/filepath" "strings" "android/soong/android" ) var llndkImplDep = dependencyTag{name: "llndk impl"} var ( llndkLibrarySuffix = ".llndk" llndkHeadersSuffix = ".llndk" ) // Creates a stub shared library based on the provided version file. // // Example: // // llndk_library { // name: "libfoo", // symbol_file: "libfoo.map.txt", // export_include_dirs: ["include_vndk"], // } // type llndkLibraryProperties struct { // Relative path to the symbol map. // An example file can be seen here: TODO(danalbert): Make an example. Symbol_file *string // Whether to export any headers as -isystem instead of -I. Mainly for use by // bionic/libc. Export_headers_as_system *bool // Which headers to process with versioner. This really only handles // bionic/libc/include right now. Export_preprocessed_headers []string // Whether the system library uses symbol versions. Unversioned *bool // whether this module can be directly depended upon by libs that are installed // to /vendor and /product. // When set to false, this module can only be depended on by VNDK libraries, not // vendor nor product libraries. This effectively hides this module from // non-system modules. Default value is true. Vendor_available *bool // list of llndk headers to re-export include directories from. Export_llndk_headers []string `android:"arch_variant"` } type llndkStubDecorator struct { *libraryDecorator Properties llndkLibraryProperties movedToApex bool } var _ versionedInterface = (*llndkStubDecorator)(nil) func (stub *llndkStubDecorator) compilerFlags(ctx ModuleContext, flags Flags, deps PathDeps) Flags { flags = stub.baseCompiler.compilerFlags(ctx, flags, deps) return addStubLibraryCompilerFlags(flags) } func (stub *llndkStubDecorator) compile(ctx ModuleContext, flags Flags, deps PathDeps) Objects { 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 stub.stubsVersion() != "" { vndkVer = stub.stubsVersion() } objs, versionScript := compileStubLibrary(ctx, flags, String(stub.Properties.Symbol_file), vndkVer, "--llndk") if !Bool(stub.Properties.Unversioned) { stub.versionScriptPath = android.OptionalPathForPath(versionScript) } return objs } func (stub *llndkStubDecorator) linkerDeps(ctx DepsContext, deps Deps) Deps { headers := addSuffix(stub.Properties.Export_llndk_headers, llndkHeadersSuffix) deps.HeaderLibs = append(deps.HeaderLibs, headers...) deps.ReexportHeaderLibHeaders = append(deps.ReexportHeaderLibHeaders, headers...) return deps } func (stub *llndkStubDecorator) Name(name string) string { if strings.HasSuffix(name, llndkLibrarySuffix) { return name } return name + llndkLibrarySuffix } func (stub *llndkStubDecorator) linkerFlags(ctx ModuleContext, flags Flags) Flags { stub.libraryDecorator.libName = stub.implementationModuleName(ctx.ModuleName()) return stub.libraryDecorator.linkerFlags(ctx, flags) } func (stub *llndkStubDecorator) processHeaders(ctx ModuleContext, srcHeaderDir string, outDir android.ModuleGenPath) android.Path { srcDir := android.PathForModuleSrc(ctx, srcHeaderDir) srcFiles := ctx.GlobFiles(filepath.Join(srcDir.String(), "**/*.h"), nil) var installPaths []android.WritablePath 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) } func (stub *llndkStubDecorator) link(ctx ModuleContext, flags Flags, deps PathDeps, objs Objects) android.Path { impl := ctx.GetDirectDepWithTag(stub.implementationModuleName(ctx.ModuleName()), llndkImplDep) if implApexModule, ok := impl.(android.ApexModule); ok { stub.movedToApex = implApexModule.DirectlyInAnyApex() } if len(stub.Properties.Export_preprocessed_headers) > 0 { genHeaderOutDir := android.PathForModuleGen(ctx, "include") var timestampFiles android.Paths for _, dir := range stub.Properties.Export_preprocessed_headers { timestampFiles = append(timestampFiles, stub.processHeaders(ctx, dir, genHeaderOutDir)) } if Bool(stub.Properties.Export_headers_as_system) { stub.reexportSystemDirs(genHeaderOutDir) } else { stub.reexportDirs(genHeaderOutDir) } stub.reexportDeps(timestampFiles...) } if Bool(stub.Properties.Export_headers_as_system) { stub.exportIncludesAsSystem(ctx) stub.libraryDecorator.flagExporter.Properties.Export_include_dirs = []string{} } return stub.libraryDecorator.link(ctx, flags, deps, objs) } func (stub *llndkStubDecorator) nativeCoverage() bool { return false } func (stub *llndkStubDecorator) implementationModuleName(name string) string { return strings.TrimSuffix(name, llndkLibrarySuffix) } func (stub *llndkStubDecorator) buildStubs() bool { return true } func (stub *llndkStubDecorator) stubsVersions(ctx android.BaseMutatorContext) []string { // Get the versions from the implementation module. impls := ctx.GetDirectDepsWithTag(llndkImplDep) if len(impls) > 1 { panic(fmt.Errorf("Expected single implmenetation library, got %d", len(impls))) } else if len(impls) == 1 { return moduleLibraryInterface(impls[0]).allStubsVersions() } return nil } func NewLLndkStubLibrary() *Module { module, library := NewLibrary(android.DeviceSupported) library.BuildOnlyShared() module.stl = nil module.sanitize = nil library.disableStripping() stub := &llndkStubDecorator{ libraryDecorator: library, } stub.Properties.Vendor_available = BoolPtr(true) module.compiler = stub module.linker = stub module.installer = nil module.library = stub module.AddProperties( &module.Properties, &stub.Properties, &library.MutatedProperties, &library.flagExporter.Properties) return module } // llndk_library creates a stub llndk shared library based on the provided // version file. Example: // // llndk_library { // name: "libfoo", // symbol_file: "libfoo.map.txt", // export_include_dirs: ["include_vndk"], // } func LlndkLibraryFactory() android.Module { module := NewLLndkStubLibrary() android.InitAndroidArchModule(module, android.DeviceSupported, android.MultilibBoth) return module } type llndkHeadersDecorator struct { *libraryDecorator } func (headers *llndkHeadersDecorator) Name(name string) string { return name + llndkHeadersSuffix } // llndk_headers contains a set of c/c++ llndk headers files which are imported // by other soongs cc modules. func llndkHeadersFactory() android.Module { module, library := NewLibrary(android.DeviceSupported) library.HeaderOnly() module.stl = nil module.sanitize = nil decorator := &llndkHeadersDecorator{ libraryDecorator: library, } module.compiler = nil module.linker = decorator module.installer = nil module.library = decorator module.AddProperties( &module.Properties, &library.MutatedProperties, &library.flagExporter.Properties) module.Init() return module } func init() { android.RegisterModuleType("llndk_library", LlndkLibraryFactory) android.RegisterModuleType("llndk_headers", llndkHeadersFactory) }