12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340 |
- // Copyright (C) 2021 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 java
- import (
- "fmt"
- "io"
- "path/filepath"
- "reflect"
- "strings"
- "android/soong/android"
- "android/soong/dexpreopt"
- "github.com/google/blueprint/proptools"
- "github.com/google/blueprint"
- )
- func init() {
- registerBootclasspathFragmentBuildComponents(android.InitRegistrationContext)
- android.RegisterSdkMemberType(BootclasspathFragmentSdkMemberType)
- }
- func registerBootclasspathFragmentBuildComponents(ctx android.RegistrationContext) {
- ctx.RegisterModuleType("bootclasspath_fragment", bootclasspathFragmentFactory)
- ctx.RegisterModuleType("bootclasspath_fragment_test", testBootclasspathFragmentFactory)
- ctx.RegisterModuleType("prebuilt_bootclasspath_fragment", prebuiltBootclasspathFragmentFactory)
- }
- // BootclasspathFragmentSdkMemberType is the member type used to add bootclasspath_fragments to
- // the SDK snapshot. It is exported for use by apex.
- var BootclasspathFragmentSdkMemberType = &bootclasspathFragmentMemberType{
- SdkMemberTypeBase: android.SdkMemberTypeBase{
- PropertyName: "bootclasspath_fragments",
- SupportsSdk: true,
- },
- }
- type bootclasspathFragmentContentDependencyTag struct {
- blueprint.BaseDependencyTag
- }
- // Avoid having to make bootclasspath_fragment content visible to the bootclasspath_fragment.
- //
- // This is a temporary workaround to make it easier to migrate to bootclasspath_fragment modules
- // with proper dependencies.
- // TODO(b/177892522): Remove this and add needed visibility.
- func (b bootclasspathFragmentContentDependencyTag) ExcludeFromVisibilityEnforcement() {
- }
- // The bootclasspath_fragment contents must never depend on prebuilts.
- func (b bootclasspathFragmentContentDependencyTag) ReplaceSourceWithPrebuilt() bool {
- return false
- }
- // SdkMemberType causes dependencies added with this tag to be automatically added to the sdk as if
- // they were specified using java_boot_libs or java_sdk_libs.
- func (b bootclasspathFragmentContentDependencyTag) SdkMemberType(child android.Module) android.SdkMemberType {
- // If the module is a java_sdk_library then treat it as if it was specified in the java_sdk_libs
- // property, otherwise treat if it was specified in the java_boot_libs property.
- if javaSdkLibrarySdkMemberType.IsInstance(child) {
- return javaSdkLibrarySdkMemberType
- }
- return javaBootLibsSdkMemberType
- }
- func (b bootclasspathFragmentContentDependencyTag) ExportMember() bool {
- return true
- }
- // Contents of bootclasspath fragments in an apex are considered to be directly in the apex, as if
- // they were listed in java_libs.
- func (b bootclasspathFragmentContentDependencyTag) CopyDirectlyInAnyApex() {}
- // Contents of bootclasspath fragments require files from prebuilt apex files.
- func (b bootclasspathFragmentContentDependencyTag) RequiresFilesFromPrebuiltApex() {}
- // The tag used for the dependency between the bootclasspath_fragment module and its contents.
- var bootclasspathFragmentContentDepTag = bootclasspathFragmentContentDependencyTag{}
- var _ android.ExcludeFromVisibilityEnforcementTag = bootclasspathFragmentContentDepTag
- var _ android.ReplaceSourceWithPrebuilt = bootclasspathFragmentContentDepTag
- var _ android.SdkMemberDependencyTag = bootclasspathFragmentContentDepTag
- var _ android.CopyDirectlyInAnyApexTag = bootclasspathFragmentContentDepTag
- var _ android.RequiresFilesFromPrebuiltApexTag = bootclasspathFragmentContentDepTag
- func IsBootclasspathFragmentContentDepTag(tag blueprint.DependencyTag) bool {
- return tag == bootclasspathFragmentContentDepTag
- }
- // Properties that can be different when coverage is enabled.
- type BootclasspathFragmentCoverageAffectedProperties struct {
- // The contents of this bootclasspath_fragment, could be either java_library, or java_sdk_library.
- //
- // A java_sdk_library specified here will also be treated as if it was specified on the stub_libs
- // property.
- //
- // The order of this list matters as it is the order that is used in the bootclasspath.
- Contents []string
- // The properties for specifying the API stubs provided by this fragment.
- BootclasspathAPIProperties
- }
- type bootclasspathFragmentProperties struct {
- // The name of the image this represents.
- //
- // If specified then it must be one of "art" or "boot".
- Image_name *string
- // Properties whose values need to differ with and without coverage.
- BootclasspathFragmentCoverageAffectedProperties
- Coverage BootclasspathFragmentCoverageAffectedProperties
- // Hidden API related properties.
- Hidden_api HiddenAPIFlagFileProperties
- // The list of additional stub libraries which this fragment's contents use but which are not
- // provided by another bootclasspath_fragment.
- //
- // Note, "android-non-updatable" is treated specially. While no such module exists it is treated
- // as if it was a java_sdk_library. So, when public API stubs are needed then it will be replaced
- // with "android-non-updatable.stubs", with "androidn-non-updatable.system.stubs" when the system
- // stubs are needed and so on.
- Additional_stubs []string
- // Properties that allow a fragment to depend on other fragments. This is needed for hidden API
- // processing as it needs access to all the classes used by a fragment including those provided
- // by other fragments.
- BootclasspathFragmentsDepsProperties
- }
- type HiddenApiPackageProperties struct {
- Hidden_api struct {
- // Contains prefixes of a package hierarchy that is provided solely by this
- // bootclasspath_fragment.
- //
- // This affects the signature patterns file that is used to select the subset of monolithic
- // hidden API flags. See split_packages property for more details.
- Package_prefixes []string
- // A list of individual packages that are provided solely by this
- // bootclasspath_fragment but which cannot be listed in package_prefixes
- // because there are sub-packages which are provided by other modules.
- //
- // This should only be used for legacy packages. New packages should be
- // covered by a package prefix.
- Single_packages []string
- // The list of split packages provided by this bootclasspath_fragment.
- //
- // A split package is one that contains classes which are provided by multiple
- // bootclasspath_fragment modules.
- //
- // This defaults to "*" - which treats all packages as being split. A module that has no split
- // packages must specify an empty list.
- //
- // This affects the signature patterns file that is generated by a bootclasspath_fragment and
- // used to select the subset of monolithic hidden API flags against which the flags generated
- // by the bootclasspath_fragment are compared.
- //
- // The signature patterns file selects the subset of monolithic hidden API flags using a number
- // of patterns, i.e.:
- // * The qualified name (including package) of an outermost class, e.g. java/lang/Character.
- // This selects all the flags for all the members of this class and any nested classes.
- // * A package wildcard, e.g. java/lang/*. This selects all the flags for all the members of all
- // the classes in this package (but not in sub-packages).
- // * A recursive package wildcard, e.g. java/**. This selects all the flags for all the members
- // of all the classes in this package and sub-packages.
- //
- // The signature patterns file is constructed as follows:
- // * All the signatures are retrieved from the all-flags.csv file.
- // * The member and inner class names are removed.
- // * If a class is in a split package then that is kept, otherwise the class part is removed
- // and replaced with a wildcard, i.e. *.
- // * If a package matches a package prefix then the package is removed.
- // * All the package prefixes are added with a recursive wildcard appended to each, i.e. **.
- // * The resulting patterns are sorted.
- //
- // So, by default (i.e. without specifying any package_prefixes or split_packages) the signature
- // patterns is a list of class names, because there are no package packages and all packages are
- // assumed to be split.
- //
- // If any split packages are specified then only those packages are treated as split and all
- // other packages are treated as belonging solely to the bootclasspath_fragment and so they use
- // wildcard package patterns.
- //
- // So, if an empty list of split packages is specified then the signature patterns file just
- // includes a wildcard package pattern for every package provided by the bootclasspath_fragment.
- //
- // If split_packages are specified and a package that is split is not listed then it could lead
- // to build failures as it will select monolithic flags that are generated by another
- // bootclasspath_fragment to compare against the flags provided by this fragment. The latter
- // will obviously not contain those flags and that can cause the comparison and build to fail.
- //
- // If any package prefixes are specified then any matching packages are removed from the
- // signature patterns and replaced with a single recursive package pattern.
- //
- // It is not strictly necessary to specify either package_prefixes or split_packages as the
- // defaults will produce a valid set of signature patterns. However, those patterns may include
- // implementation details, e.g. names of implementation classes or packages, which will be
- // exported to the sdk snapshot in the signature patterns file. That is something that should be
- // avoided where possible. Specifying package_prefixes and split_packages allows those
- // implementation details to be excluded from the snapshot.
- Split_packages []string
- }
- }
- type SourceOnlyBootclasspathProperties struct {
- HiddenApiPackageProperties
- Coverage HiddenApiPackageProperties
- }
- type BootclasspathFragmentModule struct {
- android.ModuleBase
- android.ApexModuleBase
- android.SdkBase
- ClasspathFragmentBase
- // True if this fragment is for testing purposes.
- testFragment bool
- properties bootclasspathFragmentProperties
- sourceOnlyProperties SourceOnlyBootclasspathProperties
- // Collect the module directory for IDE info in java/jdeps.go.
- modulePaths []string
- // Installs for on-device boot image files. This list has entries only if the installs should be
- // handled by Make (e.g., the boot image should be installed on the system partition, rather than
- // in the APEX).
- bootImageDeviceInstalls []dexpreopterInstall
- }
- // commonBootclasspathFragment defines the methods that are implemented by both source and prebuilt
- // bootclasspath fragment modules.
- type commonBootclasspathFragment interface {
- // produceHiddenAPIOutput produces the all-flags.csv and intermediate files and encodes the flags
- // into dex files.
- //
- // Returns a *HiddenAPIOutput containing the paths for the generated files. Returns nil if the
- // module cannot contribute to hidden API processing, e.g. because it is a prebuilt module in a
- // versioned sdk.
- produceHiddenAPIOutput(ctx android.ModuleContext, contents []android.Module, input HiddenAPIFlagInput) *HiddenAPIOutput
- // produceBootImageFiles will attempt to produce rules to create the boot image files at the paths
- // predefined in the bootImageConfig.
- //
- // If it could not create the files then it will return nil. Otherwise, it will return a map from
- // android.ArchType to the predefined paths of the boot image files.
- produceBootImageFiles(ctx android.ModuleContext, imageConfig *bootImageConfig) bootImageFilesByArch
- }
- var _ commonBootclasspathFragment = (*BootclasspathFragmentModule)(nil)
- // bootImageFilesByArch is a map from android.ArchType to the paths to the boot image files.
- //
- // The paths include the .art, .oat and .vdex files, one for each of the modules from which the boot
- // image is created.
- type bootImageFilesByArch map[android.ArchType]android.Paths
- func bootclasspathFragmentFactory() android.Module {
- m := &BootclasspathFragmentModule{}
- m.AddProperties(&m.properties, &m.sourceOnlyProperties)
- android.InitApexModule(m)
- android.InitSdkAwareModule(m)
- initClasspathFragment(m, BOOTCLASSPATH)
- android.InitAndroidArchModule(m, android.DeviceSupported, android.MultilibCommon)
- android.AddLoadHook(m, func(ctx android.LoadHookContext) {
- // If code coverage has been enabled for the framework then append the properties with
- // coverage specific properties.
- if ctx.Config().IsEnvTrue("EMMA_INSTRUMENT_FRAMEWORK") {
- err := proptools.AppendProperties(&m.properties.BootclasspathFragmentCoverageAffectedProperties, &m.properties.Coverage, nil)
- if err != nil {
- ctx.PropertyErrorf("coverage", "error trying to append coverage specific properties: %s", err)
- return
- }
- err = proptools.AppendProperties(&m.sourceOnlyProperties.HiddenApiPackageProperties, &m.sourceOnlyProperties.Coverage, nil)
- if err != nil {
- ctx.PropertyErrorf("coverage", "error trying to append hidden api coverage specific properties: %s", err)
- return
- }
- }
- // Initialize the contents property from the image_name.
- bootclasspathFragmentInitContentsFromImage(ctx, m)
- })
- return m
- }
- func testBootclasspathFragmentFactory() android.Module {
- m := bootclasspathFragmentFactory().(*BootclasspathFragmentModule)
- m.testFragment = true
- return m
- }
- // bootclasspathFragmentInitContentsFromImage will initialize the contents property from the image_name if
- // necessary.
- func bootclasspathFragmentInitContentsFromImage(ctx android.EarlyModuleContext, m *BootclasspathFragmentModule) {
- contents := m.properties.Contents
- if len(contents) == 0 {
- ctx.PropertyErrorf("contents", "required property is missing")
- return
- }
- if m.properties.Image_name == nil {
- // Nothing to do.
- return
- }
- imageName := proptools.String(m.properties.Image_name)
- if imageName != "art" {
- ctx.PropertyErrorf("image_name", `unknown image name %q, expected "art"`, imageName)
- return
- }
- // TODO(b/177892522): Prebuilts (versioned or not) should not use the image_name property.
- if android.IsModuleInVersionedSdk(m) {
- // The module is a versioned prebuilt so ignore it. This is done for a couple of reasons:
- // 1. There is no way to use this at the moment so ignoring it is safe.
- // 2. Attempting to initialize the contents property from the configuration will end up having
- // the versioned prebuilt depending on the unversioned prebuilt. That will cause problems
- // as the unversioned prebuilt could end up with an APEX variant created for the source
- // APEX which will prevent it from having an APEX variant for the prebuilt APEX which in
- // turn will prevent it from accessing the dex implementation jar from that which will
- // break hidden API processing, amongst others.
- return
- }
- // Get the configuration for the art apex jars. Do not use getImageConfig(ctx) here as this is
- // too early in the Soong processing for that to work.
- global := dexpreopt.GetGlobalConfig(ctx)
- modules := global.ArtApexJars
- // Make sure that the apex specified in the configuration is consistent and is one for which
- // this boot image is available.
- commonApex := ""
- for i := 0; i < modules.Len(); i++ {
- apex := modules.Apex(i)
- jar := modules.Jar(i)
- if apex == "platform" {
- ctx.ModuleErrorf("ArtApexJars is invalid as it requests a platform variant of %q", jar)
- continue
- }
- if !m.AvailableFor(apex) {
- ctx.ModuleErrorf("ArtApexJars configuration incompatible with this module, ArtApexJars expects this to be in apex %q but this is only in apexes %q",
- apex, m.ApexAvailable())
- continue
- }
- if commonApex == "" {
- commonApex = apex
- } else if commonApex != apex {
- ctx.ModuleErrorf("ArtApexJars configuration is inconsistent, expected all jars to be in the same apex but it specifies apex %q and %q",
- commonApex, apex)
- }
- }
- }
- // bootclasspathImageNameContentsConsistencyCheck checks that the configuration that applies to this
- // module (if any) matches the contents.
- //
- // This should be a noop as if image_name="art" then the contents will be set from the ArtApexJars
- // config by bootclasspathFragmentInitContentsFromImage so it will be guaranteed to match. However,
- // in future this will not be the case.
- func (b *BootclasspathFragmentModule) bootclasspathImageNameContentsConsistencyCheck(ctx android.BaseModuleContext) {
- imageName := proptools.String(b.properties.Image_name)
- if imageName == "art" {
- // TODO(b/177892522): Prebuilts (versioned or not) should not use the image_name property.
- if android.IsModuleInVersionedSdk(b) {
- // The module is a versioned prebuilt so ignore it. This is done for a couple of reasons:
- // 1. There is no way to use this at the moment so ignoring it is safe.
- // 2. Attempting to initialize the contents property from the configuration will end up having
- // the versioned prebuilt depending on the unversioned prebuilt. That will cause problems
- // as the unversioned prebuilt could end up with an APEX variant created for the source
- // APEX which will prevent it from having an APEX variant for the prebuilt APEX which in
- // turn will prevent it from accessing the dex implementation jar from that which will
- // break hidden API processing, amongst others.
- return
- }
- // Get the configuration for the art apex jars.
- modules := b.getImageConfig(ctx).modules
- configuredJars := modules.CopyOfJars()
- // Skip the check if the configured jars list is empty as that is a common configuration when
- // building targets that do not result in a system image.
- if len(configuredJars) == 0 {
- return
- }
- contents := b.properties.Contents
- if !reflect.DeepEqual(configuredJars, contents) {
- ctx.ModuleErrorf("inconsistency in specification of contents. ArtApexJars configuration specifies %#v, contents property specifies %#v",
- configuredJars, contents)
- }
- }
- }
- var BootclasspathFragmentApexContentInfoProvider = blueprint.NewProvider(BootclasspathFragmentApexContentInfo{})
- // BootclasspathFragmentApexContentInfo contains the bootclasspath_fragments contributions to the
- // apex contents.
- type BootclasspathFragmentApexContentInfo struct {
- // The configured modules, will be empty if this is from a bootclasspath_fragment that does not
- // set image_name: "art".
- modules android.ConfiguredJarList
- // Map from arch type to the boot image files.
- bootImageFilesByArch bootImageFilesByArch
- // True if the boot image should be installed in the APEX.
- shouldInstallBootImageInApex bool
- // Map from the base module name (without prebuilt_ prefix) of a fragment's contents module to the
- // hidden API encoded dex jar path.
- contentModuleDexJarPaths bootDexJarByModule
- // Path to the image profile file on host (or empty, if profile is not generated).
- profilePathOnHost android.Path
- // Install path of the boot image profile if it needs to be installed in the APEX, or empty if not
- // needed.
- profileInstallPathInApex string
- }
- func (i BootclasspathFragmentApexContentInfo) Modules() android.ConfiguredJarList {
- return i.modules
- }
- // Get a map from ArchType to the associated boot image's contents for Android.
- //
- // Extension boot images only return their own files, not the files of the boot images they extend.
- func (i BootclasspathFragmentApexContentInfo) AndroidBootImageFilesByArchType() bootImageFilesByArch {
- return i.bootImageFilesByArch
- }
- // Return true if the boot image should be installed in the APEX.
- func (i *BootclasspathFragmentApexContentInfo) ShouldInstallBootImageInApex() bool {
- return i.shouldInstallBootImageInApex
- }
- // DexBootJarPathForContentModule returns the path to the dex boot jar for specified module.
- //
- // The dex boot jar is one which has had hidden API encoding performed on it.
- func (i BootclasspathFragmentApexContentInfo) DexBootJarPathForContentModule(module android.Module) (android.Path, error) {
- // A bootclasspath_fragment cannot use a prebuilt library so Name() will return the base name
- // without a prebuilt_ prefix so is safe to use as the key for the contentModuleDexJarPaths.
- name := module.Name()
- if dexJar, ok := i.contentModuleDexJarPaths[name]; ok {
- return dexJar, nil
- } else {
- return nil, fmt.Errorf("unknown bootclasspath_fragment content module %s, expected one of %s",
- name, strings.Join(android.SortedStringKeys(i.contentModuleDexJarPaths), ", "))
- }
- }
- func (i BootclasspathFragmentApexContentInfo) ProfilePathOnHost() android.Path {
- return i.profilePathOnHost
- }
- func (i BootclasspathFragmentApexContentInfo) ProfileInstallPathInApex() string {
- return i.profileInstallPathInApex
- }
- func (b *BootclasspathFragmentModule) DepIsInSameApex(ctx android.BaseModuleContext, dep android.Module) bool {
- tag := ctx.OtherModuleDependencyTag(dep)
- if IsBootclasspathFragmentContentDepTag(tag) {
- // Boot image contents are automatically added to apex.
- return true
- }
- if android.IsMetaDependencyTag(tag) {
- // Cross-cutting metadata dependencies are metadata.
- return false
- }
- panic(fmt.Errorf("boot_image module %q should not have a dependency on %q via tag %s", b, dep, android.PrettyPrintTag(tag)))
- }
- func (b *BootclasspathFragmentModule) ShouldSupportSdkVersion(ctx android.BaseModuleContext, sdkVersion android.ApiLevel) error {
- return nil
- }
- // ComponentDepsMutator adds dependencies onto modules before any prebuilt modules without a
- // corresponding source module are renamed. This means that adding a dependency using a name without
- // a prebuilt_ prefix will always resolve to a source module and when using a name with that prefix
- // it will always resolve to a prebuilt module.
- func (b *BootclasspathFragmentModule) ComponentDepsMutator(ctx android.BottomUpMutatorContext) {
- module := ctx.Module()
- _, isSourceModule := module.(*BootclasspathFragmentModule)
- for _, name := range b.properties.Contents {
- // A bootclasspath_fragment must depend only on other source modules, while the
- // prebuilt_bootclasspath_fragment must only depend on other prebuilt modules.
- //
- // TODO(b/177892522) - avoid special handling of jacocoagent.
- if !isSourceModule && name != "jacocoagent" {
- name = android.PrebuiltNameFromSource(name)
- }
- ctx.AddDependency(module, bootclasspathFragmentContentDepTag, name)
- }
- }
- func (b *BootclasspathFragmentModule) DepsMutator(ctx android.BottomUpMutatorContext) {
- // Add dependencies onto all the modules that provide the API stubs for classes on this
- // bootclasspath fragment.
- hiddenAPIAddStubLibDependencies(ctx, b.properties.apiScopeToStubLibs())
- for _, additionalStubModule := range b.properties.Additional_stubs {
- for _, apiScope := range hiddenAPISdkLibrarySupportedScopes {
- // Add a dependency onto a possibly scope specific stub library.
- scopeSpecificDependency := apiScope.scopeSpecificStubModule(ctx, additionalStubModule)
- tag := hiddenAPIStubsDependencyTag{apiScope: apiScope, fromAdditionalDependency: true}
- ctx.AddVariationDependencies(nil, tag, scopeSpecificDependency)
- }
- }
- if SkipDexpreoptBootJars(ctx) {
- return
- }
- // Add a dependency onto the dex2oat tool which is needed for creating the boot image. The
- // path is retrieved from the dependency by GetGlobalSoongConfig(ctx).
- dexpreopt.RegisterToolDeps(ctx)
- }
- func (b *BootclasspathFragmentModule) BootclasspathDepsMutator(ctx android.BottomUpMutatorContext) {
- // Add dependencies on all the fragments.
- b.properties.BootclasspathFragmentsDepsProperties.addDependenciesOntoFragments(ctx)
- }
- func (b *BootclasspathFragmentModule) GenerateAndroidBuildActions(ctx android.ModuleContext) {
- // Only perform a consistency check if this module is the active module. That will prevent an
- // unused prebuilt that was created without instrumentation from breaking an instrumentation
- // build.
- if isActiveModule(ctx.Module()) {
- b.bootclasspathImageNameContentsConsistencyCheck(ctx)
- }
- // Generate classpaths.proto config
- b.generateClasspathProtoBuildActions(ctx)
- // Collect the module directory for IDE info in java/jdeps.go.
- b.modulePaths = append(b.modulePaths, ctx.ModuleDir())
- // Gather the bootclasspath fragment's contents.
- var contents []android.Module
- ctx.VisitDirectDeps(func(module android.Module) {
- tag := ctx.OtherModuleDependencyTag(module)
- if IsBootclasspathFragmentContentDepTag(tag) {
- contents = append(contents, module)
- }
- })
- fragments := gatherApexModulePairDepsWithTag(ctx, bootclasspathFragmentDepTag)
- // Verify that the image_name specified on a bootclasspath_fragment is valid even if this is a
- // prebuilt which will not use the image config.
- imageConfig := b.getImageConfig(ctx)
- // A versioned prebuilt_bootclasspath_fragment cannot and does not need to perform hidden API
- // processing. It cannot do it because it is not part of a prebuilt_apex and so has no access to
- // the correct dex implementation jar. It does not need to because the platform-bootclasspath
- // always references the latest bootclasspath_fragments.
- if !android.IsModuleInVersionedSdk(ctx.Module()) {
- // Perform hidden API processing.
- hiddenAPIOutput := b.generateHiddenAPIBuildActions(ctx, contents, fragments)
- var bootImageFilesByArch bootImageFilesByArch
- if imageConfig != nil {
- // Delegate the production of the boot image files to a module type specific method.
- common := ctx.Module().(commonBootclasspathFragment)
- bootImageFilesByArch = common.produceBootImageFiles(ctx, imageConfig)
- if shouldCopyBootFilesToPredefinedLocations(ctx, imageConfig) {
- // Zip the boot image files up, if available. This will generate the zip file in a
- // predefined location.
- buildBootImageZipInPredefinedLocation(ctx, imageConfig, bootImageFilesByArch)
- // Copy the dex jars of this fragment's content modules to their predefined locations.
- copyBootJarsToPredefinedLocations(ctx, hiddenAPIOutput.EncodedBootDexFilesByModule, imageConfig.dexPathsByModule)
- }
- for _, variant := range imageConfig.apexVariants() {
- arch := variant.target.Arch.ArchType.String()
- for _, install := range variant.deviceInstalls {
- // Remove the "/" prefix because the path should be relative to $ANDROID_PRODUCT_OUT.
- installDir := strings.TrimPrefix(filepath.Dir(install.To), "/")
- installBase := filepath.Base(install.To)
- installPath := android.PathForModuleInPartitionInstall(ctx, "", installDir)
- b.bootImageDeviceInstalls = append(b.bootImageDeviceInstalls, dexpreopterInstall{
- name: arch + "-" + installBase,
- moduleName: b.Name(),
- outputPathOnHost: install.From,
- installDirOnDevice: installPath,
- installFileOnDevice: installBase,
- })
- }
- }
- }
- // A prebuilt fragment cannot contribute to an apex.
- if !android.IsModulePrebuilt(ctx.Module()) {
- // Provide the apex content info.
- b.provideApexContentInfo(ctx, imageConfig, hiddenAPIOutput, bootImageFilesByArch)
- }
- } else {
- // Versioned fragments are not needed by make.
- b.HideFromMake()
- }
- // In order for information about bootclasspath_fragment modules to be added to module-info.json
- // it is necessary to output an entry to Make. As bootclasspath_fragment modules are part of an
- // APEX there can be multiple variants, including the default/platform variant and only one can
- // be output to Make but it does not really matter which variant is output. The default/platform
- // variant is the first (ctx.PrimaryModule()) and is usually hidden from make so this just picks
- // the last variant (ctx.FinalModule()).
- if ctx.Module() != ctx.FinalModule() {
- b.HideFromMake()
- }
- }
- // shouldCopyBootFilesToPredefinedLocations determines whether the current module should copy boot
- // files, e.g. boot dex jars or boot image files, to the predefined location expected by the rest
- // of the build.
- //
- // This ensures that only a single module will copy its files to the image configuration.
- func shouldCopyBootFilesToPredefinedLocations(ctx android.ModuleContext, imageConfig *bootImageConfig) bool {
- // Bootclasspath fragment modules that are for the platform do not produce boot related files.
- apexInfo := ctx.Provider(android.ApexInfoProvider).(android.ApexInfo)
- if apexInfo.IsForPlatform() {
- return false
- }
- // If the image configuration has no modules specified then it means that the build has been
- // configured to build something other than a boot image, e.g. an sdk, so do not try and copy the
- // files.
- if imageConfig.modules.Len() == 0 {
- return false
- }
- // Only copy files from the module that is preferred.
- return isActiveModule(ctx.Module())
- }
- // provideApexContentInfo creates, initializes and stores the apex content info for use by other
- // modules.
- func (b *BootclasspathFragmentModule) provideApexContentInfo(ctx android.ModuleContext, imageConfig *bootImageConfig, hiddenAPIOutput *HiddenAPIOutput, bootImageFilesByArch bootImageFilesByArch) {
- // Construct the apex content info from the config.
- info := BootclasspathFragmentApexContentInfo{
- // Populate the apex content info with paths to the dex jars.
- contentModuleDexJarPaths: hiddenAPIOutput.EncodedBootDexFilesByModule,
- }
- if imageConfig != nil {
- info.modules = imageConfig.modules
- global := dexpreopt.GetGlobalConfig(ctx)
- if !global.DisableGenerateProfile {
- info.profilePathOnHost = imageConfig.profilePathOnHost
- info.profileInstallPathInApex = imageConfig.profileInstallPathInApex
- }
- info.shouldInstallBootImageInApex = imageConfig.shouldInstallInApex()
- }
- info.bootImageFilesByArch = bootImageFilesByArch
- // Make the apex content info available for other modules.
- ctx.SetProvider(BootclasspathFragmentApexContentInfoProvider, info)
- }
- // generateClasspathProtoBuildActions generates all required build actions for classpath.proto config
- func (b *BootclasspathFragmentModule) generateClasspathProtoBuildActions(ctx android.ModuleContext) {
- var classpathJars []classpathJar
- configuredJars := b.configuredJars(ctx)
- if "art" == proptools.String(b.properties.Image_name) {
- // ART and platform boot jars must have a corresponding entry in DEX2OATBOOTCLASSPATH
- classpathJars = configuredJarListToClasspathJars(ctx, configuredJars, BOOTCLASSPATH, DEX2OATBOOTCLASSPATH)
- } else {
- classpathJars = configuredJarListToClasspathJars(ctx, configuredJars, b.classpathType)
- }
- b.classpathFragmentBase().generateClasspathProtoBuildActions(ctx, configuredJars, classpathJars)
- }
- func (b *BootclasspathFragmentModule) configuredJars(ctx android.ModuleContext) android.ConfiguredJarList {
- if "art" == proptools.String(b.properties.Image_name) {
- return b.getImageConfig(ctx).modules
- }
- global := dexpreopt.GetGlobalConfig(ctx)
- possibleUpdatableModules := gatherPossibleApexModuleNamesAndStems(ctx, b.properties.Contents, bootclasspathFragmentContentDepTag)
- jars, unknown := global.ApexBootJars.Filter(possibleUpdatableModules)
- // TODO(satayev): for apex_test we want to include all contents unconditionally to classpaths
- // config. However, any test specific jars would not be present in ApexBootJars. Instead,
- // we should check if we are creating a config for apex_test via ApexInfo and amend the values.
- // This is an exception to support end-to-end test for SdkExtensions, until such support exists.
- if android.InList("test_framework-sdkextensions", possibleUpdatableModules) {
- jars = jars.Append("com.android.sdkext", "test_framework-sdkextensions")
- } else if android.InList("AddNewActivity", possibleUpdatableModules) {
- jars = jars.Append("test_com.android.cts.frameworkresapkplits", "AddNewActivity")
- } else if android.InList("test_framework-apexd", possibleUpdatableModules) {
- jars = jars.Append("com.android.apex.test_package", "test_framework-apexd")
- } else if global.ApexBootJars.Len() != 0 && !android.IsModuleInVersionedSdk(ctx.Module()) {
- unknown = android.RemoveListFromList(unknown, b.properties.Coverage.Contents)
- _, unknown = android.RemoveFromList("core-icu4j", unknown)
- if len(unknown) > 0 {
- ctx.ModuleErrorf("%s in contents must also be declared in PRODUCT_APEX_BOOT_JARS", unknown)
- }
- }
- return jars
- }
- func (b *BootclasspathFragmentModule) getImageConfig(ctx android.EarlyModuleContext) *bootImageConfig {
- // Get a map of the image configs that are supported.
- imageConfigs := genBootImageConfigs(ctx)
- // Retrieve the config for this image.
- imageNamePtr := b.properties.Image_name
- if imageNamePtr == nil {
- return nil
- }
- imageName := *imageNamePtr
- imageConfig := imageConfigs[imageName]
- if imageConfig == nil {
- ctx.PropertyErrorf("image_name", "Unknown image name %q, expected one of %s", imageName, strings.Join(android.SortedStringKeys(imageConfigs), ", "))
- return nil
- }
- return imageConfig
- }
- // generateHiddenAPIBuildActions generates all the hidden API related build rules.
- func (b *BootclasspathFragmentModule) generateHiddenAPIBuildActions(ctx android.ModuleContext, contents []android.Module, fragments []android.Module) *HiddenAPIOutput {
- // Create hidden API input structure.
- input := b.createHiddenAPIFlagInput(ctx, contents, fragments)
- // Delegate the production of the hidden API all-flags.csv file to a module type specific method.
- common := ctx.Module().(commonBootclasspathFragment)
- output := common.produceHiddenAPIOutput(ctx, contents, input)
- // If the source or prebuilts module does not provide a signature patterns file then generate one
- // from the flags.
- // TODO(b/192868581): Remove once the source and prebuilts provide a signature patterns file of
- // their own.
- if output.SignaturePatternsPath == nil {
- output.SignaturePatternsPath = buildRuleSignaturePatternsFile(
- ctx, output.AllFlagsPath, []string{"*"}, nil, nil)
- }
- // Initialize a HiddenAPIInfo structure.
- hiddenAPIInfo := HiddenAPIInfo{
- // The monolithic hidden API processing needs access to the flag files that override the default
- // flags from all the fragments whether or not they actually perform their own hidden API flag
- // generation. That is because the monolithic hidden API processing uses those flag files to
- // perform its own flag generation.
- FlagFilesByCategory: input.FlagFilesByCategory,
- // Other bootclasspath_fragments that depend on this need the transitive set of stub dex jars
- // from this to resolve any references from their code to classes provided by this fragment
- // and the fragments this depends upon.
- TransitiveStubDexJarsByScope: input.transitiveStubDexJarsByScope(),
- }
- // The monolithic hidden API processing also needs access to all the output files produced by
- // hidden API processing of this fragment.
- hiddenAPIInfo.HiddenAPIFlagOutput = output.HiddenAPIFlagOutput
- // Provide it for use by other modules.
- ctx.SetProvider(HiddenAPIInfoProvider, hiddenAPIInfo)
- return output
- }
- // retrieveLegacyEncodedBootDexFiles attempts to retrieve the legacy encoded boot dex jar files.
- func retrieveLegacyEncodedBootDexFiles(ctx android.ModuleContext, contents []android.Module) bootDexJarByModule {
- // If the current bootclasspath_fragment is the active module or a source module then retrieve the
- // encoded dex files, otherwise return an empty map.
- //
- // An inactive (i.e. not preferred) bootclasspath_fragment needs to retrieve the encoded dex jars
- // as they are still needed by an apex. An inactive prebuilt_bootclasspath_fragment does not need
- // to do so and may not yet have access to dex boot jars from a prebuilt_apex/apex_set.
- if isActiveModule(ctx.Module()) || !android.IsModulePrebuilt(ctx.Module()) {
- return extractEncodedDexJarsFromModules(ctx, contents)
- } else {
- return nil
- }
- }
- // createHiddenAPIFlagInput creates a HiddenAPIFlagInput struct and initializes it with information derived
- // from the properties on this module and its dependencies.
- func (b *BootclasspathFragmentModule) createHiddenAPIFlagInput(ctx android.ModuleContext, contents []android.Module, fragments []android.Module) HiddenAPIFlagInput {
- // Merge the HiddenAPIInfo from all the fragment dependencies.
- dependencyHiddenApiInfo := newHiddenAPIInfo()
- dependencyHiddenApiInfo.mergeFromFragmentDeps(ctx, fragments)
- // Create hidden API flag input structure.
- input := newHiddenAPIFlagInput()
- // Update the input structure with information obtained from the stub libraries.
- input.gatherStubLibInfo(ctx, contents)
- // Populate with flag file paths from the properties.
- input.extractFlagFilesFromProperties(ctx, &b.properties.Hidden_api)
- // Add the stub dex jars from this module's fragment dependencies.
- input.DependencyStubDexJarsByScope.addStubDexJarsByModule(dependencyHiddenApiInfo.TransitiveStubDexJarsByScope)
- return input
- }
- // isTestFragment returns true if the current module is a test bootclasspath_fragment.
- func (b *BootclasspathFragmentModule) isTestFragment() bool {
- if b.testFragment {
- return true
- }
- // TODO(b/194063708): Once test fragments all use bootclasspath_fragment_test
- // Some temporary exceptions until all test fragments use the
- // bootclasspath_fragment_test module type.
- name := b.BaseModuleName()
- if strings.HasPrefix(name, "test_") {
- return true
- }
- if name == "apex.apexd_test_bootclasspath-fragment" {
- return true
- }
- return false
- }
- // produceHiddenAPIOutput produces the hidden API all-flags.csv file (and supporting files)
- // for the fragment as well as encoding the flags in the boot dex jars.
- func (b *BootclasspathFragmentModule) produceHiddenAPIOutput(ctx android.ModuleContext, contents []android.Module, input HiddenAPIFlagInput) *HiddenAPIOutput {
- // Generate the rules to create the hidden API flags and update the supplied hiddenAPIInfo with the
- // paths to the created files.
- output := hiddenAPIRulesForBootclasspathFragment(ctx, contents, input)
- // If the module specifies split_packages or package_prefixes then use those to generate the
- // signature patterns.
- splitPackages := b.sourceOnlyProperties.Hidden_api.Split_packages
- packagePrefixes := b.sourceOnlyProperties.Hidden_api.Package_prefixes
- singlePackages := b.sourceOnlyProperties.Hidden_api.Single_packages
- if splitPackages != nil || packagePrefixes != nil || singlePackages != nil {
- output.SignaturePatternsPath = buildRuleSignaturePatternsFile(
- ctx, output.AllFlagsPath, splitPackages, packagePrefixes, singlePackages)
- } else if !b.isTestFragment() {
- ctx.ModuleErrorf(`Must specify at least one of the split_packages, package_prefixes and single_packages properties
- If this is a new bootclasspath_fragment or you are unsure what to do add the
- the following to the bootclasspath_fragment:
- hidden_api: {split_packages: ["*"]},
- and then run the following:
- m analyze_bcpf && analyze_bcpf --bcpf %q
- it will analyze the bootclasspath_fragment and provide hints as to what you
- should specify here. If you are happy with its suggestions then you can add
- the --fix option and it will fix them for you.`, b.BaseModuleName())
- }
- return output
- }
- // produceBootImageFiles builds the boot image files from the source if it is required.
- func (b *BootclasspathFragmentModule) produceBootImageFiles(ctx android.ModuleContext, imageConfig *bootImageConfig) bootImageFilesByArch {
- if SkipDexpreoptBootJars(ctx) {
- return nil
- }
- // Only generate the boot image if the configuration does not skip it.
- return b.generateBootImageBuildActions(ctx, imageConfig)
- }
- // generateBootImageBuildActions generates ninja rules to create the boot image if required for this
- // module.
- //
- // If it could not create the files then it will return nil. Otherwise, it will return a map from
- // android.ArchType to the predefined paths of the boot image files.
- func (b *BootclasspathFragmentModule) generateBootImageBuildActions(ctx android.ModuleContext, imageConfig *bootImageConfig) bootImageFilesByArch {
- global := dexpreopt.GetGlobalConfig(ctx)
- if !shouldBuildBootImages(ctx.Config(), global) {
- return nil
- }
- // Bootclasspath fragment modules that are for the platform do not produce a boot image.
- apexInfo := ctx.Provider(android.ApexInfoProvider).(android.ApexInfo)
- if apexInfo.IsForPlatform() {
- return nil
- }
- // Bootclasspath fragment modules that are versioned do not produce a boot image.
- if android.IsModuleInVersionedSdk(ctx.Module()) {
- return nil
- }
- // Build a profile for the image config and then use that to build the boot image.
- profile := bootImageProfileRule(ctx, imageConfig)
- // Build boot image files for the host variants.
- buildBootImageVariantsForBuildOs(ctx, imageConfig, profile)
- // Build boot image files for the android variants.
- androidBootImageFilesByArch := buildBootImageVariantsForAndroidOs(ctx, imageConfig, profile)
- // Return the boot image files for the android variants for inclusion in an APEX and to be zipped
- // up for the dist.
- return androidBootImageFilesByArch
- }
- func (b *BootclasspathFragmentModule) AndroidMkEntries() []android.AndroidMkEntries {
- // Use the generated classpath proto as the output.
- outputFile := b.outputFilepath
- // Create a fake entry that will cause this to be added to the module-info.json file.
- entriesList := []android.AndroidMkEntries{{
- Class: "FAKE",
- OutputFile: android.OptionalPathForPath(outputFile),
- Include: "$(BUILD_PHONY_PACKAGE)",
- ExtraFooters: []android.AndroidMkExtraFootersFunc{
- func(w io.Writer, name, prefix, moduleDir string) {
- // Allow the bootclasspath_fragment to be built by simply passing its name on the command
- // line.
- fmt.Fprintln(w, ".PHONY:", b.Name())
- fmt.Fprintln(w, b.Name()+":", outputFile.String())
- },
- },
- }}
- for _, install := range b.bootImageDeviceInstalls {
- entriesList = append(entriesList, install.ToMakeEntries())
- }
- return entriesList
- }
- // Returns the names of all Make modules that handle the installation of the boot image.
- func (b *BootclasspathFragmentModule) BootImageDeviceInstallMakeModules() []string {
- var makeModules []string
- for _, install := range b.bootImageDeviceInstalls {
- makeModules = append(makeModules, install.FullModuleName())
- }
- return makeModules
- }
- // Collect information for opening IDE project files in java/jdeps.go.
- func (b *BootclasspathFragmentModule) IDEInfo(dpInfo *android.IdeInfo) {
- dpInfo.Deps = append(dpInfo.Deps, b.properties.Contents...)
- dpInfo.Paths = append(dpInfo.Paths, b.modulePaths...)
- }
- type bootclasspathFragmentMemberType struct {
- android.SdkMemberTypeBase
- }
- func (b *bootclasspathFragmentMemberType) AddDependencies(ctx android.SdkDependencyContext, dependencyTag blueprint.DependencyTag, names []string) {
- ctx.AddVariationDependencies(nil, dependencyTag, names...)
- }
- func (b *bootclasspathFragmentMemberType) IsInstance(module android.Module) bool {
- _, ok := module.(*BootclasspathFragmentModule)
- return ok
- }
- func (b *bootclasspathFragmentMemberType) AddPrebuiltModule(ctx android.SdkMemberContext, member android.SdkMember) android.BpModule {
- if b.PropertyName == "boot_images" {
- return ctx.SnapshotBuilder().AddPrebuiltModule(member, "prebuilt_boot_image")
- } else {
- return ctx.SnapshotBuilder().AddPrebuiltModule(member, "prebuilt_bootclasspath_fragment")
- }
- }
- func (b *bootclasspathFragmentMemberType) CreateVariantPropertiesStruct() android.SdkMemberProperties {
- return &bootclasspathFragmentSdkMemberProperties{}
- }
- type bootclasspathFragmentSdkMemberProperties struct {
- android.SdkMemberPropertiesBase
- // The image name
- Image_name *string
- // Contents of the bootclasspath fragment
- Contents []string
- // Stub_libs properties.
- Stub_libs []string
- Core_platform_stub_libs []string
- // Fragment properties
- Fragments []ApexVariantReference
- // Flag files by *hiddenAPIFlagFileCategory
- Flag_files_by_category FlagFilesByCategory
- // The path to the generated annotation-flags.csv file.
- Annotation_flags_path android.OptionalPath
- // The path to the generated metadata.csv file.
- Metadata_path android.OptionalPath
- // The path to the generated index.csv file.
- Index_path android.OptionalPath
- // The path to the generated stub-flags.csv file.
- Stub_flags_path android.OptionalPath `supported_build_releases:"S"`
- // The path to the generated all-flags.csv file.
- All_flags_path android.OptionalPath `supported_build_releases:"S"`
- // The path to the generated signature-patterns.csv file.
- Signature_patterns_path android.OptionalPath `supported_build_releases:"Tiramisu+"`
- // The path to the generated filtered-stub-flags.csv file.
- Filtered_stub_flags_path android.OptionalPath `supported_build_releases:"Tiramisu+"`
- // The path to the generated filtered-flags.csv file.
- Filtered_flags_path android.OptionalPath `supported_build_releases:"Tiramisu+"`
- }
- func (b *bootclasspathFragmentSdkMemberProperties) PopulateFromVariant(ctx android.SdkMemberContext, variant android.Module) {
- module := variant.(*BootclasspathFragmentModule)
- b.Image_name = module.properties.Image_name
- b.Contents = module.properties.Contents
- // Get the hidden API information from the module.
- mctx := ctx.SdkModuleContext()
- hiddenAPIInfo := mctx.OtherModuleProvider(module, HiddenAPIInfoProvider).(HiddenAPIInfo)
- b.Flag_files_by_category = hiddenAPIInfo.FlagFilesByCategory
- // Copy all the generated file paths.
- b.Annotation_flags_path = android.OptionalPathForPath(hiddenAPIInfo.AnnotationFlagsPath)
- b.Metadata_path = android.OptionalPathForPath(hiddenAPIInfo.MetadataPath)
- b.Index_path = android.OptionalPathForPath(hiddenAPIInfo.IndexPath)
- b.Stub_flags_path = android.OptionalPathForPath(hiddenAPIInfo.StubFlagsPath)
- b.All_flags_path = android.OptionalPathForPath(hiddenAPIInfo.AllFlagsPath)
- b.Signature_patterns_path = android.OptionalPathForPath(hiddenAPIInfo.SignaturePatternsPath)
- b.Filtered_stub_flags_path = android.OptionalPathForPath(hiddenAPIInfo.FilteredStubFlagsPath)
- b.Filtered_flags_path = android.OptionalPathForPath(hiddenAPIInfo.FilteredFlagsPath)
- // Copy stub_libs properties.
- b.Stub_libs = module.properties.Api.Stub_libs
- b.Core_platform_stub_libs = module.properties.Core_platform_api.Stub_libs
- // Copy fragment properties.
- b.Fragments = module.properties.Fragments
- }
- func (b *bootclasspathFragmentSdkMemberProperties) AddToPropertySet(ctx android.SdkMemberContext, propertySet android.BpPropertySet) {
- if b.Image_name != nil {
- propertySet.AddProperty("image_name", *b.Image_name)
- }
- builder := ctx.SnapshotBuilder()
- requiredMemberDependency := builder.SdkMemberReferencePropertyTag(true)
- if len(b.Contents) > 0 {
- propertySet.AddPropertyWithTag("contents", b.Contents, requiredMemberDependency)
- }
- if len(b.Stub_libs) > 0 {
- apiPropertySet := propertySet.AddPropertySet("api")
- apiPropertySet.AddPropertyWithTag("stub_libs", b.Stub_libs, requiredMemberDependency)
- }
- if len(b.Core_platform_stub_libs) > 0 {
- corePlatformApiPropertySet := propertySet.AddPropertySet("core_platform_api")
- corePlatformApiPropertySet.AddPropertyWithTag("stub_libs", b.Core_platform_stub_libs, requiredMemberDependency)
- }
- if len(b.Fragments) > 0 {
- propertySet.AddProperty("fragments", b.Fragments)
- }
- hiddenAPISet := propertySet.AddPropertySet("hidden_api")
- hiddenAPIDir := "hiddenapi"
- // Copy manually curated flag files specified on the bootclasspath_fragment.
- if b.Flag_files_by_category != nil {
- for _, category := range HiddenAPIFlagFileCategories {
- paths := b.Flag_files_by_category[category]
- if len(paths) > 0 {
- dests := []string{}
- for _, p := range paths {
- dest := filepath.Join(hiddenAPIDir, p.Base())
- builder.CopyToSnapshot(p, dest)
- dests = append(dests, dest)
- }
- hiddenAPISet.AddProperty(category.PropertyName, dests)
- }
- }
- }
- copyOptionalPath := func(path android.OptionalPath, property string) {
- if path.Valid() {
- p := path.Path()
- dest := filepath.Join(hiddenAPIDir, p.Base())
- builder.CopyToSnapshot(p, dest)
- hiddenAPISet.AddProperty(property, dest)
- }
- }
- // Copy all the generated files, if available.
- copyOptionalPath(b.Annotation_flags_path, "annotation_flags")
- copyOptionalPath(b.Metadata_path, "metadata")
- copyOptionalPath(b.Index_path, "index")
- copyOptionalPath(b.Stub_flags_path, "stub_flags")
- copyOptionalPath(b.All_flags_path, "all_flags")
- copyOptionalPath(b.Signature_patterns_path, "signature_patterns")
- copyOptionalPath(b.Filtered_stub_flags_path, "filtered_stub_flags")
- copyOptionalPath(b.Filtered_flags_path, "filtered_flags")
- }
- var _ android.SdkMemberType = (*bootclasspathFragmentMemberType)(nil)
- // prebuiltBootclasspathFragmentProperties contains additional prebuilt_bootclasspath_fragment
- // specific properties.
- type prebuiltBootclasspathFragmentProperties struct {
- Hidden_api struct {
- // The path to the annotation-flags.csv file created by the bootclasspath_fragment.
- Annotation_flags *string `android:"path"`
- // The path to the metadata.csv file created by the bootclasspath_fragment.
- Metadata *string `android:"path"`
- // The path to the index.csv file created by the bootclasspath_fragment.
- Index *string `android:"path"`
- // The path to the signature-patterns.csv file created by the bootclasspath_fragment.
- Signature_patterns *string `android:"path"`
- // The path to the stub-flags.csv file created by the bootclasspath_fragment.
- Stub_flags *string `android:"path"`
- // The path to the all-flags.csv file created by the bootclasspath_fragment.
- All_flags *string `android:"path"`
- // The path to the filtered-stub-flags.csv file created by the bootclasspath_fragment.
- Filtered_stub_flags *string `android:"path"`
- // The path to the filtered-flags.csv file created by the bootclasspath_fragment.
- Filtered_flags *string `android:"path"`
- }
- }
- // A prebuilt version of the bootclasspath_fragment module.
- //
- // At the moment this is basically just a bootclasspath_fragment module that can be used as a
- // prebuilt. Eventually as more functionality is migrated into the bootclasspath_fragment module
- // type from the various singletons then this will diverge.
- type PrebuiltBootclasspathFragmentModule struct {
- BootclasspathFragmentModule
- prebuilt android.Prebuilt
- // Additional prebuilt specific properties.
- prebuiltProperties prebuiltBootclasspathFragmentProperties
- }
- func (module *PrebuiltBootclasspathFragmentModule) Prebuilt() *android.Prebuilt {
- return &module.prebuilt
- }
- func (module *PrebuiltBootclasspathFragmentModule) Name() string {
- return module.prebuilt.Name(module.ModuleBase.Name())
- }
- // produceHiddenAPIOutput returns a path to the prebuilt all-flags.csv or nil if none is specified.
- func (module *PrebuiltBootclasspathFragmentModule) produceHiddenAPIOutput(ctx android.ModuleContext, contents []android.Module, input HiddenAPIFlagInput) *HiddenAPIOutput {
- pathForOptionalSrc := func(src *string, defaultPath android.Path) android.Path {
- if src == nil {
- return defaultPath
- }
- return android.PathForModuleSrc(ctx, *src)
- }
- pathForSrc := func(property string, src *string) android.Path {
- if src == nil {
- ctx.PropertyErrorf(property, "is required but was not specified")
- return android.PathForModuleSrc(ctx, "missing", property)
- }
- return android.PathForModuleSrc(ctx, *src)
- }
- // Retrieve the dex files directly from the content modules. They in turn should retrieve the
- // encoded dex jars from the prebuilt .apex files.
- encodedBootDexJarsByModule := extractEncodedDexJarsFromModules(ctx, contents)
- output := HiddenAPIOutput{
- HiddenAPIFlagOutput: HiddenAPIFlagOutput{
- AnnotationFlagsPath: pathForSrc("hidden_api.annotation_flags", module.prebuiltProperties.Hidden_api.Annotation_flags),
- MetadataPath: pathForSrc("hidden_api.metadata", module.prebuiltProperties.Hidden_api.Metadata),
- IndexPath: pathForSrc("hidden_api.index", module.prebuiltProperties.Hidden_api.Index),
- SignaturePatternsPath: pathForOptionalSrc(module.prebuiltProperties.Hidden_api.Signature_patterns, nil),
- // TODO: Temporarily handle stub_flags/all_flags properties until prebuilts have been updated.
- StubFlagsPath: pathForOptionalSrc(module.prebuiltProperties.Hidden_api.Stub_flags, nil),
- AllFlagsPath: pathForOptionalSrc(module.prebuiltProperties.Hidden_api.All_flags, nil),
- },
- EncodedBootDexFilesByModule: encodedBootDexJarsByModule,
- }
- // TODO: Temporarily fallback to stub_flags/all_flags properties until prebuilts have been updated.
- output.FilteredStubFlagsPath = pathForOptionalSrc(module.prebuiltProperties.Hidden_api.Filtered_stub_flags, output.StubFlagsPath)
- output.FilteredFlagsPath = pathForOptionalSrc(module.prebuiltProperties.Hidden_api.Filtered_flags, output.AllFlagsPath)
- return &output
- }
- // produceBootImageFiles extracts the boot image files from the APEX if available.
- func (module *PrebuiltBootclasspathFragmentModule) produceBootImageFiles(ctx android.ModuleContext, imageConfig *bootImageConfig) bootImageFilesByArch {
- if !shouldCopyBootFilesToPredefinedLocations(ctx, imageConfig) {
- return nil
- }
- di := android.FindDeapexerProviderForModule(ctx)
- if di == nil {
- return nil // An error has been reported by FindDeapexerProviderForModule.
- }
- profile := (android.WritablePath)(nil)
- if imageConfig.profileInstallPathInApex != "" {
- profile = di.PrebuiltExportPath(imageConfig.profileInstallPathInApex)
- }
- // Build the boot image files for the host variants. These are always built from the dex files
- // provided by the contents of this module as prebuilt versions of the host boot image files are
- // not available, i.e. there is no host specific prebuilt apex containing them. This has to be
- // built without a profile as the prebuilt modules do not provide a profile.
- buildBootImageVariantsForBuildOs(ctx, imageConfig, profile)
- if imageConfig.shouldInstallInApex() {
- // If the boot image files for the android variants are in the prebuilt apex, we must use those
- // rather than building new ones because those boot image files are going to be used on device.
- files := bootImageFilesByArch{}
- for _, variant := range imageConfig.apexVariants() {
- arch := variant.target.Arch.ArchType
- for _, toPath := range variant.imagesDeps {
- apexRelativePath := apexRootRelativePathToBootImageFile(arch, toPath.Base())
- // Get the path to the file that the deapexer extracted from the prebuilt apex file.
- fromPath := di.PrebuiltExportPath(apexRelativePath)
- // Return the toPath as the calling code expects the paths in the returned map to be the
- // paths predefined in the bootImageConfig.
- files[arch] = append(files[arch], toPath)
- // Copy the file to the predefined location.
- ctx.Build(pctx, android.BuildParams{
- Rule: android.Cp,
- Input: fromPath,
- Output: toPath,
- })
- }
- }
- return files
- } else {
- if profile == nil {
- ctx.ModuleErrorf("Unable to produce boot image files: neither boot image files nor profiles exists in the prebuilt apex")
- return nil
- }
- // Build boot image files for the android variants from the dex files provided by the contents
- // of this module.
- return buildBootImageVariantsForAndroidOs(ctx, imageConfig, profile)
- }
- }
- var _ commonBootclasspathFragment = (*PrebuiltBootclasspathFragmentModule)(nil)
- // createBootImageTag creates the tag to uniquely identify the boot image file among all of the
- // files that a module requires from the prebuilt .apex file.
- func createBootImageTag(arch android.ArchType, baseName string) string {
- tag := fmt.Sprintf(".bootimage-%s-%s", arch, baseName)
- return tag
- }
- // RequiredFilesFromPrebuiltApex returns the list of all files the prebuilt_bootclasspath_fragment
- // requires from a prebuilt .apex file.
- //
- // If there is no image config associated with this fragment then it returns nil. Otherwise, it
- // returns the files that are listed in the image config.
- func (module *PrebuiltBootclasspathFragmentModule) RequiredFilesFromPrebuiltApex(ctx android.BaseModuleContext) []string {
- imageConfig := module.getImageConfig(ctx)
- if imageConfig != nil {
- files := []string{}
- if imageConfig.profileInstallPathInApex != "" {
- // Add the boot image profile.
- files = append(files, imageConfig.profileInstallPathInApex)
- }
- if imageConfig.shouldInstallInApex() {
- // Add the boot image files, e.g. .art, .oat and .vdex files.
- for _, variant := range imageConfig.apexVariants() {
- arch := variant.target.Arch.ArchType
- for _, path := range variant.imagesDeps.Paths() {
- base := path.Base()
- files = append(files, apexRootRelativePathToBootImageFile(arch, base))
- }
- }
- }
- return files
- }
- return nil
- }
- func apexRootRelativePathToBootImageFile(arch android.ArchType, base string) string {
- return filepath.Join("javalib", arch.String(), base)
- }
- var _ android.RequiredFilesFromPrebuiltApex = (*PrebuiltBootclasspathFragmentModule)(nil)
- func prebuiltBootclasspathFragmentFactory() android.Module {
- m := &PrebuiltBootclasspathFragmentModule{}
- m.AddProperties(&m.properties, &m.prebuiltProperties)
- // This doesn't actually have any prebuilt files of its own so pass a placeholder for the srcs
- // array.
- android.InitPrebuiltModule(m, &[]string{"placeholder"})
- android.InitApexModule(m)
- android.InitSdkAwareModule(m)
- android.InitAndroidArchModule(m, android.HostAndDeviceSupported, android.MultilibCommon)
- // Initialize the contents property from the image_name.
- android.AddLoadHook(m, func(ctx android.LoadHookContext) {
- bootclasspathFragmentInitContentsFromImage(ctx, &m.BootclasspathFragmentModule)
- })
- return m
- }
|