Quelle  binary.go   Sprache: unbekannt

// Copyright 2019 The Android Open Source Project
//
// 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 rust

import (
 "github.com/google/blueprint/pathtools"
 "github.com/google/blueprint/proptools"

 "android/soong/android"
)

func init() {
 android.RegisterModuleType("rust_binary", RustBinaryFactory)
 android.RegisterModuleType("rust_binary_host", RustBinaryHostFactory)
}

type BinaryCompilerProperties struct {
 // Builds this binary as a static binary. Implies prefer_rlib true.
 //
 // Static executables currently only support for bionic targets. Non-bionic targets will not produce a fully static
 // binary, but will still implicitly imply prefer_rlib true.
 Static_executable *bool `android:"arch_variant"`
}

type binaryInterface interface {
 binary() bool
 staticallyLinked() bool
 testBinary() bool
}

type binaryDecorator struct {
 *baseCompiler
 stripper Stripper

 Properties BinaryCompilerProperties
}

var _ compiler = (*binaryDecorator)(nil)

// rust_binary produces a binary that is runnable on a device.
func RustBinaryFactory() android.Module {
 module, _ := NewRustBinary(android.HostAndDeviceSupported)
 return module.Init()
}

func RustBinaryHostFactory() android.Module {
 module, _ := NewRustBinary(android.HostSupported)
 return module.Init()
}

func NewRustBinary(hod android.HostOrDeviceSupported) (*Module, *binaryDecorator) {
 module := newModule(hod, android.MultilibFirst)

 binary := &binaryDecorator{
  baseCompiler: NewBaseCompiler("bin", "", InstallInSystem),
 }

 module.compiler = binary

 return module, binary
}

func (binary *binaryDecorator) begin(ctx BaseModuleContext) {
 binary.baseCompiler.begin(ctx)

 if ctx.Os().Linux() && ctx.Host() && ctx.toolchain().Musl() {
  // Unless explicitly specified otherwise, host static binaries are built statically
  // if HostStaticBinaries is true for the product configuration.
  // In Rust however this is only supported for musl targets.
  if binary.Properties.Static_executable == nil && ctx.Config().HostStaticBinaries() {
   binary.Properties.Static_executable = proptools.BoolPtr(true)
  }
 }

 if ctx.Darwin() || ctx.Windows() || (ctx.Os().Linux() && ctx.Host() && ctx.toolchain().Glibc()) {
  // Static executables are not supported on Darwin, Linux glibc, or Windows
  binary.Properties.Static_executable = nil
 }
}

func (binary *binaryDecorator) compilerFlags(ctx ModuleContext, flags Flags) Flags {
 flags = binary.baseCompiler.compilerFlags(ctx, flags)

 if ctx.toolchain().Bionic() {
  // no-undefined-version breaks dylib compilation since __rust_*alloc* functions aren't defined,
  // but we can apply this to binaries.
  flags.LinkFlags = flags.LinkFlags.AppendNoDeps(
   "-Wl,--gc-sections",
   "-Wl,-z,nocopyreloc",
   "-Wl,--no-undefined-version")
 }

 if Bool(binary.Properties.Static_executable) {
  flags.LinkFlags = flags.LinkFlags.AppendNoDeps("-static")
  flags.RustFlags = append(flags.RustFlags, "-C relocation-model=static")
 }

 return flags
}

func (binary *binaryDecorator) compilerDeps(ctx DepsContext, deps Deps) Deps {
 deps = binary.baseCompiler.compilerDeps(ctx, deps)

 static := Bool(binary.Properties.Static_executable)
 if ctx.toolchain().Bionic() {
  deps = bionicDeps(ctx, deps, static)
  if static {
   deps.CrtBegin = []string{"crtbegin_static"}
  } else {
   deps.CrtBegin = []string{"crtbegin_dynamic"}
  }
  deps.CrtEnd = []string{"crtend_android"}
 } else if ctx.Os() == android.LinuxMusl {
  deps = muslDeps(ctx, deps, static)
  if static {
   deps.CrtBegin = []string{"libc_musl_crtbegin_static"}
  } else {
   deps.CrtBegin = []string{"libc_musl_crtbegin_dynamic"}
  }
  deps.CrtEnd = []string{"libc_musl_crtend"}
 } else if ctx.Os() == android.Windows {
  deps.CrtBegin = []string{"rsbegin.rust_sysroot"}
  deps.CrtEnd = []string{"rsend.rust_sysroot"}
 }
 return deps
}

