Quelle  prebuilt.go   Sprache: unbekannt

// Copyright (C) 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 apex

import (
 "slices"
 "sort"
 "strconv"
 "strings"

 "android/soong/android"
 "android/soong/dexpreopt"
 "android/soong/filesystem"
 "android/soong/java"
 "android/soong/provenance"

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

//go:generate go run ../../blueprint/gobtools/codegen

var (
 extractMatchingApex = pctx.StaticRule(
  "extractMatchingApex",
  blueprint.RuleParams{
   Command2: blueprint.NewCommand(
    android.Rm, ` -rf "$out" && `,
    extract_apks, ` -o "${out}" -allow-prereleased=${allow-prereleased} `,
    `-sdk-version=${sdk-version} -skip-sdk-check=${skip-sdk-check} -abis=${abis} `,
    `-screen-densities=all -extract-single `,
    `${in}`,
   ),
  },
  "abis", "allow-prereleased", "sdk-version", "skip-sdk-check")
 decompressApex = pctx.StaticRule("decompressApex", blueprint.RuleParams{
  Command2: blueprint.NewCommand(
   android.Rm, ` -rf $out && `, deapexer, ` decompress --copy-if-uncompressed --input ${in} --output ${out}`,
  ),
  Description: "decompress $out",
 })
 // Compares the declared apps of `prebuilt_apex` with the actual apks
 validateApkInPrebuiltApex = pctx.StaticRule("validateApkinPrebuiltApex", blueprint.RuleParams{
  Command2: blueprint.NewCommand(
   android.Rm, ` -rf ${out} ${actualApks} && `,
   apex_ls, ` ${in} | `, android.Grep, ` apk$$ | `, android.Awk, ` -F '/' '{print $$NF}' | `,
   android.Sort, ` -u > ${actualApks} && `,
   android.Cmp, ` -s ${expectedApks} ${actualApks} && `, android.Touch, ` ${out} `,
   `|| ( `, android.Echo, ` "Found diffs between "apps" property of ${apexName} and actual contents of ${in}. `,
   `Please ensure that all apk-in-apexes are declared in 'apps' property." && exit 1)`,
  ),
  Description: "validate apk in prebuilt_apex $out",
 }, "expectedApks", "actualApks", "apexName")
)

type prebuilt interface {
 isForceDisabled() bool
 InstallFilename() string
}

type prebuiltCommon struct {
 android.ModuleBase
 java.Dexpreopter
 blueprint.ModuleUsesIncrementalWalkDeps

 prebuilt android.Prebuilt

 // Properties common to both prebuilt_apex and apex_set.
 prebuiltCommonProperties *PrebuiltCommonProperties

 installDir          android.InstallPath
 installFilename     string
 installedFile       android.InstallPath
 extraInstalledFiles android.InstallPaths
 extraInstalledPairs installPairs
 outputApex          android.WritablePath

 // fragment for this apex for apexkeys.txt
 apexKeysPath android.WritablePath

 // Installed locations of symlinks for backward compatibility.
 compatSymlinks android.InstallPaths

 // systemServerDexpreoptInstalls stores the list of dexpreopt artifacts for a system server jar.
 systemServerDexpreoptInstalls []java.DexpreopterInstall

 // systemServerDexJars stores the list of dexjars for system server jars in the prebuilt for use when
 // dexpreopting system server jars that are later in the system server classpath.
 systemServerDexJars android.Paths

 // Certificate information of any apk packaged inside the prebuilt apex.
 // This will be nil if the prebuilt apex does not contain any apk.
 apkCertsFile android.WritablePath
}

type PrebuiltCommonProperties struct {
 SelectedApexProperties

 // Canonical name of this APEX. Used to determine the path to the activated APEX on
 // device (/apex/<apex_name>). If unspecified, follows the name property.
 Apex_name *string

 // Name of the source APEX that gets shadowed by this prebuilt
 // e.g. com.mycompany.android.myapex
 // If unspecified, follows the naming convention that the source apex of
 // the prebuilt is Name() without "prebuilt_" prefix
 Source_apex_name *string

 ForceDisable bool `blueprint:"mutated"`

 // whether the extracted apex file is installable.
 Installable *bool

 // optional name for the installed apex. If unspecified, name of the
 // module is used as the file name
 Filename *string

 // names of modules to be overridden. Listed modules can only be other binaries
 // (in Make or Soong).
 // This does not completely prevent installation of the overridden binaries, but if both
 // binaries would be installed by default (in PRODUCT_PACKAGES) the other binary will be removed
 // from PRODUCT_PACKAGES.
 Overrides []string

 // List of bootclasspath fragments inside this prebuilt APEX bundle and for which this APEX
 // bundle will create an APEX variant.
 Exported_bootclasspath_fragments proptools.Configurable[[]string]

 // List of systemserverclasspath fragments inside this prebuilt APEX bundle and for which this
 // APEX bundle will create an APEX variant.
 Exported_systemserverclasspath_fragments proptools.Configurable[[]string]

 // Path to the .prebuilt_info file of the prebuilt apex.
 // In case of mainline modules, the .prebuilt_info file contains the build_id that was used to
 // generate the prebuilt.
 Prebuilt_info *string `android:"path"`
}

// initPrebuiltCommon initializes the prebuiltCommon structure and performs initialization of the
// module that is common to Prebuilt and ApexSet.
func (p *prebuiltCommon) initPrebuiltCommon(module android.Module, properties *PrebuiltCommonProperties) {
 p.prebuiltCommonProperties = properties
 android.InitSingleSourcePrebuiltModule(module.(android.PrebuiltInterface), properties, "Selected_apex")
 android.InitAndroidMultiTargetsArchModule(module, android.DeviceSupported, android.MultilibCommon)
}

func (p *prebuiltCommon) ApexVariationName() string {
 return proptools.StringDefault(p.prebuiltCommonProperties.Apex_name, p.BaseModuleName())
}

func (p *prebuiltCommon) BaseModuleName() string {
 return proptools.StringDefault(p.prebuiltCommonProperties.Source_apex_name, p.ModuleBase.BaseModuleName())
}

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

func (p *prebuiltCommon) isForceDisabled() bool {
 return p.prebuiltCommonProperties.ForceDisable
}

func (p *prebuiltCommon) checkForceDisable(ctx android.ModuleContext) bool {
 forceDisable := false

 // Force disable the prebuilts when we are doing unbundled build. We do unbundled build
 // to build the prebuilts themselves.
 forceDisable = forceDisable || ctx.Config().UnbundledBuild()

 if forceDisable && p.prebuilt.SourceExists() {
  p.prebuiltCommonProperties.ForceDisable = true
  return true
 }
 return false
}

func (p *prebuiltCommon) InstallFilename() string {
 return proptools.StringDefault(p.prebuiltCommonProperties.Filename, p.BaseModuleName()+imageApexSuffix)
}

func (p *prebuiltCommon) Name() string {
 return p.prebuilt.Name(p.ModuleBase.Name())
}

func (p *prebuiltCommon) Overrides() []string {
 return p.prebuiltCommonProperties.Overrides
}

func (p *prebuiltCommon) installable() bool {
 return proptools.BoolDefault(p.prebuiltCommonProperties.Installable, true)
}

// To satisfy java.DexpreopterInterface
func (p *prebuiltCommon) IsInstallable() bool {
 return p.installable()
}

// initApexFilesForAndroidMk initializes the prebuiltCommon.requiredModuleNames field with the install only deps of the prebuilt apex
func (p *prebuiltCommon) initApexFilesForAndroidMk(ctx android.ModuleContext) {
 // If this apex contains a system server jar, then the dexpreopt artifacts should be added as required
 p.systemServerDexpreoptInstalls = append(p.systemServerDexpreoptInstalls, p.Dexpreopter.ApexSystemServerDexpreoptInstalls()...)
 p.systemServerDexJars = append(p.systemServerDexJars, p.Dexpreopter.ApexSystemServerDexJars()...)
}

func (p *prebuiltCommon) DepsMutator(ctx android.BottomUpMutatorContext) {
 p.Dexpreopter.DepsMutator(ctx)
}

// If this prebuilt has system server jar, create the rules to dexpreopt it and install it alongside the prebuilt apex
func (p *prebuiltCommon) dexpreoptSystemServerJars(ctx android.ModuleContext, di *android.DeapexerInfo) {
 if di == nil {
  return
 }
 // If this prebuilt apex has not been selected, return
 if p.IsHideFromMake() {
  return
 }
 // Use apex_name to determine the api domain of this prebuilt apex
 apexName := p.ApexVariationName()
 // TODO: do not compute twice
 dc := dexpreopt.GetGlobalConfig(ctx)
 systemServerJarList := dc.AllApexSystemServerJars(ctx)

 for i := 0; i < systemServerJarList.Len(); i++ {
  sscpApex := systemServerJarList.Apex(i)
  sscpJar := systemServerJarList.Jar(i)
  if apexName != sscpApex {
   continue
  }
  p.Dexpreopter.DexpreoptPrebuiltApexSystemServerJars(ctx, sscpJar, di)
 }
}

// installApexSystemServerFiles installs dexpreopt files for system server classpath entries
// provided by the apex.  They are installed here instead of in library module because there may be multiple
// variants of the library, generally one for the "main" apex and another with a different min_sdk_version
// for the Android Go version of the apex.  Both variants would attempt to install to the same locations,
// and the library variants cannot determine which one should.  The apex module is better equipped to determine
// if it is "selected".
// This assumes that the jars produced by different min_sdk_version values are identical, which is currently
// true but may not be true if the min_sdk_version difference between the variants spans version that changed
// the dex format.
func (p *prebuiltCommon) installApexSystemServerFiles(ctx android.ModuleContext) {
 performInstalls := android.IsModulePreferred(ctx.Module())

 for _, install := range p.systemServerDexpreoptInstalls {
  var installedFile android.InstallPath
  if performInstalls {
   installedFile = ctx.InstallFile(install.InstallDirOnDevice, install.InstallFileOnDevice, install.OutputPathOnHost)
  } else {
   installedFile = install.InstallDirOnDevice.Join(ctx, install.InstallFileOnDevice)
  }
  p.extraInstalledFiles = append(p.extraInstalledFiles, installedFile)
  p.extraInstalledPairs = append(p.extraInstalledPairs, installPair{install.OutputPathOnHost, installedFile})
  ctx.PackageFile(install.InstallDirOnDevice, install.InstallFileOnDevice, install.OutputPathOnHost)
 }

 for _, dexJar := range p.systemServerDexJars {
  // Copy the system server dex jar to a predefined location where dex2oat will find it.
  android.CopyFileRule(ctx, dexJar,
   android.PathForOutput(ctx, dexpreopt.SystemServerDexjarsDir, dexJar.Base()))
 }
}

func (p *prebuiltCommon) AndroidMkEntries() []android.AndroidMkEntries {
 entriesList := []android.AndroidMkEntries{
  {
   Class:      "ETC",
   OutputFile: android.OptionalPathForPath(p.outputApex),
   Include:    "$(BUILD_PREBUILT)",
   ExtraEntries: []android.AndroidMkExtraEntriesFunc{
    func(ctx android.AndroidMkExtraEntriesContext, entries *android.AndroidMkEntries) {
     entries.SetString("LOCAL_MODULE_PATH", p.installDir.String())
     entries.SetString("LOCAL_MODULE_STEM", p.installFilename)
     entries.SetPath("LOCAL_SOONG_INSTALLED_MODULE", p.installedFile)
     installPairs := append(installPairs{{p.outputApex, p.installedFile}}, p.extraInstalledPairs...)
     entries.SetString("LOCAL_SOONG_INSTALL_PAIRS", installPairs.String())
     entries.AddStrings("LOCAL_SOONG_INSTALL_SYMLINKS", p.compatSymlinks.Strings()...)
     entries.SetBoolIfTrue("LOCAL_UNINSTALLABLE_MODULE", !p.installable())
     entries.AddStrings("LOCAL_OVERRIDES_MODULES", p.prebuiltCommonProperties.Overrides...)
     entries.SetString("LOCAL_APEX_KEY_PATH", p.apexKeysPath.String())
     if p.apkCertsFile != nil {
      entries.SetString("LOCAL_APKCERTS_FILE", p.apkCertsFile.String())
     }

    },
   },
  },
 }

 return entriesList
}

func (p *prebuiltCommon) hasExportedDeps(ctx android.ModuleContext) bool {
 return len(p.prebuiltCommonProperties.Exported_bootclasspath_fragments.GetOrDefault(ctx, nil)) > 0 ||
  len(p.prebuiltCommonProperties.Exported_systemserverclasspath_fragments.GetOrDefault(ctx, nil)) > 0
}

type appInPrebuiltApexDepTag struct {
 blueprint.BaseDependencyTag
}

func (appInPrebuiltApexDepTag) ExcludeFromVisibilityEnforcement() {}

var appInPrebuiltApexTag = appInPrebuiltApexDepTag{}

// prebuiltApexContentsDeps adds dependencies onto the prebuilt apex module's contents.
func (p *prebuiltCommon) prebuiltApexContentsDeps(ctx android.BottomUpMutatorContext) {
 module := ctx.Module()

 for _, dep := range p.prebuiltCommonProperties.Exported_bootclasspath_fragments.GetOrDefault(ctx, nil) {
  prebuiltDep := android.PrebuiltNameFromSource(dep)
  ctx.AddDependency(module, exportedBootclasspathFragmentTag, prebuiltDep)
  ctx.AddDependency(module, fragmentInApexTag, prebuiltDep)
 }

 for _, dep := range p.prebuiltCommonProperties.Exported_systemserverclasspath_fragments.GetOrDefault(ctx, nil) {
  prebuiltDep := android.PrebuiltNameFromSource(dep)
  ctx.AddDependency(module, exportedSystemserverclasspathFragmentTag, prebuiltDep)
 }
}

// Implements android.DepInInSameApex
func (m *prebuiltCommon) GetDepInSameApexChecker() android.DepInSameApexChecker {
 return ApexPrebuiltDepInSameApexChecker{}
}

// @auto-generate: gob
type ApexPrebuiltDepInSameApexChecker struct {
 android.BaseDepInSameApexChecker
}

func (m ApexPrebuiltDepInSameApexChecker) OutgoingDepIsInSameApex(tag blueprint.DependencyTag) bool {
 _, ok := tag.(exportedDependencyTag)
 return ok
}

func (p *prebuiltCommon) checkExportedDependenciesArePrebuilts(ctx android.ModuleContext) {
 ctx.VisitDirectDepsProxy(func(dep android.ModuleProxy) {
  tag := ctx.OtherModuleDependencyTag(dep)
  depName := ctx.OtherModuleName(dep)
  if exportedTag, ok := tag.(exportedDependencyTag); ok {
   propertyName := exportedTag.name

   // It is an error if the other module is not a prebuilt.
   if !android.IsModulePrebuilt(ctx, dep) {
    ctx.PropertyErrorf(propertyName, "%q is not a prebuilt module", depName)
   }

   // It is an error if the other module is not an ApexModule.
   if _, ok := android.OtherModuleProvider(ctx, dep, android.ApexInfoProvider); !ok {
    ctx.PropertyErrorf(propertyName, "%q is not usable within an apex", depName)
   }
  }

 })
}

// generateApexInfo returns an android.ApexInfo configuration suitable for dependencies of this apex.
func (p *prebuiltCommon) generateApexInfo(ctx generateApexInfoContext) android.ApexInfo {
 return android.ApexInfo{
  ApexVariationName: "prebuilt_" + p.ApexVariationName(),
  BaseApexName:      p.ApexVariationName(),
  ForPrebuiltApex:   true,
 }
}

type Prebuilt struct {
 prebuiltCommon

 properties PrebuiltProperties

 inputApex android.Path
}

type ApexFileProperties struct {
 // the path to the prebuilt .apex file to import.
 //
 // This cannot be marked as `android:"arch_variant"` because the `prebuilt_apex` is only mutated
 // for android_common. That is so that it will have the same arch variant as, and so be compatible
 // with, the source `apex` module type that it replaces.
 Src  proptools.Configurable[string] `android:"path,replace_instead_of_append"`
 Arch struct {
  Arm struct {
   Src *string `android:"path"`
  }
  Arm64 struct {
   Src *string `android:"path"`
  }
  Riscv64 struct {
   Src *string `android:"path"`
  }
  X86 struct {
   Src *string `android:"path"`
  }
  X86_64 struct {
   Src *string `android:"path"`
  }
 }
}

// prebuiltApexSelector selects the correct prebuilt APEX file for the build target.
//
// The ctx parameter can be for any module not just the prebuilt module so care must be taken not
// to use methods on it that are specific to the current module.
//
// See the ApexFileProperties.Src property.
func (p *ApexFileProperties) prebuiltApexSelector(ctx android.BaseModuleContext, prebuilt android.Module) string {
 multiTargets := prebuilt.MultiTargets()
 if len(multiTargets) != 1 {
  ctx.OtherModuleErrorf(prebuilt, "compile_multilib shouldn't be \"both\" for prebuilt_apex")
  return ""
 }
 var src string
 switch multiTargets[0].Arch.ArchType {
 case android.Arm:
  src = String(p.Arch.Arm.Src)
 case android.Arm64:
  src = String(p.Arch.Arm64.Src)
 case android.Riscv64:
  src = String(p.Arch.Riscv64.Src)
  // HACK: fall back to arm64 prebuilts, the riscv64 ones don't exist yet.
  if src == "" {
   src = String(p.Arch.Arm64.Src)
  }
 case android.X86:
  src = String(p.Arch.X86.Src)
 case android.X86_64:
  src = String(p.Arch.X86_64.Src)
 }
 if src == "" {
  src = p.Src.GetOrDefault(ctx, "")
 }

 if src == "" {
  if ctx.Config().AllowMissingDependencies() {
   ctx.AddMissingDependencies([]string{ctx.OtherModuleName(prebuilt)})
  } else {
   ctx.OtherModuleErrorf(prebuilt, "prebuilt_apex does not support %q", multiTargets[0].Arch.String())
  }
  // Drop through to return an empty string as the src (instead of nil) to avoid the prebuilt
  // logic from reporting a more general, less useful message.
 }

 return src
}

type PrebuiltProperties struct {
 ApexFileProperties

 PrebuiltCommonProperties

 // List of apps that are bundled inside this prebuilt apex.
 // This will be used to create the certificate info of those apps for apkcerts.txt
 // This dependency will only be used for apkcerts.txt processing.
 // Notably, building the prebuilt apex will not build the source app.
 Apps []string
}

func (a *Prebuilt) HasSanitizedSource(sanitizer string) bool {
 return false
}

var _ android.SanitizedPrebuilt = (*Prebuilt)(nil)

// prebuilt_apex imports an `.apex` file into the build graph as if it was built with apex.
func PrebuiltFactory() android.Module {
 module := &Prebuilt{}
 module.AddProperties(&module.properties)
 module.prebuiltCommon.prebuiltCommonProperties = &module.properties.PrebuiltCommonProperties

 // init the module as a prebuilt
 // even though this module type has srcs, use `InitPrebuiltModuleWithoutSrcs`, since the existing
 // InitPrebuiltModule* are not friendly with Sources of Configurable type.
 // The actual src will be evaluated in GenerateAndroidBuildActions.
 android.InitPrebuiltModuleWithoutSrcs(module)
 android.InitAndroidMultiTargetsArchModule(module, android.DeviceSupported, android.MultilibCommon)

 return module
}

func (p *prebuiltCommon) getDeapexerPropertiesIfNeeded(ctx android.ModuleContext) DeapexerProperties {
 // Compute the deapexer properties from the transitive dependencies of this module.
 commonModules := []string{}
 dexpreoptProfileGuidedModules := []string{}
 exportedFiles := []string{}
 ctx.WalkDepsProxy(func(child, parent android.ModuleProxy) bool {
  tag := ctx.OtherModuleDependencyTag(child)

  // If the child is not in the same apex as the parent then ignore it and all its children.
  if !android.IsDepInSameApex(ctx, parent, child) {
   return false
  }

  name := java.ModuleStemForDeapexing(ctx, child)
  if _, ok := tag.(android.RequiresFilesFromPrebuiltApexTag); ok {
   commonModules = append(commonModules, name)

   info := android.OtherModuleProviderOrDefault(ctx, child, android.RequiredFilesFromPrebuiltApexInfoProvider)
   exportedFiles = append(exportedFiles, info.RequiredFilesFromPrebuiltApex...)

   if info.UseProfileGuidedDexpreopt {
    dexpreoptProfileGuidedModules = append(dexpreoptProfileGuidedModules, name)
   }

   // Visit the dependencies of this module just in case they also require files from the
   // prebuilt apex.
   return true
  }

  return false
 })

 // Create properties for deapexer module.
 deapexerProperties := DeapexerProperties{
  // Remove any duplicates from the common modules lists as a module may be included via a direct
  // dependency as well as transitive ones.
  CommonModules:                 android.SortedUniqueStrings(commonModules),
  DexpreoptProfileGuidedModules: android.SortedUniqueStrings(dexpreoptProfileGuidedModules),
 }

 // Populate the exported files property in a fixed order.
 deapexerProperties.ExportedFiles = android.SortedUniqueStrings(exportedFiles)
 return deapexerProperties
}

func prebuiltApexExportedModuleName(ctx android.BottomUpMutatorContext, name string) string {
 // The prebuilt_apex should be depending on prebuilt modules but as this runs after
 // prebuilt_rename the prebuilt module may or may not be using the prebuilt_ prefixed named. So,
 // check to see if the prefixed name is in use first, if it is then use that, otherwise assume
 // the unprefixed name is the one to use. If the unprefixed one turns out to be a source module
 // and not a renamed prebuilt module then that will be detected and reported as an error when
 // processing the dependency in ApexInfoMutator().
 prebuiltName := android.PrebuiltNameFromSource(name)
 if ctx.OtherModuleExists(prebuiltName) {
  name = prebuiltName
 }
 return name
}

type exportedDependencyTag struct {
 blueprint.BaseDependencyTag
 name string
}

// Mark this tag so dependencies that use it are excluded from visibility enforcement.
//
// This does allow any prebuilt_apex to reference any module which does open up a small window for
// restricted visibility modules to be referenced from the wrong prebuilt_apex. However, doing so
// avoids opening up a much bigger window by widening the visibility of modules that need files
// provided by the prebuilt_apex to include all the possible locations they may be defined, which
// could include everything below vendor/.
//
// A prebuilt_apex that references a module via this tag will have to contain the appropriate files
// corresponding to that module, otherwise it will fail when attempting to retrieve the files from
// the .apex file. It will also have to be included in the module's apex_available property too.
// That makes it highly unlikely that a prebuilt_apex would reference a restricted module
// incorrectly.
func (t exportedDependencyTag) ExcludeFromVisibilityEnforcement() {}

func (t exportedDependencyTag) RequiresFilesFromPrebuiltApex() {}

var _ android.RequiresFilesFromPrebuiltApexTag = exportedDependencyTag{}

var (
 exportedBootclasspathFragmentTag         = exportedDependencyTag{name: "exported_bootclasspath_fragments"}
 exportedSystemserverclasspathFragmentTag = exportedDependencyTag{name: "exported_systemserverclasspath_fragments"}
)

func (p *Prebuilt) ComponentDepsMutator(ctx android.BottomUpMutatorContext) {
 p.prebuiltApexContentsDeps(ctx)
 for _, app := range p.properties.Apps {
  ctx.AddDependency(p, appInPrebuiltApexTag, app)
 }
}

var _ ApexTransitionMutator = (*Prebuilt)(nil)

func (p *Prebuilt) ApexTransitionMutatorSplit(ctx android.BaseModuleContext) []android.ApexInfo {
 return []android.ApexInfo{p.generateApexInfo(ctx)}
}

func (p *Prebuilt) ApexTransitionMutatorOutgoing(ctx android.OutgoingTransitionContext, sourceInfo android.ApexInfo) android.ApexInfo {
 return sourceInfo
}

func (p *Prebuilt) ApexTransitionMutatorIncoming(ctx android.IncomingTransitionContext, outgoingInfo android.ApexInfo) android.ApexInfo {
 return p.generateApexInfo(ctx)
}

func (p *Prebuilt) ApexTransitionMutatorMutate(ctx android.BottomUpMutatorContext, info android.ApexInfo) {
 android.SetProvider(ctx, android.ApexBundleInfoProvider, android.ApexBundleInfo{})
}

// creates the build rules to deapex the prebuilt, and returns a deapexerInfo
func (p *prebuiltCommon) getDeapexerInfo(ctx android.ModuleContext, apexFile android.Path) *android.DeapexerInfo {
 if !p.hasExportedDeps(ctx) {
  // nothing to do
  return nil
 }
 deapexerProps := p.getDeapexerPropertiesIfNeeded(ctx)
 return deapex(ctx, apexFile, deapexerProps)
}

// Set a provider containing information about the jars and .prof provided by the apex
// Apexes built from prebuilts retrieve this information by visiting its internal deapexer module
// Used by dex_bootjars to generate the boot image
func (p *prebuiltCommon) provideApexExportsInfo(ctx android.ModuleContext, di *android.DeapexerInfo) {
 if di == nil {
  return
 }
 javaModuleToDexPath := map[string]android.Path{}
 for _, commonModule := range di.GetExportedModuleNames() {
  if dex := di.PrebuiltExportPath(java.ApexRootRelativePathToJavaLib(commonModule)); dex != nil {
   javaModuleToDexPath[commonModule] = dex
  }
 }

 exports := android.ApexExportsInfo{
  ApexName:                      p.ApexVariationName(),
  ProfilePathOnHost:             di.PrebuiltExportPath(java.ProfileInstallPathInApex),
  LibraryNameToDexJarPathOnHost: javaModuleToDexPath,
 }
 android.SetProvider(ctx, android.ApexExportsInfoProvider, exports)
}

// Set prebuiltInfoProvider. This will be used by `apex_prebuiltinfo_singleton` to print out a metadata file
// with information about whether source or prebuilt of an apex was used during the build.
func (p *prebuiltCommon) providePrebuiltInfo(ctx android.ModuleContext) {
 info := android.PrebuiltJsonInfo{
  Name:        p.BaseModuleName(),
  Is_prebuilt: true,
 }
 // If Prebuilt_info information is available in the soong module definition, add it to prebuilt_info.json.
 if p.prebuiltCommonProperties.Prebuilt_info != nil {
  info.Prebuilt_info_file_path = android.PathForModuleSrc(ctx, *p.prebuiltCommonProperties.Prebuilt_info).String()
 }
 android.SetProvider(ctx, android.PrebuiltJsonInfoProvider, info)
}

// Uses an object provided by its deps to validate that the contents of bcpf have been added to the global
// PRODUCT_APEX_BOOT_JARS
// This validation will only run on the apex which is active for this product/release_config
func validateApexClasspathFragments(ctx android.ModuleContext) {
 ctx.VisitDirectDepsProxy(func(m android.ModuleProxy) {
  if info, exists := android.OtherModuleProvider(ctx, m, java.ClasspathFragmentValidationInfoProvider); exists {
   ctx.ModuleErrorf("%s in contents of %s must also be declared in PRODUCT_APEX_BOOT_JARS", info.UnknownJars, info.ClasspathFragmentModuleName)
  }
 })
}

func (p *Prebuilt) GenerateAndroidBuildActions(ctx android.ModuleContext) {
 // Validate contents of classpath fragments
 if !p.IsHideFromMake() {
  validateApexClasspathFragments(ctx)
 }

 p.checkExportedDependenciesArePrebuilts(ctx)

 p.apexKeysPath = writeApexKeys(ctx, p)
 // TODO(jungjw): Check the key validity.
 prebuiltApex := p.properties.prebuiltApexSelector(ctx, ctx.Module())
 p.inputApex = android.PathForModuleSrc(ctx, prebuiltApex)
 p.installDir = android.PathForModuleInstall(ctx, "apex")
 p.installFilename = p.InstallFilename()
 if !strings.HasSuffix(p.installFilename, imageApexSuffix) {
  ctx.ModuleErrorf("filename should end in %s for prebuilt_apex", imageApexSuffix)
 }
 p.outputApex = android.PathForModuleOut(ctx, p.installFilename)
 ctx.Build(pctx, android.BuildParams{
  Rule:   android.CpRule,
  Input:  p.inputApex,
  Output: p.outputApex,
 })

 if p.prebuiltCommon.checkForceDisable(ctx) {
  p.HideFromMake()
  return
 }

 deapexerInfo := p.getDeapexerInfo(ctx, p.inputApex)

 // dexpreopt any system server jars if present
 p.dexpreoptSystemServerJars(ctx, deapexerInfo)

 // provide info used for generating the boot image
 p.provideApexExportsInfo(ctx, deapexerInfo)

 p.providePrebuiltInfo(ctx)

 // Save the files that need to be made available to Make.
 p.initApexFilesForAndroidMk(ctx)

 // in case that prebuilt_apex replaces source apex (using prefer: prop)
 p.compatSymlinks = makeCompatSymlinks(p.BaseModuleName(), ctx)
 // or that prebuilt_apex overrides other apexes (using overrides: prop)
 for _, overridden := range p.prebuiltCommonProperties.Overrides {
  p.compatSymlinks = append(p.compatSymlinks, makeCompatSymlinks(overridden, ctx)...)
 }

 if p.installable() {
  p.installApexSystemServerFiles(ctx)
  installDeps := slices.Concat(p.compatSymlinks, p.extraInstalledFiles)
  p.installedFile = ctx.InstallFile(p.installDir, p.installFilename, p.inputApex, installDeps...)
  provenance.GenerateArtifactProvenanceMetaData(ctx, p.inputApex, p.installedFile)
 }

 p.addApkCertsInfo(ctx)

 ctx.SetOutputFiles(android.Paths{p.outputApex}, "")

 android.SetProvider(ctx, filesystem.ApexKeyPathInfoProvider, filesystem.ApexKeyPathInfo{p.apexKeysPath})

 ctx.ComplianceMetadataInfo().SetPrebuiltSrc(ctx, prebuiltApex)
}

// Creates a timestamp file that will be used to validate that there is no mismtach
// between apks declared via `apps` and the actual apks inside the apex.
func (p *Prebuilt) validateApkInPrebuiltApex(ctx android.ModuleContext, appInfos java.AppInfos) android.Path {
 timestamp := android.PathForModuleOut(ctx, "apk_in_prebuilt_apex.timestamp")
 // Create a list of expected installed apks.
 var installedApks []string
 for _, appInfo := range appInfos {
  installedApks = append(installedApks, appInfo.InstallApkName+".apk")
 }
 expectedApksFile := android.PathForModuleOut(ctx, "expected_apk_in_prebuilt_apex.txt")
 if len(installedApks) == 0 {
  android.WriteFileRuleVerbatim(ctx, expectedApksFile, "") // Without newline
 } else {
  android.WriteFileRule(ctx, expectedApksFile, strings.Join(android.SortedUniqueStrings(installedApks), "\n")) // With newline
 }

 actualApksFile := android.PathForModuleOut(ctx, "actual_apk_in_prebuilt_apex.txt")
 ctx.Build(pctx, android.BuildParams{
  Rule:           validateApkInPrebuiltApex,
  Input:          p.inputApex,
  Output:         timestamp,
  Implicit:       expectedApksFile,
  ImplicitOutput: actualApksFile,
  Args: map[string]string{
   "expectedApks": expectedApksFile.String(),
   "actualApks":   actualApksFile.String(),
   "apexName":     p.Name(),
  },
 })
 return timestamp
}

// `addApkCertsInfo` sets a provider that will be used to create apkcerts.txt
func (p *Prebuilt) addApkCertsInfo(ctx android.ModuleContext) {
 // Determine if this prebuilt_apex contains any .apks
 var appInfos java.AppInfos
 ctx.VisitDirectDepsProxyWithTag(appInPrebuiltApexTag, func(app android.ModuleProxy) {
  if appInfo, ok := android.OtherModuleProvider(ctx, app, java.AppInfoProvider); ok {
   appInfos = append(appInfos, *appInfo)
  } else {
   ctx.ModuleErrorf("App %s does not set AppInfoProvider\n", app.Name())
  }
 })
 sort.Slice(appInfos, func(i, j int) bool {
  return appInfos[i].InstallApkName < appInfos[j].InstallApkName
 })

 // Create p.apkCertsFile with information about apk-in-apex
 // p.apkCertsFile will become `LOCAL_APKCERTS_FILE` for Make packaging system
 // p.apkCertsFile will be propagated to android_device for Soong packaging system
 var lines []string
 for _, appInfo := range appInfos {
  lines = append(lines, java.FormatApkCertsLine(appInfo.Certificate, appInfo.InstallApkName+".apk", p.PartitionTag(ctx.DeviceConfig())))
 }
 apkCertsFile := android.PathForModuleOut(ctx, "apkcerts.txt")
 var validations android.Paths
 if p.IsInstallable() {
  // Skip the validation for non-installable prebuilt apexes (e.g. used in CTS tests).
  validations = append(validations, p.validateApkInPrebuiltApex(ctx, appInfos))
 }
 android.WriteFileRule(ctx, apkCertsFile, strings.Join(lines, "\n"), validations...)

 // Skip exporting the apkcerts file if there were missing dependencies, because soong will
 // cause all build rules of a module with missing dependencies to fail to build.
 if len(ctx.GetMissingDependencies()) == 0 {
  p.apkCertsFile = apkCertsFile
  android.SetProvider(ctx, java.ApkCertInfoProvider, java.ApkCertInfo{
   ApkCertsFile: p.apkCertsFile,
  })
 }
}

// extract registers the build actions to extract an apex from .apks file
// returns the path of the extracted apex
func extract(ctx android.ModuleContext, apexSet android.Path, prerelease *bool) android.Path {
 defaultAllowPrerelease := ctx.Config().IsEnvTrue("SOONG_ALLOW_PRERELEASE_APEXES")
 extractedApex := android.PathForModuleOut(ctx, "extracted", apexSet.Base())
 // Filter out NativeBridge archs (b/260115309)
 abis := java.SupportedAbis(ctx, true)
 ctx.Build(pctx,
  android.BuildParams{
   Rule:        extractMatchingApex,
   Description: "Extract an apex from an apex set",
   Inputs:      android.Paths{apexSet},
   Output:      extractedApex,
   Args: map[string]string{
    "abis":              strings.Join(abis, ","),
    "allow-prereleased": strconv.FormatBool(proptools.BoolDefault(prerelease, defaultAllowPrerelease)),
    "sdk-version":       ctx.Config().PlatformSdkVersion().String(),
    "skip-sdk-check":    strconv.FormatBool(ctx.Config().IsEnvTrue("SOONG_SKIP_APPSET_SDK_CHECK")),
   },
  },
 )
 return extractedApex
}

type ApexSet struct {
 prebuiltCommon

 properties ApexSetProperties
}

type ApexExtractorProperties struct {
 // the .apks file path that contains prebuilt apex files to be extracted.
 Set *string `android:"path"`

 Sanitized struct {
  None struct {
   Set *string `android:"path"`
  }
  Address struct {
   Set *string `android:"path"`
  }
  Hwaddress struct {
   Set *string `android:"path"`
  }
 }

 // apexes in this set use prerelease SDK version
 Prerelease *bool
}

func (e *ApexExtractorProperties) prebuiltSrcs(ctx android.BaseModuleContext) []string {
 var srcs []string
 if e.Set != nil {
  srcs = append(srcs, *e.Set)
 }

 sanitizers := ctx.Config().SanitizeDevice()

 if android.InList("address", sanitizers) && e.Sanitized.Address.Set != nil {
  srcs = append(srcs, *e.Sanitized.Address.Set)
 } else if android.InList("hwaddress", sanitizers) && e.Sanitized.Hwaddress.Set != nil {
  srcs = append(srcs, *e.Sanitized.Hwaddress.Set)
 } else if e.Sanitized.None.Set != nil {
  srcs = append(srcs, *e.Sanitized.None.Set)
 }

 return srcs
}

type ApexSetProperties struct {
 ApexExtractorProperties

 PrebuiltCommonProperties
}

func (a *ApexSet) HasSanitizedSource(sanitizer string) bool {
 if sanitizer == "address" {
  return a.properties.Sanitized.Address.Set != nil
 }
 if sanitizer == "hwaddress" {
  return a.properties.Sanitized.Hwaddress.Set != nil
 }

 return false
}

var _ android.SanitizedPrebuilt = (*ApexSet)(nil)

// prebuilt_apex imports an `.apex` file into the build graph as if it was built with apex.
func apexSetFactory() android.Module {
 module := &ApexSet{}
 module.AddProperties(&module.properties)
 module.prebuiltCommon.prebuiltCommonProperties = &module.properties.PrebuiltCommonProperties

 // init the module as a prebuilt
 // even though this module type has srcs, use `InitPrebuiltModuleWithoutSrcs`, since the existing
 // InitPrebuiltModule* are not friendly with Sources of Configurable type.
 // The actual src will be evaluated in GenerateAndroidBuildActions.
 android.InitPrebuiltModuleWithoutSrcs(module)
 android.InitAndroidMultiTargetsArchModule(module, android.DeviceSupported, android.MultilibCommon)

 return module
}

func (a *ApexSet) ComponentDepsMutator(ctx android.BottomUpMutatorContext) {
 a.prebuiltApexContentsDeps(ctx)
}

var _ ApexTransitionMutator = (*ApexSet)(nil)

func (a *ApexSet) ApexTransitionMutatorSplit(ctx android.BaseModuleContext) []android.ApexInfo {
 return []android.ApexInfo{a.generateApexInfo(ctx)}
}

func (a *ApexSet) ApexTransitionMutatorOutgoing(ctx android.OutgoingTransitionContext, sourceInfo android.ApexInfo) android.ApexInfo {
 return sourceInfo
}

func (a *ApexSet) ApexTransitionMutatorIncoming(ctx android.IncomingTransitionContext, outgoingInfo android.ApexInfo) android.ApexInfo {
 return a.generateApexInfo(ctx)
}

func (a *ApexSet) ApexTransitionMutatorMutate(ctx android.BottomUpMutatorContext, info android.ApexInfo) {
 android.SetProvider(ctx, android.ApexBundleInfoProvider, android.ApexBundleInfo{})
}

func (a *ApexSet) GenerateAndroidBuildActions(ctx android.ModuleContext) {
 // Validate contents of classpath fragments
 if !a.IsHideFromMake() {
  validateApexClasspathFragments(ctx)
 }

 a.apexKeysPath = writeApexKeys(ctx, a)
 a.installFilename = a.InstallFilename()
 if !strings.HasSuffix(a.installFilename, imageApexSuffix) && !strings.HasSuffix(a.installFilename, imageCapexSuffix) {
  ctx.ModuleErrorf("filename should end in %s or %s for apex_set", imageApexSuffix, imageCapexSuffix)
 }

 var apexSet android.Path
 if srcs := a.properties.prebuiltSrcs(ctx); len(srcs) == 1 {
  apexSet = android.PathForModuleSrc(ctx, srcs[0])
 } else {
  ctx.ModuleErrorf("Expected exactly one source apex_set file, found %v\n", srcs)
 }

 extractedApex := extract(ctx, apexSet, a.properties.Prerelease)

 a.outputApex = android.PathForModuleOut(ctx, a.installFilename)

 // Build the output APEX. If compression is not enabled, make sure the output is not compressed even if the input is compressed
 buildRule := android.CpRule
 if !ctx.Config().ApexCompressionEnabled() {
  buildRule = decompressApex
 }
 ctx.Build(pctx, android.BuildParams{
  Rule:   buildRule,
  Input:  extractedApex,
  Output: a.outputApex,
 })

 if a.prebuiltCommon.checkForceDisable(ctx) {
  a.HideFromMake()
  return
 }

 deapexerInfo := a.getDeapexerInfo(ctx, extractedApex)

 // dexpreopt any system server jars if present
 a.dexpreoptSystemServerJars(ctx, deapexerInfo)

 // provide info used for generating the boot image
 a.provideApexExportsInfo(ctx, deapexerInfo)

 a.providePrebuiltInfo(ctx)

 // Save the files that need to be made available to Make.
 a.initApexFilesForAndroidMk(ctx)

 a.installDir = android.PathForModuleInstall(ctx, "apex")
 if a.installable() {
  a.installApexSystemServerFiles(ctx)
  a.installedFile = ctx.InstallFile(a.installDir, a.installFilename, a.outputApex, a.extraInstalledFiles...)
 }

 // in case that apex_set replaces source apex (using prefer: prop)
 a.compatSymlinks = makeCompatSymlinks(a.BaseModuleName(), ctx)
 // or that apex_set overrides other apexes (using overrides: prop)
 for _, overridden := range a.prebuiltCommonProperties.Overrides {
  a.compatSymlinks = append(a.compatSymlinks, makeCompatSymlinks(overridden, ctx)...)
 }

 ctx.SetOutputFiles(android.Paths{a.outputApex}, "")

 android.SetProvider(ctx, filesystem.ApexKeyPathInfoProvider, filesystem.ApexKeyPathInfo{a.apexKeysPath})
}