428 lines
12 KiB
Go
428 lines
12 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 (
|
|
"android/soong/android"
|
|
"path/filepath"
|
|
)
|
|
|
|
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"`
|
|
|
|
// 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.exportIncludes(ctx)
|
|
p.libraryDecorator.reexportDirs(deps.ReexportedDirs...)
|
|
p.libraryDecorator.reexportSystemDirs(deps.ReexportedSystemDirs...)
|
|
p.libraryDecorator.reexportFlags(deps.ReexportedFlags...)
|
|
p.libraryDecorator.reexportDeps(deps.ReexportedDeps...)
|
|
p.libraryDecorator.addExportedGeneratedHeaders(deps.ReexportedGeneratedHeaders...)
|
|
|
|
// TODO(ccross): verify shared library dependencies
|
|
srcs := p.prebuiltSrcs()
|
|
if len(srcs) > 0 {
|
|
builderFlags := flagsToBuilderFlags(flags)
|
|
|
|
if len(srcs) > 1 {
|
|
ctx.PropertyErrorf("srcs", "multiple prebuilt source files")
|
|
return nil
|
|
}
|
|
|
|
in := android.PathForModuleSrc(ctx, srcs[0])
|
|
|
|
if p.static() {
|
|
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",
|
|
},
|
|
})
|
|
|
|
return outputFile
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
func (p *prebuiltLibraryLinker) prebuiltSrcs() []string {
|
|
srcs := p.properties.Srcs
|
|
if p.static() {
|
|
srcs = append(srcs, p.libraryDecorator.StaticProperties.Static.Srcs...)
|
|
}
|
|
if p.shared() {
|
|
srcs = append(srcs, p.libraryDecorator.SharedProperties.Shared.Srcs...)
|
|
}
|
|
|
|
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
|
|
}
|
|
|
|
func NewPrebuiltLibrary(hod android.HostOrDeviceSupported) (*Module, *libraryDecorator) {
|
|
module, library := NewLibrary(hod)
|
|
module.compiler = nil
|
|
|
|
prebuilt := &prebuiltLibraryLinker{
|
|
libraryDecorator: library,
|
|
}
|
|
module.linker = prebuilt
|
|
|
|
module.AddProperties(&prebuilt.properties)
|
|
|
|
srcsSupplier := func() []string {
|
|
return prebuilt.prebuiltSrcs()
|
|
}
|
|
|
|
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()
|
|
return module, library
|
|
}
|
|
|
|
type prebuiltObjectProperties struct {
|
|
Srcs []string `android:"path,arch_variant"`
|
|
}
|
|
|
|
type prebuiltObjectLinker struct {
|
|
android.Prebuilt
|
|
objectLinker
|
|
|
|
properties prebuiltObjectProperties
|
|
}
|
|
|
|
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
|
|
}
|