Quelle  build_prop.go   Sprache: unbekannt

// Copyright 2024 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 android

import (
 "fmt"

 "github.com/google/blueprint/proptools"
)

func init() {
 registerBuildPropComponents(InitRegistrationContext)
}

func registerBuildPropComponents(ctx RegistrationContext) {
 ctx.RegisterModuleType("build_prop", BuildPropFactory)
 ctx.RegisterModuleType("android_info", AndroidInfoFactory)
}

type buildPropProperties struct {
 // Output file name. Defaults to "build.prop"
 Stem *string

 // List of prop names to exclude. This affects not only common build properties but also
 // properties in prop_files.
 Block_list []string

 // Files to be appended at the end of build.prop. These files are appended after
 // post_process_props without any further checking.
 Footer_files []string `android:"path"`

 // Path to a JSON file containing product configs.
 Product_config *string `android:"path"`

 // Path to android-info.txt file containing board specific info.
 // This is empty for build.prop of all partitions except vendor.
 Android_info *string `android:"path"`

 // Optional subdirectory under which this file is installed into
 Relative_install_path *string
}

type buildPropModule struct {
 ModuleBase

 properties buildPropProperties

 outputFilePath Path
 installPath    InstallPath
}

func (p *buildPropModule) stem() string {
 return proptools.StringDefault(p.properties.Stem, "build.prop")
}

func (p *buildPropModule) propFiles(ctx ModuleContext) Paths {
 partition := p.partition(ctx.DeviceConfig())
 if partition == "system" {
  return ctx.Config().SystemPropFiles(ctx)
 } else if partition == "system_ext" {
  return ctx.Config().SystemExtPropFiles(ctx)
 } else if partition == "product" {
  return ctx.Config().ProductPropFiles(ctx)
 } else if partition == "odm" {
  return ctx.Config().OdmPropFiles(ctx)
 } else if partition == "vendor" {
  if p.properties.Android_info != nil {
   androidInfo := PathForModuleSrc(ctx, proptools.String(p.properties.Android_info))
   return append(ctx.Config().VendorPropFiles(ctx), androidInfo)
  }
  return ctx.Config().VendorPropFiles(ctx)
 }
 return nil
}

func shouldAddBuildThumbprint(config Config) bool {
 knownOemProperties := []string{
  "ro.product.brand",
  "ro.product.name",
  "ro.product.device",
 }

 for _, knownProp := range knownOemProperties {
  if InList(knownProp, config.OemProperties()) {
   return true
  }
 }
 return false
}

// Can't use PartitionTag() because PartitionTag() returns the partition this module is actually
// installed (e.g. odm module's partition tag can be either "odm" or "vendor")
func (p *buildPropModule) partition(config DeviceConfig) string {
 if p.SocSpecific() {
  return "vendor"
 } else if p.DeviceSpecific() {
  return "odm"
 } else if p.ProductSpecific() {
  return "product"
 } else if p.SystemExtSpecific() {
  return "system_ext"
 } else if p.InstallInSystemDlkm() {
  return "system_dlkm"
 } else if p.InstallInVendorDlkm() {
  return "vendor_dlkm"
 } else if p.InstallInOdmDlkm() {
  return "odm_dlkm"
 } else if p.InstallInRamdisk() {
  // From this hardcoding in make:
  // https://cs.android.com/android/platform/superproject/main/+/main:build/make/core/sysprop.mk;l=311;drc=274435657e4682e5cee3fffd11fb301ab32a828d
  return "bootimage"
 }
 return "system"
}