func (binary *binaryDecorator) compilerProps() []any {
 return append(binary.baseCompiler.compilerProps(),
  &binary.Properties,
  &binary.stripper.StripProperties)
}

func (binary *binaryDecorator) nativeCoverage() bool {
 return true
}

func (binary *binaryDecorator) preferRlib() bool {
 return Bool(binary.baseCompiler.Properties.Prefer_rlib) || Bool(binary.Properties.Static_executable)
}

func (binary *binaryDecorator) compile(ctx ModuleContext, flags Flags, deps PathDeps) buildOutput {
 fileName := binary.getStem(ctx) + ctx.toolchain().ExecutableSuffix()
 outputFile := android.PathForModuleOut(ctx, fileName)
 ret := buildOutput{outputFile: outputFile}
 crateRootPath := binary.crateRootPath(ctx)

 deps.SrcFiles = append(deps.SrcFiles, crateRootPath)
 deps.SrcFiles = append(deps.SrcFiles, binary.crateSources(ctx)...)

 // Ensure link dirs are not duplicated
 deps.linkDirs = android.FirstUniqueStrings(deps.linkDirs)
 deps.linkDirsDeps = android.FirstUniquePaths(deps.linkDirsDeps)

 flags.RustFlags = append(flags.RustFlags, deps.depFlags...)
 flags.LinkFlags = flags.LinkFlags.AppendNoDeps(deps.depLinkFlags...)
 flags.LinkFlags = flags.LinkFlags.AppendNoDeps(deps.rustLibObjects...)
 flags.LinkFlags = flags.LinkFlags.AppendNoDeps(deps.staticLibObjects...)
 flags.LinkFlags = flags.LinkFlags.AppendNoDeps(deps.wholeStaticLibObjects...)

 if ctx.Windows() {
  for _, lib := range deps.sharedLibObjects {
   // Windows uses the .lib import library at link-time and at runtime
   // uses the .dll library, so we need to make sure we're passing the
   // import library to the linker.
   flags.LinkFlags = flags.LinkFlags.AppendNoDeps(pathtools.ReplaceExtension(lib, "lib"))
  }
 } else {
  flags.LinkFlags = flags.LinkFlags.AppendNoDeps(deps.sharedLibObjects...)
 }

 if binary.stripper.NeedsStrip(ctx) {
  strippedOutputFile := outputFile
  outputFile = android.PathForModuleOut(ctx, "unstripped", fileName)
  binary.stripper.StripExecutableOrSharedLib(ctx, outputFile, strippedOutputFile)

  binary.strippedOutputFile = android.OptionalPathForPath(strippedOutputFile)
 }
 binary.unstrippedOutputFile = outputFile
 checkJsonFile := android.PathForModuleOut(ctx, outputFile.Base()+".checkJson")
 binary.checkJsonFile = android.OptionalPathForPath(checkJsonFile)

 ret.kytheFile = TransformSrcToBinary(ctx, crateRootPath, deps, flags, outputFile, checkJsonFile).kytheFile
 return ret
}

func (binary *binaryDecorator) autoDep(ctx android.BottomUpMutatorContext) autoDep {
 // Binaries default to dylib dependencies for device, rlib for host.
 if binary.preferRlib() {
  return rlibAutoDep
 } else if ctx.Device() {
  return dylibAutoDep
 } else {
  return rlibAutoDep
 }
}

func (binary *binaryDecorator) stdLinkage(device bool) StdLinkage {
 if binary.preferRlib() {
  return RlibStd
 }
 return binary.baseCompiler.stdLinkage(device)
}

func (binary *binaryDecorator) binary() bool {
 return true
}

func (binary *binaryDecorator) staticallyLinked() bool {
 return Bool(binary.Properties.Static_executable)
}

func (binary *binaryDecorator) testBinary() bool {
 return false
}

func (binary *binaryDecorator) moduleInfoJSON(ctx ModuleContext, moduleInfoJSON *android.ModuleInfoJSON) {
 binary.baseCompiler.moduleInfoJSON(ctx, moduleInfoJSON)
 moduleInfoJSON.Class = []string{"EXECUTABLES"}
}