cc/prebuilt.go - platform/build/soong - Git at Google

 // 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 (
 	"android/soong/android"
 	"path/filepath"
 	"strings"
 )

 func init() {
 	RegisterPrebuiltBuildComponents(android.InitRegistrationContext)
 }

 func RegisterPrebuiltBuildComponents(ctx android.RegistrationContext) {
 	ctx.RegisterModuleType("cc_prebuilt_library", PrebuiltLibraryFactory)
 	ctx.RegisterModuleType("cc_prebuilt_library_shared", PrebuiltSharedLibraryFactory)
 	ctx.RegisterModuleType("cc_prebuilt_library_static", PrebuiltStaticLibraryFactory)
 	ctx.RegisterModuleType("cc_prebuilt_test_library_shared", PrebuiltSharedTestLibraryFactory)
 	ctx.RegisterModuleType("cc_prebuilt_object", prebuiltObjectFactory)
 	ctx.RegisterModuleType("cc_prebuilt_binary", prebuiltBinaryFactory)
 }

 type prebuiltLinkerInterface interface {
 	Name(string) string
 	prebuilt() *android.Prebuilt
 }

 type prebuiltLinkerProperties struct {
 	// a prebuilt library or binary. Can reference a genrule module that generates an executable file.
 	Srcs []string `android:"path,arch_variant"`

 	Sanitized Sanitized `android:"arch_variant"`

 	// Check the prebuilt ELF files (e.g. DT_SONAME, DT_NEEDED, resolution of undefined
 	// symbols, etc), default true.
 	Check_elf_files *bool

 	// Optionally provide an import library if this is a Windows PE DLL prebuilt.
 	// This is needed only if this library is linked by other modules in build time.
 	// Only makes sense for the Windows target.
 	Windows_import_lib *string `android:"path,arch_variant"`
 }

 type prebuiltLinker struct {
 	android.Prebuilt

 	properties prebuiltLinkerProperties
 }

 func (p *prebuiltLinker) prebuilt() *android.Prebuilt {
 	return &p.Prebuilt
 }

 func (p *prebuiltLinker) PrebuiltSrcs() []string {
 	return p.properties.Srcs
 }

 type prebuiltLibraryInterface interface {
 	libraryInterface
 	prebuiltLinkerInterface
 	disablePrebuilt()
 }

 type prebuiltLibraryLinker struct {
 	*libraryDecorator
 	prebuiltLinker
 }

 var _ prebuiltLinkerInterface = (*prebuiltLibraryLinker)(nil)
 var _ prebuiltLibraryInterface = (*prebuiltLibraryLinker)(nil)

 func (p *prebuiltLibraryLinker) linkerInit(ctx BaseModuleContext) {}

 func (p *prebuiltLibraryLinker) linkerDeps(ctx DepsContext, deps Deps) Deps {
 	return p.libraryDecorator.linkerDeps(ctx, deps)
 }

 func (p *prebuiltLibraryLinker) linkerFlags(ctx ModuleContext, flags Flags) Flags {
 	return flags
 }

 func (p *prebuiltLibraryLinker) linkerProps() []interface{} {
 	return p.libraryDecorator.linkerProps()
 }

 func (p *prebuiltLibraryLinker) link(ctx ModuleContext,
 	flags Flags, deps PathDeps, objs Objects) android.Path {

 	p.libraryDecorator.flagExporter.exportIncludes(ctx)
 	p.libraryDecorator.flagExporter.reexportDirs(deps.ReexportedDirs...)
 	p.libraryDecorator.flagExporter.reexportSystemDirs(deps.ReexportedSystemDirs...)
 	p.libraryDecorator.flagExporter.reexportFlags(deps.ReexportedFlags...)
 	p.libraryDecorator.flagExporter.reexportDeps(deps.ReexportedDeps...)
 	p.libraryDecorator.flagExporter.addExportedGeneratedHeaders(deps.ReexportedGeneratedHeaders...)

 	p.libraryDecorator.flagExporter.setProvider(ctx)

 	// TODO(ccross): verify shared library dependencies
 	srcs := p.prebuiltSrcs(ctx)
 	if len(srcs) > 0 {
 		builderFlags := flagsToBuilderFlags(flags)

 		if len(srcs) > 1 {
 			ctx.PropertyErrorf("srcs", "multiple prebuilt source files")
 			return nil
 		}

 		p.libraryDecorator.exportVersioningMacroIfNeeded(ctx)

 		in := android.PathForModuleSrc(ctx, srcs[0])

 		if p.static() {
 			depSet := android.NewDepSetBuilder(android.TOPOLOGICAL).Direct(in).Build()
 			ctx.SetProvider(StaticLibraryInfoProvider, StaticLibraryInfo{
 				StaticLibrary: in,

 				TransitiveStaticLibrariesForOrdering: depSet,
 			})
 			return in
 		}

 		if p.shared() {
 			p.unstrippedOutputFile = in
 			libName := p.libraryDecorator.getLibName(ctx) + flags.Toolchain.ShlibSuffix()
 			outputFile := android.PathForModuleOut(ctx, libName)
 			var implicits android.Paths

 			if p.stripper.NeedsStrip(ctx) {
 				stripFlags := flagsToStripFlags(flags)
 				stripped := android.PathForModuleOut(ctx, "stripped", libName)
 				p.stripper.StripExecutableOrSharedLib(ctx, in, stripped, stripFlags)
 				in = stripped
 			}

 			// 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 := android.PathForModuleOut(ctx, libName+".toc")
 			p.tocFile = android.OptionalPathForPath(tocFile)
 			transformSharedObjectToToc(ctx, outputFile, tocFile, builderFlags)

 			if ctx.Windows() && p.properties.Windows_import_lib != nil {
 				// Consumers of this library actually links to the import library in build
 				// time and dynamically links to the DLL in run time. i.e.
 				// a.exe <-- static link --> foo.lib <-- dynamic link --> foo.dll
 				importLibSrc := android.PathForModuleSrc(ctx, String(p.properties.Windows_import_lib))
 				importLibName := p.libraryDecorator.getLibName(ctx) + ".lib"
 				importLibOutputFile := android.PathForModuleOut(ctx, importLibName)
 				implicits = append(implicits, importLibOutputFile)

 				ctx.Build(pctx, android.BuildParams{
 					Rule:        android.Cp,
 					Description: "prebuilt import library",
 					Input:       importLibSrc,
 					Output:      importLibOutputFile,
 					Args: map[string]string{
 						"cpFlags": "-L",
 					},
 				})
 			}

 			ctx.Build(pctx, android.BuildParams{
 				Rule:        android.Cp,
 				Description: "prebuilt shared library",
 				Implicits:   implicits,
 				Input:       in,
 				Output:      outputFile,
 				Args: map[string]string{
 					"cpFlags": "-L",
 				},
 			})

 			ctx.SetProvider(SharedLibraryInfoProvider, SharedLibraryInfo{
 				SharedLibrary: outputFile,
 				Target:        ctx.Target(),

 				TableOfContents: p.tocFile,
 			})

 			return outputFile
 		}
 	}

 	if p.header() {
 		ctx.SetProvider(HeaderLibraryInfoProvider, HeaderLibraryInfo{})

 		return nil
 	}

 	return nil
 }

 func (p *prebuiltLibraryLinker) prebuiltSrcs(ctx android.BaseModuleContext) []string {
 	sanitize := ctx.Module().(*Module).sanitize
 	srcs := p.properties.Srcs
 	srcs = append(srcs, srcsForSanitizer(sanitize, p.properties.Sanitized)...)
 	if p.static() {
 		srcs = append(srcs, p.libraryDecorator.StaticProperties.Static.Srcs...)
 		srcs = append(srcs, srcsForSanitizer(sanitize, p.libraryDecorator.StaticProperties.Static.Sanitized)...)
 	}
 	if p.shared() {
 		srcs = append(srcs, p.libraryDecorator.SharedProperties.Shared.Srcs...)
 		srcs = append(srcs, srcsForSanitizer(sanitize, p.libraryDecorator.SharedProperties.Shared.Sanitized)...)
 	}
 	return srcs
 }

 func (p *prebuiltLibraryLinker) shared() bool {
 	return p.libraryDecorator.shared()
 }

 func (p *prebuiltLibraryLinker) nativeCoverage() bool {
 	return false
 }

 func (p *prebuiltLibraryLinker) disablePrebuilt() {
 	p.properties.Srcs = nil
 }

 // Implements versionedInterface
 func (p *prebuiltLibraryLinker) implementationModuleName(name string) string {
 	return strings.TrimPrefix(name, "prebuilt_")
 }

 func NewPrebuiltLibrary(hod android.HostOrDeviceSupported) (*Module, *libraryDecorator) {
 	module, library := NewLibrary(hod)
 	module.compiler = nil

 	prebuilt := &prebuiltLibraryLinker{
 		libraryDecorator: library,
 	}
 	module.linker = prebuilt
 	module.library = prebuilt

 	module.AddProperties(&prebuilt.properties)

 	srcsSupplier := func(ctx android.BaseModuleContext, _ android.Module) []string {
 		return prebuilt.prebuiltSrcs(ctx)
 	}

 	android.InitPrebuiltModuleWithSrcSupplier(module, srcsSupplier, "srcs")

 	// Prebuilt libraries can be used in SDKs.
 	android.InitSdkAwareModule(module)
 	return module, library
 }

 // cc_prebuilt_library installs a precompiled shared library that are
 // listed in the srcs property in the device's directory.
 func PrebuiltLibraryFactory() android.Module {
 	module, _ := NewPrebuiltLibrary(android.HostAndDeviceSupported)

 	// Prebuilt shared libraries can be included in APEXes
 	android.InitApexModule(module)

 	return module.Init()
 }

 // cc_prebuilt_library_shared installs a precompiled shared library that are
 // listed in the srcs property in the device's directory.
 func PrebuiltSharedLibraryFactory() android.Module {
 	module, _ := NewPrebuiltSharedLibrary(android.HostAndDeviceSupported)
 	return module.Init()
 }

 // cc_prebuilt_test_library_shared installs a precompiled shared library
 // to be used as a data dependency of a test-related module (such as cc_test, or
 // cc_test_library).
 func PrebuiltSharedTestLibraryFactory() android.Module {
 	module, library := NewPrebuiltLibrary(android.HostAndDeviceSupported)
 	library.BuildOnlyShared()
 	library.baseInstaller = NewTestInstaller()
 	return module.Init()
 }

 func NewPrebuiltSharedLibrary(hod android.HostOrDeviceSupported) (*Module, *libraryDecorator) {
 	module, library := NewPrebuiltLibrary(hod)
 	library.BuildOnlyShared()

 	// Prebuilt shared libraries can be included in APEXes
 	android.InitApexModule(module)

 	return module, library
 }

 // cc_prebuilt_library_static installs a precompiled static library that are
 // listed in the srcs property in the device's directory.
 func PrebuiltStaticLibraryFactory() android.Module {
 	module, _ := NewPrebuiltStaticLibrary(android.HostAndDeviceSupported)
 	return module.Init()
 }

 func NewPrebuiltStaticLibrary(hod android.HostOrDeviceSupported) (*Module, *libraryDecorator) {
 	module, library := NewPrebuiltLibrary(hod)
 	library.BuildOnlyStatic()
 	module.bazelHandler = &prebuiltStaticLibraryBazelHandler{module: module, library: library}
 	return module, library
 }

 type prebuiltObjectProperties struct {
 	Srcs []string `android:"path,arch_variant"`
 }

 type prebuiltObjectLinker struct {
 	android.Prebuilt
 	objectLinker

 	properties prebuiltObjectProperties
 }

 type prebuiltStaticLibraryBazelHandler struct {
 	bazelHandler

 	module  *Module
 	library *libraryDecorator
 }

 func (h *prebuiltStaticLibraryBazelHandler) generateBazelBuildActions(ctx android.ModuleContext, label string) bool {
 	bazelCtx := ctx.Config().BazelContext
 	ccInfo, ok, err := bazelCtx.GetCcInfo(label, ctx.Arch().ArchType)
 	if err != nil {
 		ctx.ModuleErrorf("Error getting Bazel CcInfo: %s", err)
 	}
 	if !ok {
 		return false
 	}
 	staticLibs := ccInfo.CcStaticLibraryFiles
 	if len(staticLibs) > 1 {
 		ctx.ModuleErrorf("expected 1 static library from bazel target %q, got %s", label, staticLibs)
 		return false
 	}

 	// TODO(b/184543518): cc_prebuilt_library_static may have properties for re-exporting flags

 	// TODO(eakammer):Add stub-related flags if this library is a stub library.
 	// h.library.exportVersioningMacroIfNeeded(ctx)

 	// Dependencies on this library will expect collectedSnapshotHeaders to be set, otherwise
 	// validation will fail. For now, set this to an empty list.
 	// TODO(cparsons): More closely mirror the collectHeadersForSnapshot implementation.
 	h.library.collectedSnapshotHeaders = android.Paths{}

 	if len(staticLibs) == 0 {
 		h.module.outputFile = android.OptionalPath{}
 		return true
 	}

 	out := android.PathForBazelOut(ctx, staticLibs[0])
 	h.module.outputFile = android.OptionalPathForPath(out)

 	depSet := android.NewDepSetBuilder(android.TOPOLOGICAL).Direct(out).Build()
 	ctx.SetProvider(StaticLibraryInfoProvider, StaticLibraryInfo{
 		StaticLibrary: out,

 		TransitiveStaticLibrariesForOrdering: depSet,
 	})

 	return true
 }

 func (p *prebuiltObjectLinker) prebuilt() *android.Prebuilt {
 	return &p.Prebuilt
 }

 var _ prebuiltLinkerInterface = (*prebuiltObjectLinker)(nil)

 func (p *prebuiltObjectLinker) link(ctx ModuleContext,
 	flags Flags, deps PathDeps, objs Objects) android.Path {
 	if len(p.properties.Srcs) > 0 {
 		return p.Prebuilt.SingleSourcePath(ctx)
 	}
 	return nil
 }

 func (p *prebuiltObjectLinker) object() bool {
 	return true
 }

 func newPrebuiltObject() *Module {
 	module := newObject()
 	prebuilt := &prebuiltObjectLinker{
 		objectLinker: objectLinker{
 			baseLinker: NewBaseLinker(nil),
 		},
 	}
 	module.linker = prebuilt
 	module.AddProperties(&prebuilt.properties)
 	android.InitPrebuiltModule(module, &prebuilt.properties.Srcs)
 	android.InitSdkAwareModule(module)
 	return module
 }

 func prebuiltObjectFactory() android.Module {
 	module := newPrebuiltObject()
 	return module.Init()
 }

 type prebuiltBinaryLinker struct {
 	*binaryDecorator
 	prebuiltLinker

 	toolPath android.OptionalPath
 }

 var _ prebuiltLinkerInterface = (*prebuiltBinaryLinker)(nil)

 func (p *prebuiltBinaryLinker) hostToolPath() android.OptionalPath {
 	return p.toolPath
 }

 func (p *prebuiltBinaryLinker) link(ctx ModuleContext,
 	flags Flags, deps PathDeps, objs Objects) android.Path {
 	// TODO(ccross): verify shared library dependencies
 	if len(p.properties.Srcs) > 0 {
 		fileName := p.getStem(ctx) + flags.Toolchain.ExecutableSuffix()
 		in := p.Prebuilt.SingleSourcePath(ctx)
 		outputFile := android.PathForModuleOut(ctx, fileName)
 		p.unstrippedOutputFile = in

 		if ctx.Host() {
 			// Host binaries are symlinked to their prebuilt source locations. That
 			// way they are executed directly from there so the linker resolves their
 			// shared library dependencies relative to that location (using
 			// $ORIGIN/../lib(64):$ORIGIN/lib(64) as RUNPATH). This way the prebuilt
 			// repository can supply the expected versions of the shared libraries
 			// without interference from what is in the out tree.

 			// These shared lib paths may point to copies of the libs in
 			// .intermediates, which isn't where the binary will load them from, but
 			// it's fine for dependency tracking. If a library dependency is updated,
 			// the symlink will get a new timestamp, along with any installed symlinks
 			// handled in make.
 			sharedLibPaths := deps.EarlySharedLibs
 			sharedLibPaths = append(sharedLibPaths, deps.SharedLibs...)
 			sharedLibPaths = append(sharedLibPaths, deps.LateSharedLibs...)

 			var fromPath = in.String()
 			if !filepath.IsAbs(fromPath) {
 				fromPath = "$$PWD/" + fromPath
 			}

 			ctx.Build(pctx, android.BuildParams{
 				Rule:      android.Symlink,
 				Output:    outputFile,
 				Input:     in,
 				Implicits: sharedLibPaths,
 				Args: map[string]string{
 					"fromPath": fromPath,
 				},
 			})

 			p.toolPath = android.OptionalPathForPath(outputFile)
 		} else {
 			if p.stripper.NeedsStrip(ctx) {
 				stripped := android.PathForModuleOut(ctx, "stripped", fileName)
 				p.stripper.StripExecutableOrSharedLib(ctx, in, stripped, flagsToStripFlags(flags))
 				in = stripped
 			}

 			// Copy binaries to a name matching the final installed name
 			ctx.Build(pctx, android.BuildParams{
 				Rule:        android.CpExecutable,
 				Description: "prebuilt",
 				Output:      outputFile,
 				Input:       in,
 			})
 		}

 		return outputFile
 	}

 	return nil
 }

 func (p *prebuiltBinaryLinker) binary() bool {
 	return true
 }

 // cc_prebuilt_binary installs a precompiled executable in srcs property in the
 // device's directory.
 func prebuiltBinaryFactory() android.Module {
 	module, _ := NewPrebuiltBinary(android.HostAndDeviceSupported)
 	return module.Init()
 }

 func NewPrebuiltBinary(hod android.HostOrDeviceSupported) (*Module, *binaryDecorator) {
 	module, binary := NewBinary(hod)
 	module.compiler = nil

 	prebuilt := &prebuiltBinaryLinker{
 		binaryDecorator: binary,
 	}
 	module.linker = prebuilt
 	module.installer = prebuilt

 	module.AddProperties(&prebuilt.properties)

 	android.InitPrebuiltModule(module, &prebuilt.properties.Srcs)
 	return module, binary
 }

 type Sanitized struct {
 	None struct {
 		Srcs []string `android:"path,arch_variant"`
 	} `android:"arch_variant"`
 	Address struct {
 		Srcs []string `android:"path,arch_variant"`
 	} `android:"arch_variant"`
 	Hwaddress struct {
 		Srcs []string `android:"path,arch_variant"`
 	} `android:"arch_variant"`
 }

 func srcsForSanitizer(sanitize *sanitize, sanitized Sanitized) []string {
 	if sanitize == nil {
 		return nil
 	}
 	if Bool(sanitize.Properties.Sanitize.Address) && sanitized.Address.Srcs != nil {
 		return sanitized.Address.Srcs
 	}
 	if Bool(sanitize.Properties.Sanitize.Hwaddress) && sanitized.Hwaddress.Srcs != nil {
 		return sanitized.Hwaddress.Srcs
 	}
 	return sanitized.None.Srcs
 }
	// 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 (
	"android/soong/android"
	"path/filepath"
	"strings"
	)

	func init() {
	RegisterPrebuiltBuildComponents(android.InitRegistrationContext)
	}

	func RegisterPrebuiltBuildComponents(ctx android.RegistrationContext) {
	ctx.RegisterModuleType("cc_prebuilt_library", PrebuiltLibraryFactory)
	ctx.RegisterModuleType("cc_prebuilt_library_shared", PrebuiltSharedLibraryFactory)
	ctx.RegisterModuleType("cc_prebuilt_library_static", PrebuiltStaticLibraryFactory)
	ctx.RegisterModuleType("cc_prebuilt_test_library_shared", PrebuiltSharedTestLibraryFactory)
	ctx.RegisterModuleType("cc_prebuilt_object", prebuiltObjectFactory)
	ctx.RegisterModuleType("cc_prebuilt_binary", prebuiltBinaryFactory)
	}

	type prebuiltLinkerInterface interface {
	Name(string) string
	prebuilt() *android.Prebuilt
	}

	type prebuiltLinkerProperties struct {
	// a prebuilt library or binary. Can reference a genrule module that generates an executable file.
	Srcs []string `android:"path,arch_variant"`

	Sanitized Sanitized `android:"arch_variant"`

	// Check the prebuilt ELF files (e.g. DT_SONAME, DT_NEEDED, resolution of undefined
	// symbols, etc), default true.
	Check_elf_files *bool

	// Optionally provide an import library if this is a Windows PE DLL prebuilt.
	// This is needed only if this library is linked by other modules in build time.
	// Only makes sense for the Windows target.
	Windows_import_lib *string `android:"path,arch_variant"`
	}

	type prebuiltLinker struct {
	android.Prebuilt

	properties prebuiltLinkerProperties
	}

	func (p prebuiltLinker) prebuilt() android.Prebuilt {
	return &p.Prebuilt
	}

	func (p *prebuiltLinker) PrebuiltSrcs() []string {
	return p.properties.Srcs
	}

	type prebuiltLibraryInterface interface {
	libraryInterface
	prebuiltLinkerInterface
	disablePrebuilt()
	}

	type prebuiltLibraryLinker struct {
	*libraryDecorator
	prebuiltLinker
	}

	var _ prebuiltLinkerInterface = (*prebuiltLibraryLinker)(nil)
	var _ prebuiltLibraryInterface = (*prebuiltLibraryLinker)(nil)

	func (p *prebuiltLibraryLinker) linkerInit(ctx BaseModuleContext) {}

	func (p *prebuiltLibraryLinker) linkerDeps(ctx DepsContext, deps Deps) Deps {
	return p.libraryDecorator.linkerDeps(ctx, deps)
	}

	func (p *prebuiltLibraryLinker) linkerFlags(ctx ModuleContext, flags Flags) Flags {
	return flags
	}

	func (p *prebuiltLibraryLinker) linkerProps() []interface{} {
	return p.libraryDecorator.linkerProps()
	}

	func (p *prebuiltLibraryLinker) link(ctx ModuleContext,
	flags Flags, deps PathDeps, objs Objects) android.Path {

	p.libraryDecorator.flagExporter.exportIncludes(ctx)
	p.libraryDecorator.flagExporter.reexportDirs(deps.ReexportedDirs...)
	p.libraryDecorator.flagExporter.reexportSystemDirs(deps.ReexportedSystemDirs...)
	p.libraryDecorator.flagExporter.reexportFlags(deps.ReexportedFlags...)
	p.libraryDecorator.flagExporter.reexportDeps(deps.ReexportedDeps...)
	p.libraryDecorator.flagExporter.addExportedGeneratedHeaders(deps.ReexportedGeneratedHeaders...)

	p.libraryDecorator.flagExporter.setProvider(ctx)

	// TODO(ccross): verify shared library dependencies
	srcs := p.prebuiltSrcs(ctx)
	if len(srcs) > 0 {
	builderFlags := flagsToBuilderFlags(flags)

	if len(srcs) > 1 {
	ctx.PropertyErrorf("srcs", "multiple prebuilt source files")
	return nil
	}

	p.libraryDecorator.exportVersioningMacroIfNeeded(ctx)

	in := android.PathForModuleSrc(ctx, srcs[0])

	if p.static() {
	depSet := android.NewDepSetBuilder(android.TOPOLOGICAL).Direct(in).Build()
	ctx.SetProvider(StaticLibraryInfoProvider, StaticLibraryInfo{
	StaticLibrary: in,

	TransitiveStaticLibrariesForOrdering: depSet,
	})
	return in
	}

	if p.shared() {
	p.unstrippedOutputFile = in
	libName := p.libraryDecorator.getLibName(ctx) + flags.Toolchain.ShlibSuffix()
	outputFile := android.PathForModuleOut(ctx, libName)
	var implicits android.Paths

	if p.stripper.NeedsStrip(ctx) {
	stripFlags := flagsToStripFlags(flags)
	stripped := android.PathForModuleOut(ctx, "stripped", libName)
	p.stripper.StripExecutableOrSharedLib(ctx, in, stripped, stripFlags)
	in = stripped
	}

	// 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 := android.PathForModuleOut(ctx, libName+".toc")
	p.tocFile = android.OptionalPathForPath(tocFile)
	transformSharedObjectToToc(ctx, outputFile, tocFile, builderFlags)

	if ctx.Windows() && p.properties.Windows_import_lib != nil {
	// Consumers of this library actually links to the import library in build
	// time and dynamically links to the DLL in run time. i.e.
	// a.exe <-- static link --> foo.lib <-- dynamic link --> foo.dll
	importLibSrc := android.PathForModuleSrc(ctx, String(p.properties.Windows_import_lib))
	importLibName := p.libraryDecorator.getLibName(ctx) + ".lib"
	importLibOutputFile := android.PathForModuleOut(ctx, importLibName)
	implicits = append(implicits, importLibOutputFile)

	ctx.Build(pctx, android.BuildParams{
	Rule: android.Cp,
	Description: "prebuilt import library",
	Input: importLibSrc,
	Output: importLibOutputFile,
	Args: map[string]string{
	"cpFlags": "-L",
	},
	})
	}

	ctx.Build(pctx, android.BuildParams{
	Rule: android.Cp,
	Description: "prebuilt shared library",
	Implicits: implicits,
	Input: in,
	Output: outputFile,
	Args: map[string]string{
	"cpFlags": "-L",
	},
	})

	ctx.SetProvider(SharedLibraryInfoProvider, SharedLibraryInfo{
	SharedLibrary: outputFile,
	Target: ctx.Target(),

	TableOfContents: p.tocFile,
	})

	return outputFile
	}
	}

	if p.header() {
	ctx.SetProvider(HeaderLibraryInfoProvider, HeaderLibraryInfo{})

	return nil
	}

	return nil
	}

	func (p *prebuiltLibraryLinker) prebuiltSrcs(ctx android.BaseModuleContext) []string {
	sanitize := ctx.Module().(*Module).sanitize
	srcs := p.properties.Srcs
	srcs = append(srcs, srcsForSanitizer(sanitize, p.properties.Sanitized)...)
	if p.static() {
	srcs = append(srcs, p.libraryDecorator.StaticProperties.Static.Srcs...)
	srcs = append(srcs, srcsForSanitizer(sanitize, p.libraryDecorator.StaticProperties.Static.Sanitized)...)
	}
	if p.shared() {
	srcs = append(srcs, p.libraryDecorator.SharedProperties.Shared.Srcs...)
	srcs = append(srcs, srcsForSanitizer(sanitize, p.libraryDecorator.SharedProperties.Shared.Sanitized)...)
	}
	return srcs
	}

	func (p *prebuiltLibraryLinker) shared() bool {
	return p.libraryDecorator.shared()
	}

	func (p *prebuiltLibraryLinker) nativeCoverage() bool {
	return false
	}

	func (p *prebuiltLibraryLinker) disablePrebuilt() {
	p.properties.Srcs = nil
	}

	// Implements versionedInterface
	func (p *prebuiltLibraryLinker) implementationModuleName(name string) string {
	return strings.TrimPrefix(name, "prebuilt_")
	}

	func NewPrebuiltLibrary(hod android.HostOrDeviceSupported) (Module, libraryDecorator) {
	module, library := NewLibrary(hod)
	module.compiler = nil

	prebuilt := &prebuiltLibraryLinker{
	libraryDecorator: library,
	}
	module.linker = prebuilt
	module.library = prebuilt

	module.AddProperties(&prebuilt.properties)

	srcsSupplier := func(ctx android.BaseModuleContext, _ android.Module) []string {
	return prebuilt.prebuiltSrcs(ctx)
	}

	android.InitPrebuiltModuleWithSrcSupplier(module, srcsSupplier, "srcs")

	// Prebuilt libraries can be used in SDKs.
	android.InitSdkAwareModule(module)
	return module, library
	}

	// cc_prebuilt_library installs a precompiled shared library that are
	// listed in the srcs property in the device's directory.
	func PrebuiltLibraryFactory() android.Module {
	module, _ := NewPrebuiltLibrary(android.HostAndDeviceSupported)

	// Prebuilt shared libraries can be included in APEXes
	android.InitApexModule(module)

	return module.Init()
	}

	// cc_prebuilt_library_shared installs a precompiled shared library that are
	// listed in the srcs property in the device's directory.
	func PrebuiltSharedLibraryFactory() android.Module {
	module, _ := NewPrebuiltSharedLibrary(android.HostAndDeviceSupported)
	return module.Init()
	}

	// cc_prebuilt_test_library_shared installs a precompiled shared library
	// to be used as a data dependency of a test-related module (such as cc_test, or
	// cc_test_library).
	func PrebuiltSharedTestLibraryFactory() android.Module {
	module, library := NewPrebuiltLibrary(android.HostAndDeviceSupported)
	library.BuildOnlyShared()
	library.baseInstaller = NewTestInstaller()
	return module.Init()
	}

	func NewPrebuiltSharedLibrary(hod android.HostOrDeviceSupported) (Module, libraryDecorator) {
	module, library := NewPrebuiltLibrary(hod)
	library.BuildOnlyShared()

	// Prebuilt shared libraries can be included in APEXes
	android.InitApexModule(module)

	return module, library
	}

	// cc_prebuilt_library_static installs a precompiled static library that are
	// listed in the srcs property in the device's directory.
	func PrebuiltStaticLibraryFactory() android.Module {
	module, _ := NewPrebuiltStaticLibrary(android.HostAndDeviceSupported)
	return module.Init()
	}

	func NewPrebuiltStaticLibrary(hod android.HostOrDeviceSupported) (Module, libraryDecorator) {
	module, library := NewPrebuiltLibrary(hod)
	library.BuildOnlyStatic()
	module.bazelHandler = &prebuiltStaticLibraryBazelHandler{module: module, library: library}
	return module, library
	}

	type prebuiltObjectProperties struct {
	Srcs []string `android:"path,arch_variant"`
	}

	type prebuiltObjectLinker struct {
	android.Prebuilt
	objectLinker

	properties prebuiltObjectProperties
	}

	type prebuiltStaticLibraryBazelHandler struct {
	bazelHandler

	module *Module
	library *libraryDecorator
	}

	func (h *prebuiltStaticLibraryBazelHandler) generateBazelBuildActions(ctx android.ModuleContext, label string) bool {
	bazelCtx := ctx.Config().BazelContext
	ccInfo, ok, err := bazelCtx.GetCcInfo(label, ctx.Arch().ArchType)
	if err != nil {
	ctx.ModuleErrorf("Error getting Bazel CcInfo: %s", err)
	}
	if !ok {
	return false
	}
	staticLibs := ccInfo.CcStaticLibraryFiles
	if len(staticLibs) > 1 {
	ctx.ModuleErrorf("expected 1 static library from bazel target %q, got %s", label, staticLibs)
	return false
	}

	// TODO(b/184543518): cc_prebuilt_library_static may have properties for re-exporting flags

	// TODO(eakammer):Add stub-related flags if this library is a stub library.
	// h.library.exportVersioningMacroIfNeeded(ctx)

	// Dependencies on this library will expect collectedSnapshotHeaders to be set, otherwise
	// validation will fail. For now, set this to an empty list.
	// TODO(cparsons): More closely mirror the collectHeadersForSnapshot implementation.
	h.library.collectedSnapshotHeaders = android.Paths{}

	if len(staticLibs) == 0 {
	h.module.outputFile = android.OptionalPath{}
	return true
	}

	out := android.PathForBazelOut(ctx, staticLibs[0])
	h.module.outputFile = android.OptionalPathForPath(out)

	depSet := android.NewDepSetBuilder(android.TOPOLOGICAL).Direct(out).Build()
	ctx.SetProvider(StaticLibraryInfoProvider, StaticLibraryInfo{
	StaticLibrary: out,

	TransitiveStaticLibrariesForOrdering: depSet,
	})

	return true
	}

	func (p prebuiltObjectLinker) prebuilt() android.Prebuilt {
	return &p.Prebuilt
	}

	var _ prebuiltLinkerInterface = (*prebuiltObjectLinker)(nil)

	func (p *prebuiltObjectLinker) link(ctx ModuleContext,
	flags Flags, deps PathDeps, objs Objects) android.Path {
	if len(p.properties.Srcs) > 0 {
	return p.Prebuilt.SingleSourcePath(ctx)
	}
	return nil
	}

	func (p *prebuiltObjectLinker) object() bool {
	return true
	}

	func newPrebuiltObject() *Module {
	module := newObject()
	prebuilt := &prebuiltObjectLinker{
	objectLinker: objectLinker{
	baseLinker: NewBaseLinker(nil),
	},
	}
	module.linker = prebuilt
	module.AddProperties(&prebuilt.properties)
	android.InitPrebuiltModule(module, &prebuilt.properties.Srcs)
	android.InitSdkAwareModule(module)
	return module
	}

	func prebuiltObjectFactory() android.Module {
	module := newPrebuiltObject()
	return module.Init()
	}

	type prebuiltBinaryLinker struct {
	*binaryDecorator
	prebuiltLinker

	toolPath android.OptionalPath
	}

	var _ prebuiltLinkerInterface = (*prebuiltBinaryLinker)(nil)

	func (p *prebuiltBinaryLinker) hostToolPath() android.OptionalPath {
	return p.toolPath
	}

	func (p *prebuiltBinaryLinker) link(ctx ModuleContext,
	flags Flags, deps PathDeps, objs Objects) android.Path {
	// TODO(ccross): verify shared library dependencies
	if len(p.properties.Srcs) > 0 {
	fileName := p.getStem(ctx) + flags.Toolchain.ExecutableSuffix()
	in := p.Prebuilt.SingleSourcePath(ctx)
	outputFile := android.PathForModuleOut(ctx, fileName)
	p.unstrippedOutputFile = in

	if ctx.Host() {
	// Host binaries are symlinked to their prebuilt source locations. That
	// way they are executed directly from there so the linker resolves their
	// shared library dependencies relative to that location (using
	// $ORIGIN/../lib(64):$ORIGIN/lib(64) as RUNPATH). This way the prebuilt
	// repository can supply the expected versions of the shared libraries
	// without interference from what is in the out tree.

	// These shared lib paths may point to copies of the libs in
	// .intermediates, which isn't where the binary will load them from, but
	// it's fine for dependency tracking. If a library dependency is updated,
	// the symlink will get a new timestamp, along with any installed symlinks
	// handled in make.
	sharedLibPaths := deps.EarlySharedLibs
	sharedLibPaths = append(sharedLibPaths, deps.SharedLibs...)
	sharedLibPaths = append(sharedLibPaths, deps.LateSharedLibs...)

	var fromPath = in.String()
	if !filepath.IsAbs(fromPath) {
	fromPath = "$$PWD/" + fromPath
	}

	ctx.Build(pctx, android.BuildParams{
	Rule: android.Symlink,
	Output: outputFile,
	Input: in,
	Implicits: sharedLibPaths,
	Args: map[string]string{
	"fromPath": fromPath,
	},
	})

	p.toolPath = android.OptionalPathForPath(outputFile)
	} else {
	if p.stripper.NeedsStrip(ctx) {
	stripped := android.PathForModuleOut(ctx, "stripped", fileName)
	p.stripper.StripExecutableOrSharedLib(ctx, in, stripped, flagsToStripFlags(flags))
	in = stripped
	}

	// Copy binaries to a name matching the final installed name
	ctx.Build(pctx, android.BuildParams{
	Rule: android.CpExecutable,
	Description: "prebuilt",
	Output: outputFile,
	Input: in,
	})
	}

	return outputFile
	}

	return nil
	}

	func (p *prebuiltBinaryLinker) binary() bool {
	return true
	}

	// cc_prebuilt_binary installs a precompiled executable in srcs property in the
	// device's directory.
	func prebuiltBinaryFactory() android.Module {
	module, _ := NewPrebuiltBinary(android.HostAndDeviceSupported)
	return module.Init()
	}

	func NewPrebuiltBinary(hod android.HostOrDeviceSupported) (Module, binaryDecorator) {
	module, binary := NewBinary(hod)
	module.compiler = nil

	prebuilt := &prebuiltBinaryLinker{
	binaryDecorator: binary,
	}
	module.linker = prebuilt
	module.installer = prebuilt

	module.AddProperties(&prebuilt.properties)

	android.InitPrebuiltModule(module, &prebuilt.properties.Srcs)
	return module, binary
	}

	type Sanitized struct {
	None struct {
	Srcs []string `android:"path,arch_variant"`
	} `android:"arch_variant"`
	Address struct {
	Srcs []string `android:"path,arch_variant"`
	} `android:"arch_variant"`
	Hwaddress struct {
	Srcs []string `android:"path,arch_variant"`
	} `android:"arch_variant"`
	}

	func srcsForSanitizer(sanitize *sanitize, sanitized Sanitized) []string {
	if sanitize == nil {
	return nil
	}
	if Bool(sanitize.Properties.Sanitize.Address) && sanitized.Address.Srcs != nil {
	return sanitized.Address.Srcs
	}
	if Bool(sanitize.Properties.Sanitize.Hwaddress) && sanitized.Hwaddress.Srcs != nil {
	return sanitized.Hwaddress.Srcs
	}
	return sanitized.None.Srcs
	}