func (p *buildPropModule) GenerateAndroidBuildActions(ctx ModuleContext) {
 if !p.SocSpecific() && p.properties.Android_info != nil {
  ctx.ModuleErrorf("Android_info cannot be set if build.prop is not installed in vendor partition")
 }

 outputFilePath := PathForModuleOut(ctx, "build.prop")

 partition := p.partition(ctx.DeviceConfig())

 rule := NewRuleBuilder(pctx, ctx).SandboxDisabled()

 config := ctx.Config()

 cmd := rule.Command().BuiltTool("gen_build_prop")

 cmd.FlagWithInput("--build-hostname-file=", config.BuildHostnameFile(ctx))
 cmd.FlagWithInput("--build-number-file=", config.BuildNumberFile(ctx))
 cmd.FlagWithInput("--build-uuid-file=", config.BuildUUIDFile(ctx))
 cmd.FlagWithInput("--build-fingerprint-file=", config.BuildFingerprintFile(ctx))
 cmd.FlagWithInput("--build-system-fingerprint-file=", config.BuildSystemFingerprintFile(ctx))
 // Export build thumbprint only if the product has specified at least one oem fingerprint property
 // b/17888863
 if shouldAddBuildThumbprint(config) {
  cmd.FlagWithInput("--build-thumbprint-file=", config.BuildThumbprintFile(ctx))
 }
 cmd.FlagWithArg("--build-username=", config.Getenv("BUILD_USERNAME"))
 // shouldn't depend on BUILD_DATETIME_FILE to prevent from rebuilding on every incremental
 // build.
 cmd.FlagWithArg("--date-file=", ctx.Config().Getenv("BUILD_DATETIME_FILE"))
 cmd.OrderOnly(config.BuildDateFile(ctx))
 cmd.FlagWithInput("--platform-preview-sdk-fingerprint-file=", ApiFingerprintPath(ctx))
 cmd.FlagWithInput("--product-config=", PathForModuleSrc(ctx, proptools.String(p.properties.Product_config)))
 cmd.FlagWithArg("--partition=", partition)
 cmd.FlagForEachInput("--prop-files=", p.propFiles(ctx))
 cmd.FlagWithOutput("--out=", outputFilePath)

 postProcessCmd := rule.Command().BuiltTool("post_process_props")
 if ctx.DeviceConfig().BuildBrokenDupSysprop() {
  postProcessCmd.Flag("--allow-dup")
 }
 postProcessCmd.FlagWithArg("--sdk-version ", config.PlatformSdkVersion().String())
 if ctx.Config().EnableUffdGc() == "default" {
  postProcessCmd.FlagWithInput("--kernel-version-file-for-uffd-gc ", PathForOutput(ctx, "dexpreopt/kernel_version_for_uffd_gc.txt"))
 } else {
  // still need to pass an empty string to kernel-version-file-for-uffd-gc
  postProcessCmd.FlagWithArg("--kernel-version-file-for-uffd-gc ", `""`)
 }
 postProcessCmd.Text(outputFilePath.String())
 postProcessCmd.Flags(p.properties.Block_list)

 for _, footer := range p.properties.Footer_files {
  path := PathForModuleSrc(ctx, footer)
  rule.appendText(outputFilePath, "####################################")
  rule.appendTextf(outputFilePath, "# Adding footer from %v", footer)
  rule.appendTextf(outputFilePath, "# with path %v", path)
  rule.appendText(outputFilePath, "####################################")
  rule.Command().Text("cat").FlagWithInput("", path).FlagWithArg(">> ", outputFilePath.String())
 }

 rule.appendText(outputFilePath, "# end of file")

 rule.Build(ctx.ModuleName(), "generating build.prop")

 p.installPath = PathForModuleInstall(ctx, proptools.String(p.properties.Relative_install_path))
 ctx.InstallFile(p.installPath, p.stem(), outputFilePath)

 ctx.SetOutputFiles(Paths{outputFilePath}, "")
 p.outputFilePath = outputFilePath
}

func (r *RuleBuilder) appendText(path ModuleOutPath, text string) {
 r.Command().Text("echo").Text(proptools.NinjaAndShellEscape(text)).FlagWithArg(">> ", path.String())
}

func (r *RuleBuilder) appendTextf(path ModuleOutPath, format string, a ...any) {
 r.appendText(path, fmt.Sprintf(format, a...))
}

func (p *buildPropModule) AndroidMkEntries() []AndroidMkEntries {
 return []AndroidMkEntries{{
  Class:      "ETC",
  OutputFile: OptionalPathForPath(p.outputFilePath),
  ExtraEntries: []AndroidMkExtraEntriesFunc{
   func(ctx AndroidMkExtraEntriesContext, entries *AndroidMkEntries) {
    entries.SetString("LOCAL_MODULE_PATH", p.installPath.String())
    entries.SetString("LOCAL_INSTALLED_MODULE_STEM", p.outputFilePath.Base())
   },
  },
 }}
}

// build_prop module generates {partition}/build.prop file. At first common build properties are
// printed based on Soong config variables. And then prop_files are printed as-is. Finally,
// post_process_props tool is run to check if the result build.prop is valid or not.
func BuildPropFactory() Module {
 module := &buildPropModule{}
 module.AddProperties(&module.properties)
 InitAndroidArchModule(module, DeviceSupported, MultilibCommon)
 return module
}