blob: d1a7ed77429b9367c0261b1573ea601ddb525972 [file] [log] [blame]
Colin Crossfabb6082018-02-20 17:22:23 -08001// Copyright 2018 Google Inc. All rights reserved.
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7// http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15package java
16
17import (
Colin Crossa592e3e2019-02-19 16:59:53 -080018 "fmt"
Jaewoong Jung5b425e22019-06-17 17:40:56 -070019 "path/filepath"
Colin Crossc20dc852020-11-10 12:27:45 -080020 "strconv"
Colin Crossa97c5d32018-03-28 14:58:31 -070021 "strings"
Colin Crossfabb6082018-02-20 17:22:23 -080022
Jaewoong Jung9befb0c2020-01-18 10:33:43 -080023 "android/soong/android"
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -050024 "android/soong/bazel"
Ulya Trafimovich31e444e2020-08-14 17:32:16 +010025 "android/soong/dexpreopt"
Jaewoong Jung9befb0c2020-01-18 10:33:43 -080026
Colin Crossfabb6082018-02-20 17:22:23 -080027 "github.com/google/blueprint"
Colin Crossa97c5d32018-03-28 14:58:31 -070028 "github.com/google/blueprint/proptools"
Colin Crossfabb6082018-02-20 17:22:23 -080029)
30
Colin Crossa97c5d32018-03-28 14:58:31 -070031type AndroidLibraryDependency interface {
Jared Duke5979b302022-12-19 21:08:39 +000032 LibraryDependency
Colin Crossa97c5d32018-03-28 14:58:31 -070033 ExportPackage() android.Path
Colin Crossab8d1382023-07-14 17:23:41 +000034 ResourcesNodeDepSet() *android.DepSet[*resourcesNode]
35 RRODirsDepSet() *android.DepSet[rroDir]
36 ManifestsDepSet() *android.DepSet[android.Path]
Jaewoong Jungc779cd42020-10-06 18:56:10 -070037 SetRROEnforcedForDependent(enforce bool)
38 IsRROEnforced(ctx android.BaseModuleContext) bool
Colin Crossa97c5d32018-03-28 14:58:31 -070039}
40
41func init() {
Paul Duffinf9b1da02019-12-18 19:51:55 +000042 RegisterAARBuildComponents(android.InitRegistrationContext)
43}
44
45func RegisterAARBuildComponents(ctx android.RegistrationContext) {
46 ctx.RegisterModuleType("android_library_import", AARImportFactory)
47 ctx.RegisterModuleType("android_library", AndroidLibraryFactory)
Paul Duffin04ba70d2021-03-22 13:56:43 +000048 ctx.PostDepsMutators(func(ctx android.RegisterMutatorsContext) {
49 ctx.TopDown("propagate_rro_enforcement", propagateRROEnforcementMutator).Parallel()
50 })
Colin Crossa97c5d32018-03-28 14:58:31 -070051}
52
53//
54// AAR (android library)
55//
56
57type androidLibraryProperties struct {
58 BuildAAR bool `blueprint:"mutated"`
59}
60
61type aaptProperties struct {
62 // flags passed to aapt when creating the apk
63 Aaptflags []string
64
Dan Willemsen72be5902018-10-24 20:24:57 -070065 // include all resource configurations, not just the product-configured
66 // ones.
67 Aapt_include_all_resources *bool
68
Colin Crossa97c5d32018-03-28 14:58:31 -070069 // list of directories relative to the Blueprints file containing assets.
Colin Cross0ddae7f2019-02-07 15:30:01 -080070 // Defaults to ["assets"] if a directory called assets exists. Set to []
71 // to disable the default.
Colin Crossa97c5d32018-03-28 14:58:31 -070072 Asset_dirs []string
73
74 // list of directories relative to the Blueprints file containing
Colin Cross0ddae7f2019-02-07 15:30:01 -080075 // Android resources. Defaults to ["res"] if a directory called res exists.
76 // Set to [] to disable the default.
Colin Crossa97c5d32018-03-28 14:58:31 -070077 Resource_dirs []string
78
Colin Crossa592e3e2019-02-19 16:59:53 -080079 // list of zip files containing Android resources.
Colin Cross27b922f2019-03-04 22:35:41 -080080 Resource_zips []string `android:"path"`
Colin Crossa592e3e2019-02-19 16:59:53 -080081
Colin Crossa97c5d32018-03-28 14:58:31 -070082 // path to AndroidManifest.xml. If unset, defaults to "AndroidManifest.xml".
Colin Cross27b922f2019-03-04 22:35:41 -080083 Manifest *string `android:"path"`
changho.shinb5432b72019-08-08 18:37:17 +090084
85 // paths to additional manifest files to merge with main manifest.
86 Additional_manifests []string `android:"path"`
Sasha Smundak541056c2019-10-28 15:50:06 -070087
88 // do not include AndroidManifest from dependent libraries
89 Dont_merge_manifests *bool
Jaewoong Jungc779cd42020-10-06 18:56:10 -070090
Colin Cross4eae06d2023-06-20 22:40:02 -070091 // If use_resource_processor is set, use Bazel's resource processor instead of aapt2 to generate R.class files.
92 // The resource processor produces more optimal R.class files that only list resources in the package of the
93 // library that provided them, as opposed to aapt2 which produces R.java files for every package containing
94 // every resource. Using the resource processor can provide significant build time speedups, but requires
95 // fixing the module to use the correct package to reference each resource, and to avoid having any other
96 // libraries in the tree that use the same package name. Defaults to false, but will default to true in the
97 // future.
98 Use_resource_processor *bool
99
Jaewoong Jungc779cd42020-10-06 18:56:10 -0700100 // true if RRO is enforced for any of the dependent modules
101 RROEnforcedForDependent bool `blueprint:"mutated"`
Colin Crossa97c5d32018-03-28 14:58:31 -0700102}
103
104type aapt struct {
Colin Cross4eae06d2023-06-20 22:40:02 -0700105 aaptSrcJar android.Path
106 transitiveAaptRJars android.Paths
107 transitiveAaptResourcePackages android.Paths
108 exportPackage android.Path
109 manifestPath android.Path
110 proguardOptionsFile android.Path
111 rTxt android.Path
112 rJar android.Path
113 extraAaptPackagesFile android.Path
114 mergedManifestFile android.Path
115 noticeFile android.OptionalPath
116 assetPackage android.OptionalPath
117 isLibrary bool
118 defaultManifestVersion string
119 useEmbeddedNativeLibs bool
120 useEmbeddedDex bool
121 usesNonSdkApis bool
122 hasNoCode bool
123 LoggingParent string
124 resourceFiles android.Paths
Colin Crossa97c5d32018-03-28 14:58:31 -0700125
Colin Crosse560c4a2019-03-19 16:03:11 -0700126 splitNames []string
127 splits []split
128
Colin Crossa97c5d32018-03-28 14:58:31 -0700129 aaptProperties aaptProperties
Colin Crossab8d1382023-07-14 17:23:41 +0000130
131 resourcesNodesDepSet *android.DepSet[*resourcesNode]
132 rroDirsDepSet *android.DepSet[rroDir]
133 manifestsDepSet *android.DepSet[android.Path]
Colin Crossa97c5d32018-03-28 14:58:31 -0700134}
135
Colin Crosse560c4a2019-03-19 16:03:11 -0700136type split struct {
137 name string
138 suffix string
139 path android.Path
140}
141
Jaewoong Jungc779cd42020-10-06 18:56:10 -0700142// Propagate RRO enforcement flag to static lib dependencies transitively.
143func propagateRROEnforcementMutator(ctx android.TopDownMutatorContext) {
144 m := ctx.Module()
145 if d, ok := m.(AndroidLibraryDependency); ok && d.IsRROEnforced(ctx) {
146 ctx.VisitDirectDepsWithTag(staticLibTag, func(d android.Module) {
147 if a, ok := d.(AndroidLibraryDependency); ok {
148 a.SetRROEnforcedForDependent(true)
149 }
150 })
151 }
152}
153
Colin Cross4eae06d2023-06-20 22:40:02 -0700154func (a *aapt) useResourceProcessorBusyBox() bool {
155 return BoolDefault(a.aaptProperties.Use_resource_processor, false)
156}
157
Colin Crossa97c5d32018-03-28 14:58:31 -0700158func (a *aapt) ExportPackage() android.Path {
159 return a.exportPackage
160}
Colin Crossab8d1382023-07-14 17:23:41 +0000161func (a *aapt) ResourcesNodeDepSet() *android.DepSet[*resourcesNode] {
162 return a.resourcesNodesDepSet
Colin Crossc1c37552019-01-31 11:42:41 -0800163}
164
Colin Crossab8d1382023-07-14 17:23:41 +0000165func (a *aapt) RRODirsDepSet() *android.DepSet[rroDir] {
166 return a.rroDirsDepSet
Colin Crossc1c37552019-01-31 11:42:41 -0800167}
168
Colin Crossab8d1382023-07-14 17:23:41 +0000169func (a *aapt) ManifestsDepSet() *android.DepSet[android.Path] {
170 return a.manifestsDepSet
Jaewoong Jung6431ca72020-01-15 14:15:10 -0800171}
172
Jaewoong Jungc779cd42020-10-06 18:56:10 -0700173func (a *aapt) SetRROEnforcedForDependent(enforce bool) {
174 a.aaptProperties.RROEnforcedForDependent = enforce
175}
176
177func (a *aapt) IsRROEnforced(ctx android.BaseModuleContext) bool {
178 // True if RRO is enforced for this module or...
179 return ctx.Config().EnforceRROForModule(ctx.ModuleName()) ||
Jeongik Chacee5ba92021-02-19 12:11:51 +0900180 // if RRO is enforced for any of its dependents.
181 a.aaptProperties.RROEnforcedForDependent
Jaewoong Jungc779cd42020-10-06 18:56:10 -0700182}
183
Jiyong Parkf1691d22021-03-29 20:11:58 +0900184func (a *aapt) aapt2Flags(ctx android.ModuleContext, sdkContext android.SdkContext,
Colin Crossa0ba2f52019-06-22 12:59:27 -0700185 manifestPath android.Path) (compileFlags, linkFlags []string, linkDeps android.Paths,
186 resDirs, overlayDirs []globbedResourceDir, rroDirs []rroDir, resZips android.Paths) {
Colin Crossa97c5d32018-03-28 14:58:31 -0700187
Jaewoong Jung3aff5782020-02-11 07:54:35 -0800188 hasVersionCode := android.PrefixInList(a.aaptProperties.Aaptflags, "--version-code")
189 hasVersionName := android.PrefixInList(a.aaptProperties.Aaptflags, "--version-name")
Colin Crossa97c5d32018-03-28 14:58:31 -0700190
Colin Crossa97c5d32018-03-28 14:58:31 -0700191 // Flags specified in Android.bp
192 linkFlags = append(linkFlags, a.aaptProperties.Aaptflags...)
193
Colin Crossa97c5d32018-03-28 14:58:31 -0700194 // Find implicit or explicit asset and resource dirs
195 assetDirs := android.PathsWithOptionalDefaultForModuleSrc(ctx, a.aaptProperties.Asset_dirs, "assets")
196 resourceDirs := android.PathsWithOptionalDefaultForModuleSrc(ctx, a.aaptProperties.Resource_dirs, "res")
Colin Cross8a497952019-03-05 22:25:09 -0800197 resourceZips := android.PathsForModuleSrc(ctx, a.aaptProperties.Resource_zips)
Colin Crossa97c5d32018-03-28 14:58:31 -0700198
Colin Crossa97c5d32018-03-28 14:58:31 -0700199 // Glob directories into lists of paths
200 for _, dir := range resourceDirs {
201 resDirs = append(resDirs, globbedResourceDir{
202 dir: dir,
203 files: androidResourceGlob(ctx, dir),
204 })
Jaewoong Jungc779cd42020-10-06 18:56:10 -0700205 resOverlayDirs, resRRODirs := overlayResourceGlob(ctx, a, dir)
Colin Crossa97c5d32018-03-28 14:58:31 -0700206 overlayDirs = append(overlayDirs, resOverlayDirs...)
207 rroDirs = append(rroDirs, resRRODirs...)
208 }
209
Colin Crossc20dc852020-11-10 12:27:45 -0800210 var assetDeps android.Paths
211 for i, dir := range assetDirs {
212 // Add a dependency on every file in the asset directory. This ensures the aapt2
213 // rule will be rerun if one of the files in the asset directory is modified.
214 assetDeps = append(assetDeps, androidResourceGlob(ctx, dir)...)
215
216 // Add a dependency on a file that contains a list of all the files in the asset directory.
217 // This ensures the aapt2 rule will be run if a file is removed from the asset directory,
218 // or a file is added whose timestamp is older than the output of aapt2.
219 assetFileListFile := android.PathForModuleOut(ctx, "asset_dir_globs", strconv.Itoa(i)+".glob")
220 androidResourceGlobList(ctx, dir, assetFileListFile)
221 assetDeps = append(assetDeps, assetFileListFile)
Colin Crossa97c5d32018-03-28 14:58:31 -0700222 }
223
Jaewoong Jung5b425e22019-06-17 17:40:56 -0700224 assetDirStrings := assetDirs.Strings()
225 if a.noticeFile.Valid() {
226 assetDirStrings = append(assetDirStrings, filepath.Dir(a.noticeFile.Path().String()))
Colin Crossc20dc852020-11-10 12:27:45 -0800227 assetDeps = append(assetDeps, a.noticeFile.Path())
Jaewoong Jung5b425e22019-06-17 17:40:56 -0700228 }
229
Colin Crossa97c5d32018-03-28 14:58:31 -0700230 linkFlags = append(linkFlags, "--manifest "+manifestPath.String())
231 linkDeps = append(linkDeps, manifestPath)
232
Jaewoong Jung5b425e22019-06-17 17:40:56 -0700233 linkFlags = append(linkFlags, android.JoinWithPrefix(assetDirStrings, "-A "))
Colin Crossc20dc852020-11-10 12:27:45 -0800234 linkDeps = append(linkDeps, assetDeps...)
Colin Crossa97c5d32018-03-28 14:58:31 -0700235
Spandan Das50885c02023-02-23 21:31:33 +0000236 // Returns the effective version for {min|target}_sdk_version
Spandan Das8c9ae7e2023-03-03 21:20:36 +0000237 effectiveVersionString := func(sdkVersion android.SdkSpec, minSdkVersion android.ApiLevel) string {
Spandan Das50885c02023-02-23 21:31:33 +0000238 // If {min|target}_sdk_version is current, use sdk_version to determine the effective level
239 // This is necessary for vendor modules.
240 // The effective version does not _only_ depend on {min|target}_sdk_version(level),
241 // but also on the sdk_version (kind+level)
Spandan Das8c9ae7e2023-03-03 21:20:36 +0000242 if minSdkVersion.IsCurrent() {
Spandan Das50885c02023-02-23 21:31:33 +0000243 ret, err := sdkVersion.EffectiveVersionString(ctx)
244 if err != nil {
245 ctx.ModuleErrorf("invalid sdk_version: %s", err)
246 }
247 return ret
248 }
249 ret, err := minSdkVersion.EffectiveVersionString(ctx)
250 if err != nil {
251 ctx.ModuleErrorf("invalid min_sdk_version: %s", err)
252 }
253 return ret
Jiyong Park6a927c42020-01-21 02:03:43 +0900254 }
Spandan Das50885c02023-02-23 21:31:33 +0000255 // SDK version flags
256 sdkVersion := sdkContext.SdkVersion(ctx)
257 minSdkVersion := effectiveVersionString(sdkVersion, sdkContext.MinSdkVersion(ctx))
Colin Crossa97c5d32018-03-28 14:58:31 -0700258
Colin Cross83bb3162018-06-25 15:48:06 -0700259 linkFlags = append(linkFlags, "--min-sdk-version "+minSdkVersion)
Spandan Das6450b552023-02-23 19:27:07 +0000260 // Use minSdkVersion for target-sdk-version, even if `target_sdk_version` is set
261 // This behavior has been copied from Make.
Colin Cross83bb3162018-06-25 15:48:06 -0700262 linkFlags = append(linkFlags, "--target-sdk-version "+minSdkVersion)
Colin Crossa97c5d32018-03-28 14:58:31 -0700263
Colin Crossa97c5d32018-03-28 14:58:31 -0700264 // Version code
265 if !hasVersionCode {
Dan Albert4f378d72020-07-23 17:32:15 -0700266 linkFlags = append(linkFlags, "--version-code", ctx.Config().PlatformSdkVersion().String())
Colin Crossa97c5d32018-03-28 14:58:31 -0700267 }
268
269 if !hasVersionName {
Colin Cross402d5e02018-04-25 14:54:06 -0700270 var versionName string
271 if ctx.ModuleName() == "framework-res" {
272 // Some builds set AppsDefaultVersionName() to include the build number ("O-123456"). aapt2 copies the
273 // version name of framework-res into app manifests as compileSdkVersionCodename, which confuses things
Colin Crossbfd347d2018-05-09 11:11:35 -0700274 // if it contains the build number. Use the PlatformVersionName instead.
275 versionName = ctx.Config().PlatformVersionName()
Colin Cross402d5e02018-04-25 14:54:06 -0700276 } else {
277 versionName = ctx.Config().AppsDefaultVersionName()
278 }
Colin Cross0b9f31f2019-02-28 11:00:01 -0800279 versionName = proptools.NinjaEscape(versionName)
Colin Crossa97c5d32018-03-28 14:58:31 -0700280 linkFlags = append(linkFlags, "--version-name ", versionName)
281 }
282
Colin Crossa0ba2f52019-06-22 12:59:27 -0700283 linkFlags, compileFlags = android.FilterList(linkFlags, []string{"--legacy"})
284
285 // Always set --pseudo-localize, it will be stripped out later for release
286 // builds that don't want it.
287 compileFlags = append(compileFlags, "--pseudo-localize")
288
289 return compileFlags, linkFlags, linkDeps, resDirs, overlayDirs, rroDirs, resourceZips
Colin Crossa97c5d32018-03-28 14:58:31 -0700290}
291
Paul Duffin250e6192019-06-07 10:44:37 +0100292func (a *aapt) deps(ctx android.BottomUpMutatorContext, sdkDep sdkDep) {
Colin Cross42308aa2018-11-14 21:44:17 -0800293 if sdkDep.frameworkResModule != "" {
294 ctx.AddVariationDependencies(nil, frameworkResTag, sdkDep.frameworkResModule)
Colin Crossa97c5d32018-03-28 14:58:31 -0700295 }
296}
297
Jaewoong Jung6431ca72020-01-15 14:15:10 -0800298var extractAssetsRule = pctx.AndroidStaticRule("extractAssets",
299 blueprint.RuleParams{
300 Command: `${config.Zip2ZipCmd} -i ${in} -o ${out} "assets/**/*"`,
301 CommandDeps: []string{"${config.Zip2ZipCmd}"},
302 })
303
Jiyong Parkf1691d22021-03-29 20:11:58 +0900304func (a *aapt) buildActions(ctx android.ModuleContext, sdkContext android.SdkContext,
Paul Duffin06530572022-02-03 17:54:15 +0000305 classLoaderContexts dexpreopt.ClassLoaderContextMap, excludedLibs []string,
Harshit Mahajan5b8b7302022-06-10 11:24:05 +0000306 enforceDefaultTargetSdkVersion bool, extraLinkFlags ...string) {
Colin Cross5446e882019-05-22 10:46:27 -0700307
Colin Crossab8d1382023-07-14 17:23:41 +0000308 staticResourcesNodesDepSet, staticRRODirsDepSet, staticManifestsDepSet, sharedDeps, libFlags :=
Ulya Trafimovichb23d28c2020-10-08 12:53:58 +0100309 aaptLibs(ctx, sdkContext, classLoaderContexts)
Ulya Trafimovich31e444e2020-08-14 17:32:16 +0100310
Paul Duffin06530572022-02-03 17:54:15 +0000311 // Exclude any libraries from the supplied list.
312 classLoaderContexts = classLoaderContexts.ExcludeLibs(excludedLibs)
313
Colin Cross31656952018-05-24 16:11:20 -0700314 // App manifest file
315 manifestFile := proptools.StringDefault(a.aaptProperties.Manifest, "AndroidManifest.xml")
316 manifestSrcPath := android.PathForModuleSrc(ctx, manifestFile)
317
Gurpreet Singh7deabfa2022-02-10 13:28:35 +0000318 manifestPath := ManifestFixer(ctx, manifestSrcPath, ManifestFixerParams{
Harshit Mahajan5b8b7302022-06-10 11:24:05 +0000319 SdkContext: sdkContext,
320 ClassLoaderContexts: classLoaderContexts,
321 IsLibrary: a.isLibrary,
322 DefaultManifestVersion: a.defaultManifestVersion,
323 UseEmbeddedNativeLibs: a.useEmbeddedNativeLibs,
324 UsesNonSdkApis: a.usesNonSdkApis,
325 UseEmbeddedDex: a.useEmbeddedDex,
326 HasNoCode: a.hasNoCode,
327 LoggingParent: a.LoggingParent,
328 EnforceDefaultTargetSdkVersion: enforceDefaultTargetSdkVersion,
Gurpreet Singh75d65f32022-01-24 17:44:05 +0000329 })
Colin Cross90c25c62019-04-19 16:22:57 -0700330
Colin Crossab8d1382023-07-14 17:23:41 +0000331 staticDeps := transitiveAarDeps(staticResourcesNodesDepSet.ToList())
332
Luca Stefanifd898822019-09-10 22:13:31 +0200333 // Add additional manifest files to transitive manifests.
334 additionalManifests := android.PathsForModuleSrc(ctx, a.aaptProperties.Additional_manifests)
Colin Crossab8d1382023-07-14 17:23:41 +0000335 transitiveManifestPaths := append(android.Paths{manifestPath}, additionalManifests...)
336 // TODO(b/288358614): Soong has historically not merged manifests from dependencies of android_library_import
337 // modules. Merging manifests from dependencies could remove the need for pom2bp to generate the "-nodeps" copies
338 // of androidx libraries, but doing so triggers errors due to errors introduced by existing dependencies of
339 // android_library_import modules. If this is fixed, staticManifestsDepSet can be dropped completely in favor of
340 // staticResourcesNodesDepSet.manifests()
341 transitiveManifestPaths = append(transitiveManifestPaths, staticManifestsDepSet.ToList()...)
Colin Cross90c25c62019-04-19 16:22:57 -0700342
Colin Crossab8d1382023-07-14 17:23:41 +0000343 if len(transitiveManifestPaths) > 1 && !Bool(a.aaptProperties.Dont_merge_manifests) {
344 a.mergedManifestFile = manifestMerger(ctx, transitiveManifestPaths[0], transitiveManifestPaths[1:], a.isLibrary)
Colin Cross90c25c62019-04-19 16:22:57 -0700345 if !a.isLibrary {
346 // Only use the merged manifest for applications. For libraries, the transitive closure of manifests
347 // will be propagated to the final application and merged there. The merged manifest for libraries is
348 // only passed to Make, which can't handle transitive dependencies.
349 manifestPath = a.mergedManifestFile
350 }
351 } else {
352 a.mergedManifestFile = manifestPath
353 }
Colin Cross31656952018-05-24 16:11:20 -0700354
Colin Crossa0ba2f52019-06-22 12:59:27 -0700355 compileFlags, linkFlags, linkDeps, resDirs, overlayDirs, rroDirs, resZips := a.aapt2Flags(ctx, sdkContext, manifestPath)
Colin Cross31656952018-05-24 16:11:20 -0700356
357 linkFlags = append(linkFlags, libFlags...)
Colin Crossab8d1382023-07-14 17:23:41 +0000358 linkDeps = append(linkDeps, sharedDeps...)
359 linkDeps = append(linkDeps, staticDeps.resPackages()...)
Colin Crossa97c5d32018-03-28 14:58:31 -0700360 linkFlags = append(linkFlags, extraLinkFlags...)
Colin Cross1b6a3cf2018-07-24 14:51:30 -0700361 if a.isLibrary {
362 linkFlags = append(linkFlags, "--static-lib")
363 }
Colin Crossa97c5d32018-03-28 14:58:31 -0700364
Colin Cross4eae06d2023-06-20 22:40:02 -0700365 if a.isLibrary && a.useResourceProcessorBusyBox() {
366 // When building an android_library using ResourceProcessorBusyBox the resources are merged into
367 // package-res.apk with --merge-only, but --no-static-lib-packages is not used so that R.txt only
368 // contains resources from this library.
369 linkFlags = append(linkFlags, "--merge-only")
370 } else {
371 // When building and app or when building an android_library without ResourceProcessorBusyBox
372 // --no-static-lib-packages is used to put all the resources into the app. If ResourceProcessorBusyBox
373 // is used then the app's R.txt will be post-processed along with the R.txt files from dependencies to
374 // sort resources into the right packages in R.class.
375 linkFlags = append(linkFlags, "--no-static-lib-packages")
376 }
377
Colin Crossa97c5d32018-03-28 14:58:31 -0700378 packageRes := android.PathForModuleOut(ctx, "package-res.apk")
Colin Crossa97c5d32018-03-28 14:58:31 -0700379 proguardOptionsFile := android.PathForModuleGen(ctx, "proguard.options")
380 rTxt := android.PathForModuleOut(ctx, "R.txt")
Colin Cross66f78822018-05-02 12:58:28 -0700381 // This file isn't used by Soong, but is generated for exporting
382 extraPackages := android.PathForModuleOut(ctx, "extra_packages")
Colin Cross4eae06d2023-06-20 22:40:02 -0700383 var transitiveRJars android.Paths
Colin Crossf3b7bad2023-08-02 15:49:00 -0700384 var srcJar android.WritablePath
Colin Crossa97c5d32018-03-28 14:58:31 -0700385
Colin Cross4aaa84a2018-08-21 15:14:37 -0700386 var compiledResDirs []android.Paths
Colin Crossa97c5d32018-03-28 14:58:31 -0700387 for _, dir := range resDirs {
Colin Cross014489c2020-06-02 20:09:13 -0700388 a.resourceFiles = append(a.resourceFiles, dir.files...)
Colin Crossa0ba2f52019-06-22 12:59:27 -0700389 compiledResDirs = append(compiledResDirs, aapt2Compile(ctx, dir.dir, dir.files, compileFlags).Paths())
Colin Crossa97c5d32018-03-28 14:58:31 -0700390 }
Colin Cross4aaa84a2018-08-21 15:14:37 -0700391
Colin Crossa592e3e2019-02-19 16:59:53 -0800392 for i, zip := range resZips {
393 flata := android.PathForModuleOut(ctx, fmt.Sprintf("reszip.%d.flata", i))
Colin Crossa0ba2f52019-06-22 12:59:27 -0700394 aapt2CompileZip(ctx, flata, zip, "", compileFlags)
Colin Crossa592e3e2019-02-19 16:59:53 -0800395 compiledResDirs = append(compiledResDirs, android.Paths{flata})
396 }
397
Colin Cross4aaa84a2018-08-21 15:14:37 -0700398 var compiledRes, compiledOverlay android.Paths
399
Colin Crossab8d1382023-07-14 17:23:41 +0000400 // AAPT2 overlays are in lowest to highest priority order, reverse the topological order
401 // of transitiveStaticLibs.
402 transitiveStaticLibs := android.ReversePaths(staticDeps.resPackages())
403
Colin Cross4eae06d2023-06-20 22:40:02 -0700404 if a.isLibrary && a.useResourceProcessorBusyBox() {
405 // When building an android_library with ResourceProcessorBusyBox enabled treat static library dependencies
406 // as imports. The resources from dependencies will not be merged into this module's package-res.apk, and
407 // instead modules depending on this module will reference package-res.apk from all transitive static
408 // dependencies.
409 for _, staticDep := range staticDeps {
410 linkDeps = append(linkDeps, staticDep.resPackage)
411 linkFlags = append(linkFlags, "-I "+staticDep.resPackage.String())
412 if staticDep.usedResourceProcessor {
413 transitiveRJars = append(transitiveRJars, staticDep.rJar)
414 }
415 }
416 } else {
417 // When building an app or building a library without ResourceProcessorBusyBox enabled all static
418 // dependencies are compiled into this module's package-res.apk as overlays.
419 compiledOverlay = append(compiledOverlay, transitiveStaticLibs...)
420 }
Colin Cross4aaa84a2018-08-21 15:14:37 -0700421
Colin Crossbec85302019-02-13 13:15:46 -0800422 if len(transitiveStaticLibs) > 0 {
Colin Cross4aaa84a2018-08-21 15:14:37 -0700423 // If we are using static android libraries, every source file becomes an overlay.
424 // This is to emulate old AAPT behavior which simulated library support.
425 for _, compiledResDir := range compiledResDirs {
426 compiledOverlay = append(compiledOverlay, compiledResDir...)
427 }
Colin Crossbec85302019-02-13 13:15:46 -0800428 } else if a.isLibrary {
429 // Otherwise, for a static library we treat all the resources equally with no overlay.
430 for _, compiledResDir := range compiledResDirs {
431 compiledRes = append(compiledRes, compiledResDir...)
432 }
Colin Cross4aaa84a2018-08-21 15:14:37 -0700433 } else if len(compiledResDirs) > 0 {
434 // Without static libraries, the first directory is our directory, which can then be
435 // overlaid by the rest.
436 compiledRes = append(compiledRes, compiledResDirs[0]...)
437 for _, compiledResDir := range compiledResDirs[1:] {
438 compiledOverlay = append(compiledOverlay, compiledResDir...)
439 }
440 }
441
Colin Crossa97c5d32018-03-28 14:58:31 -0700442 for _, dir := range overlayDirs {
Colin Crossa0ba2f52019-06-22 12:59:27 -0700443 compiledOverlay = append(compiledOverlay, aapt2Compile(ctx, dir.dir, dir.files, compileFlags).Paths()...)
Colin Crossa97c5d32018-03-28 14:58:31 -0700444 }
445
Colin Crosse560c4a2019-03-19 16:03:11 -0700446 var splitPackages android.WritablePaths
447 var splits []split
448
449 for _, s := range a.splitNames {
450 suffix := strings.Replace(s, ",", "_", -1)
451 path := android.PathForModuleOut(ctx, "package_"+suffix+".apk")
452 linkFlags = append(linkFlags, "--split", path.String()+":"+s)
453 splitPackages = append(splitPackages, path)
454 splits = append(splits, split{
455 name: s,
456 suffix: suffix,
457 path: path,
458 })
459 }
460
Colin Crossf3b7bad2023-08-02 15:49:00 -0700461 if !a.useResourceProcessorBusyBox() {
462 // the subdir "android" is required to be filtered by package names
463 srcJar = android.PathForModuleGen(ctx, "android", "R.srcjar")
464 }
465
Colin Crossab8d1382023-07-14 17:23:41 +0000466 // No need to specify assets from dependencies to aapt2Link for libraries, all transitive assets will be
467 // provided to the final app aapt2Link step.
468 var transitiveAssets android.Paths
469 if !a.isLibrary {
470 transitiveAssets = android.ReverseSliceInPlace(staticDeps.assets())
471 }
Colin Crossf3b7bad2023-08-02 15:49:00 -0700472 aapt2Link(ctx, packageRes, srcJar, proguardOptionsFile, rTxt,
Colin Crossab8d1382023-07-14 17:23:41 +0000473 linkFlags, linkDeps, compiledRes, compiledOverlay, transitiveAssets, splitPackages)
Jaewoong Jung6431ca72020-01-15 14:15:10 -0800474 // Extract assets from the resource package output so that they can be used later in aapt2link
475 // for modules that depend on this one.
Colin Crossab8d1382023-07-14 17:23:41 +0000476 if android.PrefixInList(linkFlags, "-A ") {
Jaewoong Jung6431ca72020-01-15 14:15:10 -0800477 assets := android.PathForModuleOut(ctx, "assets.zip")
478 ctx.Build(pctx, android.BuildParams{
479 Rule: extractAssetsRule,
480 Input: packageRes,
481 Output: assets,
482 Description: "extract assets from built resource file",
483 })
484 a.assetPackage = android.OptionalPathForPath(assets)
485 }
Colin Crossa97c5d32018-03-28 14:58:31 -0700486
Colin Cross4eae06d2023-06-20 22:40:02 -0700487 if a.useResourceProcessorBusyBox() {
488 rJar := android.PathForModuleOut(ctx, "busybox/R.jar")
489 resourceProcessorBusyBoxGenerateBinaryR(ctx, rTxt, a.mergedManifestFile, rJar, staticDeps, a.isLibrary)
Colin Crossf3b7bad2023-08-02 15:49:00 -0700490 aapt2ExtractExtraPackages(ctx, extraPackages, rJar)
Colin Cross4eae06d2023-06-20 22:40:02 -0700491 transitiveRJars = append(transitiveRJars, rJar)
492 a.rJar = rJar
Colin Crossf3b7bad2023-08-02 15:49:00 -0700493 } else {
494 aapt2ExtractExtraPackages(ctx, extraPackages, srcJar)
Colin Cross4eae06d2023-06-20 22:40:02 -0700495 }
496
Colin Crossa97c5d32018-03-28 14:58:31 -0700497 a.aaptSrcJar = srcJar
Colin Cross4eae06d2023-06-20 22:40:02 -0700498 a.transitiveAaptRJars = transitiveRJars
499 a.transitiveAaptResourcePackages = staticDeps.resPackages()
Colin Crossa97c5d32018-03-28 14:58:31 -0700500 a.exportPackage = packageRes
501 a.manifestPath = manifestPath
502 a.proguardOptionsFile = proguardOptionsFile
Colin Cross66f78822018-05-02 12:58:28 -0700503 a.extraAaptPackagesFile = extraPackages
Colin Crossa97c5d32018-03-28 14:58:31 -0700504 a.rTxt = rTxt
Colin Crosse560c4a2019-03-19 16:03:11 -0700505 a.splits = splits
Colin Crossab8d1382023-07-14 17:23:41 +0000506 a.resourcesNodesDepSet = android.NewDepSetBuilder[*resourcesNode](android.TOPOLOGICAL).
507 Direct(&resourcesNode{
508 resPackage: a.exportPackage,
509 manifest: a.manifestPath,
510 additionalManifests: additionalManifests,
Colin Cross4eae06d2023-06-20 22:40:02 -0700511 rTxt: a.rTxt,
512 rJar: a.rJar,
Colin Crossab8d1382023-07-14 17:23:41 +0000513 assets: a.assetPackage,
Colin Cross4eae06d2023-06-20 22:40:02 -0700514
515 usedResourceProcessor: a.useResourceProcessorBusyBox(),
Colin Crossab8d1382023-07-14 17:23:41 +0000516 }).
517 Transitive(staticResourcesNodesDepSet).Build()
518 a.rroDirsDepSet = android.NewDepSetBuilder[rroDir](android.TOPOLOGICAL).
519 Direct(rroDirs...).
520 Transitive(staticRRODirsDepSet).Build()
521 a.manifestsDepSet = android.NewDepSetBuilder[android.Path](android.TOPOLOGICAL).
522 Direct(a.manifestPath).
523 DirectSlice(additionalManifests).
524 Transitive(staticManifestsDepSet).Build()
525}
526
Colin Cross4eae06d2023-06-20 22:40:02 -0700527var resourceProcessorBusyBox = pctx.AndroidStaticRule("resourceProcessorBusyBox",
528 blueprint.RuleParams{
529 Command: "${config.JavaCmd} -cp ${config.ResourceProcessorBusyBox} " +
530 "com.google.devtools.build.android.ResourceProcessorBusyBox --tool=GENERATE_BINARY_R -- @${out}.args && " +
531 "if cmp -s ${out}.tmp ${out} ; then rm ${out}.tmp ; else mv ${out}.tmp ${out}; fi",
532 CommandDeps: []string{"${config.ResourceProcessorBusyBox}"},
533 Rspfile: "${out}.args",
534 RspfileContent: "--primaryRTxt ${rTxt} --primaryManifest ${manifest} --classJarOutput ${out}.tmp ${args}",
535 Restat: true,
536 }, "rTxt", "manifest", "args")
537
538// resourceProcessorBusyBoxGenerateBinaryR converts the R.txt file produced by aapt2 into R.class files
539// using Bazel's ResourceProcessorBusyBox tool, which is faster than compiling the R.java files and
540// supports producing classes for static dependencies that only include resources from that dependency.
541func resourceProcessorBusyBoxGenerateBinaryR(ctx android.ModuleContext, rTxt, manifest android.Path,
542 rJar android.WritablePath, transitiveDeps transitiveAarDeps, isLibrary bool) {
543
544 var args []string
545 var deps android.Paths
546
547 if !isLibrary {
548 // When compiling an app, pass all R.txt and AndroidManifest.xml from transitive static library dependencies
549 // to ResourceProcessorBusyBox so that it can regenerate R.class files with the final resource IDs for each
550 // package.
551 args, deps = transitiveDeps.resourceProcessorDeps()
552 } else {
553 // When compiling a library don't pass any dependencies as it only needs to generate an R.class file for this
554 // library. Pass --finalFields=false so that the R.class file contains non-final fields so they don't get
555 // inlined into the library before the final IDs are assigned during app compilation.
556 args = append(args, "--finalFields=false")
557 }
558
559 deps = append(deps, rTxt, manifest)
560
561 ctx.Build(pctx, android.BuildParams{
562 Rule: resourceProcessorBusyBox,
563 Output: rJar,
564 Implicits: deps,
565 Description: "ResourceProcessorBusyBox",
566 Args: map[string]string{
567 "rTxt": rTxt.String(),
568 "manifest": manifest.String(),
569 "args": strings.Join(args, " "),
570 },
571 })
572}
573
Colin Crossab8d1382023-07-14 17:23:41 +0000574type resourcesNode struct {
575 resPackage android.Path
576 manifest android.Path
577 additionalManifests android.Paths
Colin Cross4eae06d2023-06-20 22:40:02 -0700578 rTxt android.Path
579 rJar android.Path
Colin Crossab8d1382023-07-14 17:23:41 +0000580 assets android.OptionalPath
Colin Cross4eae06d2023-06-20 22:40:02 -0700581
582 usedResourceProcessor bool
Colin Crossab8d1382023-07-14 17:23:41 +0000583}
584
585type transitiveAarDeps []*resourcesNode
586
587func (t transitiveAarDeps) resPackages() android.Paths {
Colin Cross4eae06d2023-06-20 22:40:02 -0700588 paths := make(android.Paths, 0, len(t))
Colin Crossab8d1382023-07-14 17:23:41 +0000589 for _, dep := range t {
590 paths = append(paths, dep.resPackage)
591 }
Colin Cross4eae06d2023-06-20 22:40:02 -0700592 return paths
Colin Crossab8d1382023-07-14 17:23:41 +0000593}
594
595func (t transitiveAarDeps) manifests() android.Paths {
Colin Cross4eae06d2023-06-20 22:40:02 -0700596 paths := make(android.Paths, 0, len(t))
Colin Crossab8d1382023-07-14 17:23:41 +0000597 for _, dep := range t {
598 paths = append(paths, dep.manifest)
599 paths = append(paths, dep.additionalManifests...)
600 }
Colin Cross4eae06d2023-06-20 22:40:02 -0700601 return paths
602}
603
604func (t transitiveAarDeps) resourceProcessorDeps() (args []string, deps android.Paths) {
605 for _, dep := range t {
606 args = append(args, "--library="+dep.rTxt.String()+","+dep.manifest.String())
607 deps = append(deps, dep.rTxt, dep.manifest)
608 }
609 return args, deps
Colin Crossab8d1382023-07-14 17:23:41 +0000610}
611
612func (t transitiveAarDeps) assets() android.Paths {
Colin Cross4eae06d2023-06-20 22:40:02 -0700613 paths := make(android.Paths, 0, len(t))
Colin Crossab8d1382023-07-14 17:23:41 +0000614 for _, dep := range t {
615 if dep.assets.Valid() {
616 paths = append(paths, dep.assets.Path())
617 }
618 }
619 return paths
Colin Crossa97c5d32018-03-28 14:58:31 -0700620}
621
622// aaptLibs collects libraries from dependencies and sdk_version and converts them into paths
Jiyong Parkf1691d22021-03-29 20:11:58 +0900623func aaptLibs(ctx android.ModuleContext, sdkContext android.SdkContext, classLoaderContexts dexpreopt.ClassLoaderContextMap) (
Colin Crossab8d1382023-07-14 17:23:41 +0000624 staticResourcesNodes *android.DepSet[*resourcesNode], staticRRODirs *android.DepSet[rroDir],
625 staticManifests *android.DepSet[android.Path], sharedLibs android.Paths, flags []string) {
Colin Crossa97c5d32018-03-28 14:58:31 -0700626
Ulya Trafimovichb23d28c2020-10-08 12:53:58 +0100627 if classLoaderContexts == nil {
Ulya Trafimovich18554242020-11-03 15:55:11 +0000628 // Not all callers need to compute class loader context, those who don't just pass nil.
629 // Create a temporary class loader context here (it will be computed, but not used).
Ulya Trafimovichb23d28c2020-10-08 12:53:58 +0100630 classLoaderContexts = make(dexpreopt.ClassLoaderContextMap)
Ulya Trafimovich18554242020-11-03 15:55:11 +0000631 }
632
Colin Cross83bb3162018-06-25 15:48:06 -0700633 sdkDep := decodeSdkDep(ctx, sdkContext)
Colin Crossa97c5d32018-03-28 14:58:31 -0700634 if sdkDep.useFiles {
Colin Cross86a60ae2018-05-29 14:44:55 -0700635 sharedLibs = append(sharedLibs, sdkDep.jars...)
Colin Crossa97c5d32018-03-28 14:58:31 -0700636 }
637
Colin Crossab8d1382023-07-14 17:23:41 +0000638 var resourcesNodeDepSets []*android.DepSet[*resourcesNode]
639 rroDirsDepSetBuilder := android.NewDepSetBuilder[rroDir](android.TOPOLOGICAL)
640 manifestsDepSetBuilder := android.NewDepSetBuilder[android.Path](android.TOPOLOGICAL)
641
Colin Crossa97c5d32018-03-28 14:58:31 -0700642 ctx.VisitDirectDeps(func(module android.Module) {
Ulya Trafimovich65b03192020-12-03 16:50:22 +0000643 depTag := ctx.OtherModuleDependencyTag(module)
Ulya Trafimovich18554242020-11-03 15:55:11 +0000644
Colin Crossa97c5d32018-03-28 14:58:31 -0700645 var exportPackage android.Path
Colin Cross66f78822018-05-02 12:58:28 -0700646 aarDep, _ := module.(AndroidLibraryDependency)
647 if aarDep != nil {
Colin Crossa97c5d32018-03-28 14:58:31 -0700648 exportPackage = aarDep.ExportPackage()
649 }
650
Ulya Trafimovich65b03192020-12-03 16:50:22 +0000651 switch depTag {
Colin Cross4b964c02018-10-15 16:18:06 -0700652 case instrumentationForTag:
653 // Nothing, instrumentationForTag is treated as libTag for javac but not for aapt2.
Liz Kammeref28a4c2022-09-23 16:50:56 -0400654 case sdkLibTag, libTag:
Colin Cross5446e882019-05-22 10:46:27 -0700655 if exportPackage != nil {
656 sharedLibs = append(sharedLibs, exportPackage)
657 }
Colin Cross5446e882019-05-22 10:46:27 -0700658 case frameworkResTag:
Colin Crossa97c5d32018-03-28 14:58:31 -0700659 if exportPackage != nil {
660 sharedLibs = append(sharedLibs, exportPackage)
661 }
662 case staticLibTag:
663 if exportPackage != nil {
Colin Crossab8d1382023-07-14 17:23:41 +0000664 resourcesNodeDepSets = append(resourcesNodeDepSets, aarDep.ResourcesNodeDepSet())
665 rroDirsDepSetBuilder.Transitive(aarDep.RRODirsDepSet())
666 manifestsDepSetBuilder.Transitive(aarDep.ManifestsDepSet())
Colin Crossa97c5d32018-03-28 14:58:31 -0700667 }
668 }
Ulya Trafimovich18554242020-11-03 15:55:11 +0000669
Ulya Trafimovich88bb6f62020-12-16 16:16:11 +0000670 addCLCFromDep(ctx, module, classLoaderContexts)
Colin Crossa97c5d32018-03-28 14:58:31 -0700671 })
672
Colin Crossab8d1382023-07-14 17:23:41 +0000673 // AAPT2 overlays are in lowest to highest priority order, the topological order will be reversed later.
674 // Reverse the dependency order now going into the depset so that it comes out in order after the second
675 // reverse later.
676 // NOTE: this is legacy and probably incorrect behavior, for most other cases (e.g. conflicting classes in
677 // dependencies) the highest priority dependency is listed first, but for resources the highest priority
678 // dependency has to be listed last.
679 staticResourcesNodes = android.NewDepSet(android.TOPOLOGICAL, nil,
680 android.ReverseSliceInPlace(resourcesNodeDepSets))
Colin Crossa97c5d32018-03-28 14:58:31 -0700681
Colin Crossab8d1382023-07-14 17:23:41 +0000682 staticRRODirs = rroDirsDepSetBuilder.Build()
683 staticManifests = manifestsDepSetBuilder.Build()
684
685 if len(staticResourcesNodes.ToList()) > 0 {
Colin Crossa97c5d32018-03-28 14:58:31 -0700686 flags = append(flags, "--auto-add-overlay")
687 }
688
689 for _, sharedLib := range sharedLibs {
690 flags = append(flags, "-I "+sharedLib.String())
691 }
692
Colin Crossab8d1382023-07-14 17:23:41 +0000693 return staticResourcesNodes, staticRRODirs, staticManifests, sharedLibs, flags
Colin Crossa97c5d32018-03-28 14:58:31 -0700694}
695
696type AndroidLibrary struct {
697 Library
698 aapt
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -0500699 android.BazelModuleBase
Colin Crossa97c5d32018-03-28 14:58:31 -0700700
701 androidLibraryProperties androidLibraryProperties
702
703 aarFile android.WritablePath
Colin Cross89c31582018-04-30 15:55:11 -0700704}
705
Saeid Farivar Asanjan1fca3012021-09-14 18:40:19 +0000706var _ android.OutputFileProducer = (*AndroidLibrary)(nil)
707
708// For OutputFileProducer interface
709func (a *AndroidLibrary) OutputFiles(tag string) (android.Paths, error) {
710 switch tag {
711 case ".aar":
712 return []android.Path{a.aarFile}, nil
713 default:
714 return a.Library.OutputFiles(tag)
715 }
716}
717
Colin Crossa97c5d32018-03-28 14:58:31 -0700718var _ AndroidLibraryDependency = (*AndroidLibrary)(nil)
719
720func (a *AndroidLibrary) DepsMutator(ctx android.BottomUpMutatorContext) {
721 a.Module.deps(ctx)
Jiyong Parkf1691d22021-03-29 20:11:58 +0900722 sdkDep := decodeSdkDep(ctx, android.SdkContext(a))
Paul Duffin250e6192019-06-07 10:44:37 +0100723 if sdkDep.hasFrameworkLibs() {
724 a.aapt.deps(ctx, sdkDep)
Colin Crossa97c5d32018-03-28 14:58:31 -0700725 }
Colin Cross4a80a152022-12-21 21:51:52 -0800726 a.usesLibrary.deps(ctx, false)
Colin Crossa97c5d32018-03-28 14:58:31 -0700727}
728
729func (a *AndroidLibrary) GenerateAndroidBuildActions(ctx android.ModuleContext) {
Colin Crosse4246ab2019-02-05 21:55:21 -0800730 a.aapt.isLibrary = true
Ulya Trafimovich42c7f0d2021-08-17 16:20:29 +0100731 a.classLoaderContexts = a.usesLibrary.classLoaderContextForUsesLibDeps(ctx)
Harshit Mahajan5b8b7302022-06-10 11:24:05 +0000732 a.aapt.buildActions(ctx, android.SdkContext(a), a.classLoaderContexts, nil, false)
Colin Crossa97c5d32018-03-28 14:58:31 -0700733
Colin Cross56a83212020-09-15 18:30:11 -0700734 a.hideApexVariantFromMake = !ctx.Provider(android.ApexInfoProvider).(android.ApexInfo).IsForPlatform()
735
Jihoon Kang1bfb6f22023-07-01 00:13:47 +0000736 a.stem = proptools.StringDefault(a.overridableDeviceProperties.Stem, ctx.ModuleName())
737
Colin Cross4eae06d2023-06-20 22:40:02 -0700738 ctx.CheckbuildFile(a.aapt.proguardOptionsFile)
739 ctx.CheckbuildFile(a.aapt.exportPackage)
Colin Cross4eae06d2023-06-20 22:40:02 -0700740 if a.useResourceProcessorBusyBox() {
741 ctx.CheckbuildFile(a.aapt.rJar)
Colin Crossf3b7bad2023-08-02 15:49:00 -0700742 } else {
743 ctx.CheckbuildFile(a.aapt.aaptSrcJar)
Colin Cross4eae06d2023-06-20 22:40:02 -0700744 }
Colin Crossa97c5d32018-03-28 14:58:31 -0700745
746 // apps manifests are handled by aapt, don't let Module see them
747 a.properties.Manifest = nil
748
Colin Cross014489c2020-06-02 20:09:13 -0700749 a.linter.mergedManifest = a.aapt.mergedManifestFile
750 a.linter.manifest = a.aapt.manifestPath
751 a.linter.resources = a.aapt.resourceFiles
752
Colin Crossa97c5d32018-03-28 14:58:31 -0700753 a.Module.extraProguardFlagFiles = append(a.Module.extraProguardFlagFiles,
754 a.proguardOptionsFile)
755
Colin Cross4eae06d2023-06-20 22:40:02 -0700756 var extraSrcJars android.Paths
757 var extraCombinedJars android.Paths
758 var extraClasspathJars android.Paths
759 if a.useResourceProcessorBusyBox() {
760 // When building a library with ResourceProcessorBusyBox enabled ResourceProcessorBusyBox for this
761 // library and each of the transitive static android_library dependencies has already created an
762 // R.class file for the appropriate package. Add all of those R.class files to the classpath.
763 extraClasspathJars = a.transitiveAaptRJars
764 } else {
765 // When building a library without ResourceProcessorBusyBox the aapt2 rule creates R.srcjar containing
766 // R.java files for the library's package and the packages from all transitive static android_library
767 // dependencies. Compile the srcjar alongside the rest of the sources.
768 extraSrcJars = android.Paths{a.aapt.aaptSrcJar}
769 }
770
771 a.Module.compile(ctx, extraSrcJars, extraClasspathJars, extraCombinedJars)
Colin Crossa97c5d32018-03-28 14:58:31 -0700772
Colin Crossf57c5782019-01-25 13:20:38 -0800773 a.aarFile = android.PathForModuleOut(ctx, ctx.ModuleName()+".aar")
Colin Crossa97c5d32018-03-28 14:58:31 -0700774 var res android.Paths
775 if a.androidLibraryProperties.BuildAAR {
776 BuildAAR(ctx, a.aarFile, a.outputFile, a.manifestPath, a.rTxt, res)
777 ctx.CheckbuildFile(a.aarFile)
778 }
Colin Cross89c31582018-04-30 15:55:11 -0700779
Cole Faust9a631312020-10-22 21:05:24 +0000780 a.exportedProguardFlagFiles = append(a.exportedProguardFlagFiles,
781 android.PathsForModuleSrc(ctx, a.dexProperties.Optimize.Proguard_flags_files)...)
Colin Crossab8d1382023-07-14 17:23:41 +0000782
Colin Cross89c31582018-04-30 15:55:11 -0700783 ctx.VisitDirectDeps(func(m android.Module) {
Jared Duke5979b302022-12-19 21:08:39 +0000784 if ctx.OtherModuleDependencyTag(m) == staticLibTag {
785 if lib, ok := m.(LibraryDependency); ok {
786 a.exportedProguardFlagFiles = append(a.exportedProguardFlagFiles, lib.ExportedProguardFlagFiles()...)
787 }
Colin Cross89c31582018-04-30 15:55:11 -0700788 }
789 })
Colin Cross89c31582018-04-30 15:55:11 -0700790 a.exportedProguardFlagFiles = android.FirstUniquePaths(a.exportedProguardFlagFiles)
Sam Delmerico82602492022-06-10 17:05:42 +0000791
792 prebuiltJniPackages := android.Paths{}
793 ctx.VisitDirectDeps(func(module android.Module) {
794 if info, ok := ctx.OtherModuleProvider(module, JniPackageProvider).(JniPackageInfo); ok {
795 prebuiltJniPackages = append(prebuiltJniPackages, info.JniPackages...)
796 }
797 })
798 if len(prebuiltJniPackages) > 0 {
799 ctx.SetProvider(JniPackageProvider, JniPackageInfo{
800 JniPackages: prebuiltJniPackages,
801 })
802 }
Colin Crossa97c5d32018-03-28 14:58:31 -0700803}
804
Colin Cross1b16b0e2019-02-12 14:41:32 -0800805// android_library builds and links sources into a `.jar` file for the device along with Android resources.
806//
807// An android_library has a single variant that produces a `.jar` file containing `.class` files that were
Sam Delmerico82602492022-06-10 17:05:42 +0000808// compiled against the device bootclasspath, along with a `package-res.apk` file containing Android resources compiled
Colin Cross1b16b0e2019-02-12 14:41:32 -0800809// with aapt2. This module is not suitable for installing on a device, but can be used as a `static_libs` dependency of
810// an android_app module.
Colin Crossa97c5d32018-03-28 14:58:31 -0700811func AndroidLibraryFactory() android.Module {
812 module := &AndroidLibrary{}
813
Colin Crossce6734e2020-06-15 16:09:53 -0700814 module.Module.addHostAndDeviceProperties()
Colin Crossa97c5d32018-03-28 14:58:31 -0700815 module.AddProperties(
Colin Crossa97c5d32018-03-28 14:58:31 -0700816 &module.aaptProperties,
817 &module.androidLibraryProperties)
818
819 module.androidLibraryProperties.BuildAAR = true
Colin Cross014489c2020-06-02 20:09:13 -0700820 module.Module.linter.library = true
Colin Crossa97c5d32018-03-28 14:58:31 -0700821
Jooyung Hanacc7bbe2020-05-20 09:06:00 +0900822 android.InitApexModule(module)
Colin Cross48de9a42018-10-02 13:53:33 -0700823 InitJavaModule(module, android.DeviceSupported)
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -0500824 android.InitBazelModule(module)
Colin Crossa97c5d32018-03-28 14:58:31 -0700825 return module
826}
827
Colin Crossfabb6082018-02-20 17:22:23 -0800828//
829// AAR (android library) prebuilts
830//
Colin Crossfabb6082018-02-20 17:22:23 -0800831
Vinh Trance0781f2022-04-13 01:30:44 +0000832// Properties for android_library_import
Colin Crossfabb6082018-02-20 17:22:23 -0800833type AARImportProperties struct {
Vinh Trance0781f2022-04-13 01:30:44 +0000834 // ARR (android library prebuilt) filepath. Exactly one ARR is required.
Colin Cross27b922f2019-03-04 22:35:41 -0800835 Aars []string `android:"path"`
Vinh Trance0781f2022-04-13 01:30:44 +0000836 // If not blank, set to the version of the sdk to compile against.
837 // Defaults to private.
838 // Values are of one of the following forms:
839 // 1) numerical API level, "current", "none", or "core_platform"
840 // 2) An SDK kind with an API level: "<sdk kind>_<API level>"
841 // See build/soong/android/sdk_version.go for the complete and up to date list of SDK kinds.
842 // If the SDK kind is empty, it will be set to public
843 Sdk_version *string
844 // If not blank, set the minimum version of the sdk that the compiled artifacts will run against.
845 // Defaults to sdk_version if not set. See sdk_version for possible values.
Colin Cross479884c2018-07-10 13:39:30 -0700846 Min_sdk_version *string
Vinh Trance0781f2022-04-13 01:30:44 +0000847 // List of java static libraries that the included ARR (android library prebuilts) has dependencies to.
Colin Crossa97c5d32018-03-28 14:58:31 -0700848 Static_libs []string
Vinh Trance0781f2022-04-13 01:30:44 +0000849 // List of java libraries that the included ARR (android library prebuilts) has dependencies to.
850 Libs []string
851 // If set to true, run Jetifier against .aar file. Defaults to false.
Colin Cross1001a792019-03-21 22:21:39 -0700852 Jetifier *bool
Sam Delmerico82602492022-06-10 17:05:42 +0000853 // If true, extract JNI libs from AAR archive. These libs will be accessible to android_app modules and
854 // will be passed transitively through android_libraries to an android_app.
855 //TODO(b/241138093) evaluate whether we can have this flag default to true for Bazel conversion
856 Extract_jni *bool
Colin Crossfabb6082018-02-20 17:22:23 -0800857}
858
859type AARImport struct {
860 android.ModuleBase
Colin Cross48de9a42018-10-02 13:53:33 -0700861 android.DefaultableModuleBase
Jooyung Hanacc7bbe2020-05-20 09:06:00 +0900862 android.ApexModuleBase
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -0500863 android.BazelModuleBase
Colin Crossfabb6082018-02-20 17:22:23 -0800864 prebuilt android.Prebuilt
865
Jooyung Hanacc7bbe2020-05-20 09:06:00 +0900866 // Functionality common to Module and Import.
867 embeddableInModuleAndImport
868
Sam Delmerico9f9c0a22022-11-29 11:19:37 -0500869 providesTransitiveHeaderJars
870
Colin Crossfabb6082018-02-20 17:22:23 -0800871 properties AARImportProperties
872
Colin Cross4eae06d2023-06-20 22:40:02 -0700873 classpathFile android.WritablePath
874 proguardFlags android.WritablePath
875 exportPackage android.WritablePath
876 transitiveAaptResourcePackages android.Paths
877 extraAaptPackagesFile android.WritablePath
878 manifest android.WritablePath
879 assetsPackage android.WritablePath
880 rTxt android.WritablePath
881 rJar android.WritablePath
Colin Cross66f78822018-05-02 12:58:28 -0700882
Colin Crossab8d1382023-07-14 17:23:41 +0000883 resourcesNodesDepSet *android.DepSet[*resourcesNode]
884 manifestsDepSet *android.DepSet[android.Path]
Colin Cross56a83212020-09-15 18:30:11 -0700885
886 hideApexVariantFromMake bool
Saeid Farivar Asanjanf0436962020-10-05 19:09:09 +0000887
Sam Delmerico82602492022-06-10 17:05:42 +0000888 aarPath android.Path
889 jniPackages android.Paths
Jiyong Park92315372021-04-02 08:45:46 +0900890
891 sdkVersion android.SdkSpec
Spandan Das8c9ae7e2023-03-03 21:20:36 +0000892 minSdkVersion android.ApiLevel
Saeid Farivar Asanjanf0436962020-10-05 19:09:09 +0000893}
894
895var _ android.OutputFileProducer = (*AARImport)(nil)
896
897// For OutputFileProducer interface
898func (a *AARImport) OutputFiles(tag string) (android.Paths, error) {
899 switch tag {
900 case ".aar":
901 return []android.Path{a.aarPath}, nil
902 case "":
903 return []android.Path{a.classpathFile}, nil
904 default:
905 return nil, fmt.Errorf("unsupported module reference tag %q", tag)
906 }
Colin Crossfabb6082018-02-20 17:22:23 -0800907}
908
Jiyong Park92315372021-04-02 08:45:46 +0900909func (a *AARImport) SdkVersion(ctx android.EarlyModuleContext) android.SdkSpec {
910 return android.SdkSpecFrom(ctx, String(a.properties.Sdk_version))
Colin Cross83bb3162018-06-25 15:48:06 -0700911}
912
Jiyong Parkf1691d22021-03-29 20:11:58 +0900913func (a *AARImport) SystemModules() string {
Paul Duffine25c6442019-10-11 13:50:28 +0100914 return ""
915}
916
Spandan Das8c9ae7e2023-03-03 21:20:36 +0000917func (a *AARImport) MinSdkVersion(ctx android.EarlyModuleContext) android.ApiLevel {
Colin Cross479884c2018-07-10 13:39:30 -0700918 if a.properties.Min_sdk_version != nil {
Spandan Das8c9ae7e2023-03-03 21:20:36 +0000919 return android.ApiLevelFrom(ctx, *a.properties.Min_sdk_version)
Colin Cross479884c2018-07-10 13:39:30 -0700920 }
Spandan Das8c9ae7e2023-03-03 21:20:36 +0000921 return a.SdkVersion(ctx).ApiLevel
Colin Cross83bb3162018-06-25 15:48:06 -0700922}
923
Spandan Dasa26eda72023-03-02 00:56:06 +0000924func (a *AARImport) ReplaceMaxSdkVersionPlaceholder(ctx android.EarlyModuleContext) android.ApiLevel {
925 return android.SdkSpecFrom(ctx, "").ApiLevel
William Loh5a082f92022-05-17 20:21:50 +0000926}
927
Spandan Dasca70fc42023-03-01 23:38:49 +0000928func (a *AARImport) TargetSdkVersion(ctx android.EarlyModuleContext) android.ApiLevel {
929 return a.SdkVersion(ctx).ApiLevel
Dan Willemsen419290a2018-10-31 15:28:47 -0700930}
931
Colin Cross1e743852019-10-28 11:37:20 -0700932func (a *AARImport) javaVersion() string {
933 return ""
934}
935
Colin Crossa97c5d32018-03-28 14:58:31 -0700936var _ AndroidLibraryDependency = (*AARImport)(nil)
937
938func (a *AARImport) ExportPackage() android.Path {
939 return a.exportPackage
940}
Colin Cross89c31582018-04-30 15:55:11 -0700941func (a *AARImport) ExportedProguardFlagFiles() android.Paths {
942 return android.Paths{a.proguardFlags}
943}
944
Colin Crossab8d1382023-07-14 17:23:41 +0000945func (a *AARImport) ResourcesNodeDepSet() *android.DepSet[*resourcesNode] {
946 return a.resourcesNodesDepSet
Colin Crossc1c37552019-01-31 11:42:41 -0800947}
948
Colin Crossab8d1382023-07-14 17:23:41 +0000949func (a *AARImport) RRODirsDepSet() *android.DepSet[rroDir] {
950 return android.NewDepSet[rroDir](android.TOPOLOGICAL, nil, nil)
Colin Cross66f78822018-05-02 12:58:28 -0700951}
952
Colin Crossab8d1382023-07-14 17:23:41 +0000953func (a *AARImport) ManifestsDepSet() *android.DepSet[android.Path] {
954 return a.manifestsDepSet
Jaewoong Jung6431ca72020-01-15 14:15:10 -0800955}
956
Jaewoong Jungc779cd42020-10-06 18:56:10 -0700957// RRO enforcement is not available on aar_import since its RRO dirs are not
958// exported.
959func (a *AARImport) SetRROEnforcedForDependent(enforce bool) {
960}
961
962// RRO enforcement is not available on aar_import since its RRO dirs are not
963// exported.
964func (a *AARImport) IsRROEnforced(ctx android.BaseModuleContext) bool {
965 return false
966}
967
Colin Crossfabb6082018-02-20 17:22:23 -0800968func (a *AARImport) Prebuilt() *android.Prebuilt {
969 return &a.prebuilt
970}
971
972func (a *AARImport) Name() string {
973 return a.prebuilt.Name(a.ModuleBase.Name())
974}
975
Jiyong Park618922e2020-01-08 13:35:43 +0900976func (a *AARImport) JacocoReportClassesFile() android.Path {
977 return nil
978}
979
Colin Crossfabb6082018-02-20 17:22:23 -0800980func (a *AARImport) DepsMutator(ctx android.BottomUpMutatorContext) {
Jeongik Cha816a23a2020-07-08 01:09:23 +0900981 if !ctx.Config().AlwaysUsePrebuiltSdks() {
Jiyong Parkf1691d22021-03-29 20:11:58 +0900982 sdkDep := decodeSdkDep(ctx, android.SdkContext(a))
Colin Crossa97c5d32018-03-28 14:58:31 -0700983 if sdkDep.useModule && sdkDep.frameworkResModule != "" {
Colin Cross42d48b72018-08-29 14:10:52 -0700984 ctx.AddVariationDependencies(nil, frameworkResTag, sdkDep.frameworkResModule)
Colin Crossfabb6082018-02-20 17:22:23 -0800985 }
986 }
Colin Crossa97c5d32018-03-28 14:58:31 -0700987
Colin Cross42d48b72018-08-29 14:10:52 -0700988 ctx.AddVariationDependencies(nil, libTag, a.properties.Libs...)
989 ctx.AddVariationDependencies(nil, staticLibTag, a.properties.Static_libs...)
Colin Crossfabb6082018-02-20 17:22:23 -0800990}
991
Sam Delmerico82602492022-06-10 17:05:42 +0000992type JniPackageInfo struct {
993 // List of zip files containing JNI libraries
994 // Zip files should have directory structure jni/<arch>/*.so
995 JniPackages android.Paths
996}
997
998var JniPackageProvider = blueprint.NewProvider(JniPackageInfo{})
999
1000// Unzip an AAR and extract the JNI libs for $archString.
1001var extractJNI = pctx.AndroidStaticRule("extractJNI",
1002 blueprint.RuleParams{
1003 Command: `rm -rf $out $outDir && touch $out && ` +
1004 `unzip -qoDD -d $outDir $in "jni/${archString}/*" && ` +
1005 `jni_files=$$(find $outDir/jni -type f) && ` +
1006 // print error message if there are no JNI libs for this arch
1007 `[ -n "$$jni_files" ] || (echo "ERROR: no JNI libs found for arch ${archString}" && exit 1) && ` +
1008 `${config.SoongZipCmd} -o $out -P 'lib/${archString}' ` +
1009 `-C $outDir/jni/${archString} $$(echo $$jni_files | xargs -n1 printf " -f %s")`,
1010 CommandDeps: []string{"${config.SoongZipCmd}"},
1011 },
1012 "outDir", "archString")
1013
Colin Crossfabb6082018-02-20 17:22:23 -08001014// Unzip an AAR into its constituent files and directories. Any files in Outputs that don't exist in the AAR will be
Dan Willemsen304cfec2019-05-28 14:49:06 -07001015// touched to create an empty file. The res directory is not extracted, as it will be extracted in its own rule.
Colin Crossfabb6082018-02-20 17:22:23 -08001016var unzipAAR = pctx.AndroidStaticRule("unzipAAR",
1017 blueprint.RuleParams{
Dan Willemsen304cfec2019-05-28 14:49:06 -07001018 Command: `rm -rf $outDir && mkdir -p $outDir && ` +
Colin Cross205e9112020-08-06 13:20:17 -07001019 `unzip -qoDD -d $outDir $in && rm -rf $outDir/res && touch $out && ` +
Michael Rosenfeld5ad15572021-12-03 13:25:10 -08001020 `${config.Zip2ZipCmd} -i $in -o $assetsPackage 'assets/**/*' && ` +
Colin Cross205e9112020-08-06 13:20:17 -07001021 `${config.MergeZipsCmd} $combinedClassesJar $$(ls $outDir/classes.jar 2> /dev/null) $$(ls $outDir/libs/*.jar 2> /dev/null)`,
Michael Rosenfeld5ad15572021-12-03 13:25:10 -08001022 CommandDeps: []string{"${config.MergeZipsCmd}", "${config.Zip2ZipCmd}"},
Colin Crossfabb6082018-02-20 17:22:23 -08001023 },
Michael Rosenfeld5ad15572021-12-03 13:25:10 -08001024 "outDir", "combinedClassesJar", "assetsPackage")
Colin Crossfabb6082018-02-20 17:22:23 -08001025
1026func (a *AARImport) GenerateAndroidBuildActions(ctx android.ModuleContext) {
1027 if len(a.properties.Aars) != 1 {
1028 ctx.PropertyErrorf("aars", "exactly one aar is required")
1029 return
1030 }
1031
Jiyong Park92315372021-04-02 08:45:46 +09001032 a.sdkVersion = a.SdkVersion(ctx)
1033 a.minSdkVersion = a.MinSdkVersion(ctx)
1034
Colin Cross56a83212020-09-15 18:30:11 -07001035 a.hideApexVariantFromMake = !ctx.Provider(android.ApexInfoProvider).(android.ApexInfo).IsForPlatform()
1036
Nan Zhang4c819fb2018-08-27 18:31:46 -07001037 aarName := ctx.ModuleName() + ".aar"
Saeid Farivar Asanjanf0436962020-10-05 19:09:09 +00001038 a.aarPath = android.PathForModuleSrc(ctx, a.properties.Aars[0])
1039
Colin Cross1001a792019-03-21 22:21:39 -07001040 if Bool(a.properties.Jetifier) {
Saeid Farivar Asanjanf0436962020-10-05 19:09:09 +00001041 inputFile := a.aarPath
1042 a.aarPath = android.PathForModuleOut(ctx, "jetifier", aarName)
1043 TransformJetifier(ctx, a.aarPath.(android.WritablePath), inputFile)
Nan Zhang4c819fb2018-08-27 18:31:46 -07001044 }
Colin Crossfabb6082018-02-20 17:22:23 -08001045
1046 extractedAARDir := android.PathForModuleOut(ctx, "aar")
Colin Cross205e9112020-08-06 13:20:17 -07001047 a.classpathFile = extractedAARDir.Join(ctx, "classes-combined.jar")
Colin Crossfabb6082018-02-20 17:22:23 -08001048 a.proguardFlags = extractedAARDir.Join(ctx, "proguard.txt")
Colin Cross10f7c4a2018-05-23 10:59:28 -07001049 a.manifest = extractedAARDir.Join(ctx, "AndroidManifest.xml")
Colin Cross4eae06d2023-06-20 22:40:02 -07001050 aarRTxt := extractedAARDir.Join(ctx, "R.txt")
Michael Rosenfeld5ad15572021-12-03 13:25:10 -08001051 a.assetsPackage = android.PathForModuleOut(ctx, "assets.zip")
Colin Crossfabb6082018-02-20 17:22:23 -08001052
1053 ctx.Build(pctx, android.BuildParams{
1054 Rule: unzipAAR,
Saeid Farivar Asanjanf0436962020-10-05 19:09:09 +00001055 Input: a.aarPath,
Colin Cross4eae06d2023-06-20 22:40:02 -07001056 Outputs: android.WritablePaths{a.classpathFile, a.proguardFlags, a.manifest, a.assetsPackage, aarRTxt},
Colin Crossfabb6082018-02-20 17:22:23 -08001057 Description: "unzip AAR",
1058 Args: map[string]string{
Colin Cross205e9112020-08-06 13:20:17 -07001059 "outDir": extractedAARDir.String(),
1060 "combinedClassesJar": a.classpathFile.String(),
Michael Rosenfeld5ad15572021-12-03 13:25:10 -08001061 "assetsPackage": a.assetsPackage.String(),
Colin Crossfabb6082018-02-20 17:22:23 -08001062 },
1063 })
1064
Colin Crossa0ba2f52019-06-22 12:59:27 -07001065 // Always set --pseudo-localize, it will be stripped out later for release
1066 // builds that don't want it.
1067 compileFlags := []string{"--pseudo-localize"}
Colin Crossfabb6082018-02-20 17:22:23 -08001068 compiledResDir := android.PathForModuleOut(ctx, "flat-res")
Colin Crossfabb6082018-02-20 17:22:23 -08001069 flata := compiledResDir.Join(ctx, "gen_res.flata")
Saeid Farivar Asanjanf0436962020-10-05 19:09:09 +00001070 aapt2CompileZip(ctx, flata, a.aarPath, "res", compileFlags)
Colin Crossfabb6082018-02-20 17:22:23 -08001071
1072 a.exportPackage = android.PathForModuleOut(ctx, "package-res.apk")
Colin Crossfabb6082018-02-20 17:22:23 -08001073 proguardOptionsFile := android.PathForModuleGen(ctx, "proguard.options")
Colin Cross4eae06d2023-06-20 22:40:02 -07001074 a.rTxt = android.PathForModuleOut(ctx, "R.txt")
Colin Cross66f78822018-05-02 12:58:28 -07001075 a.extraAaptPackagesFile = android.PathForModuleOut(ctx, "extra_packages")
Colin Crossfabb6082018-02-20 17:22:23 -08001076
1077 var linkDeps android.Paths
1078
1079 linkFlags := []string{
1080 "--static-lib",
Colin Cross4eae06d2023-06-20 22:40:02 -07001081 "--merge-only",
Colin Crossfabb6082018-02-20 17:22:23 -08001082 "--auto-add-overlay",
1083 }
1084
Colin Cross10f7c4a2018-05-23 10:59:28 -07001085 linkFlags = append(linkFlags, "--manifest "+a.manifest.String())
1086 linkDeps = append(linkDeps, a.manifest)
Colin Crossfabb6082018-02-20 17:22:23 -08001087
Colin Crossab8d1382023-07-14 17:23:41 +00001088 staticResourcesNodesDepSet, staticRRODirsDepSet, staticManifestsDepSet, sharedLibs, libFlags :=
Jiyong Parkf1691d22021-03-29 20:11:58 +09001089 aaptLibs(ctx, android.SdkContext(a), nil)
Colin Cross31656952018-05-24 16:11:20 -07001090
Colin Crossab8d1382023-07-14 17:23:41 +00001091 _ = staticRRODirsDepSet
1092 staticDeps := transitiveAarDeps(staticResourcesNodesDepSet.ToList())
Colin Crossfabb6082018-02-20 17:22:23 -08001093
Colin Crossab8d1382023-07-14 17:23:41 +00001094 linkDeps = append(linkDeps, sharedLibs...)
Colin Cross4eae06d2023-06-20 22:40:02 -07001095 linkDeps = append(linkDeps, staticDeps.resPackages()...)
Colin Crossa97c5d32018-03-28 14:58:31 -07001096 linkFlags = append(linkFlags, libFlags...)
Colin Crossfabb6082018-02-20 17:22:23 -08001097
Colin Cross4eae06d2023-06-20 22:40:02 -07001098 overlayRes := android.Paths{flata}
1099
1100 // Treat static library dependencies of static libraries as imports.
1101 transitiveStaticLibs := staticDeps.resPackages()
1102 linkDeps = append(linkDeps, transitiveStaticLibs...)
1103 for _, staticLib := range transitiveStaticLibs {
1104 linkFlags = append(linkFlags, "-I "+staticLib.String())
1105 }
Colin Crossfabb6082018-02-20 17:22:23 -08001106
Colin Crossab8d1382023-07-14 17:23:41 +00001107 transitiveAssets := android.ReverseSliceInPlace(staticDeps.assets())
Colin Crossf3b7bad2023-08-02 15:49:00 -07001108 aapt2Link(ctx, a.exportPackage, nil, proguardOptionsFile, a.rTxt,
Jaewoong Jung6431ca72020-01-15 14:15:10 -08001109 linkFlags, linkDeps, nil, overlayRes, transitiveAssets, nil)
Colin Crossfabb6082018-02-20 17:22:23 -08001110
Colin Cross4eae06d2023-06-20 22:40:02 -07001111 a.rJar = android.PathForModuleOut(ctx, "busybox/R.jar")
1112 resourceProcessorBusyBoxGenerateBinaryR(ctx, a.rTxt, a.manifest, a.rJar, nil, true)
1113
Colin Crossf3b7bad2023-08-02 15:49:00 -07001114 aapt2ExtractExtraPackages(ctx, a.extraAaptPackagesFile, a.rJar)
1115
Colin Crossab8d1382023-07-14 17:23:41 +00001116 resourcesNodesDepSetBuilder := android.NewDepSetBuilder[*resourcesNode](android.TOPOLOGICAL)
1117 resourcesNodesDepSetBuilder.Direct(&resourcesNode{
1118 resPackage: a.exportPackage,
1119 manifest: a.manifest,
Colin Cross4eae06d2023-06-20 22:40:02 -07001120 rTxt: a.rTxt,
1121 rJar: a.rJar,
Colin Crossab8d1382023-07-14 17:23:41 +00001122 assets: android.OptionalPathForPath(a.assetsPackage),
Colin Cross4eae06d2023-06-20 22:40:02 -07001123
1124 usedResourceProcessor: true,
Colin Crossab8d1382023-07-14 17:23:41 +00001125 })
1126 resourcesNodesDepSetBuilder.Transitive(staticResourcesNodesDepSet)
1127 a.resourcesNodesDepSet = resourcesNodesDepSetBuilder.Build()
1128
1129 manifestDepSetBuilder := android.NewDepSetBuilder[android.Path](android.TOPOLOGICAL).Direct(a.manifest)
1130 // TODO(b/288358614): Soong has historically not merged manifests from dependencies of android_library_import
1131 // modules. Merging manifests from dependencies could remove the need for pom2bp to generate the "-nodeps" copies
1132 // of androidx libraries, but doing so triggers errors due to errors introduced by existing dependencies of
1133 // android_library_import modules. If this is fixed, AndroidLibraryDependency.ManifestsDepSet can be dropped
1134 // completely in favor of AndroidLibraryDependency.ResourceNodesDepSet.manifest
1135 //manifestDepSetBuilder.Transitive(transitiveStaticDeps.manifests)
1136 _ = staticManifestsDepSet
1137 a.manifestsDepSet = manifestDepSetBuilder.Build()
Michael Rosenfeld5ad15572021-12-03 13:25:10 -08001138
Colin Cross4eae06d2023-06-20 22:40:02 -07001139 a.transitiveAaptResourcePackages = staticDeps.resPackages()
1140
Sam Delmerico9f9c0a22022-11-29 11:19:37 -05001141 a.collectTransitiveHeaderJars(ctx)
Colin Crossdcf71b22021-02-01 13:59:03 -08001142 ctx.SetProvider(JavaInfoProvider, JavaInfo{
1143 HeaderJars: android.PathsIfNonNil(a.classpathFile),
Sam Delmerico9f9c0a22022-11-29 11:19:37 -05001144 TransitiveLibsHeaderJars: a.transitiveLibsHeaderJars,
1145 TransitiveStaticLibsHeaderJars: a.transitiveStaticLibsHeaderJars,
Colin Crossdcf71b22021-02-01 13:59:03 -08001146 ImplementationAndResourcesJars: android.PathsIfNonNil(a.classpathFile),
1147 ImplementationJars: android.PathsIfNonNil(a.classpathFile),
Joe Onorato6fe59eb2023-07-16 13:20:33 -07001148 // TransitiveAconfigFiles: // TODO(b/289117800): LOCAL_ACONFIG_FILES for prebuilts
Colin Crossdcf71b22021-02-01 13:59:03 -08001149 })
Sam Delmerico82602492022-06-10 17:05:42 +00001150
1151 if proptools.Bool(a.properties.Extract_jni) {
1152 for _, t := range ctx.MultiTargets() {
1153 arch := t.Arch.Abi[0]
1154 path := android.PathForModuleOut(ctx, arch+"_jni.zip")
1155 a.jniPackages = append(a.jniPackages, path)
1156
1157 outDir := android.PathForModuleOut(ctx, "aarForJni")
1158 aarPath := android.PathForModuleSrc(ctx, a.properties.Aars[0])
1159 ctx.Build(pctx, android.BuildParams{
1160 Rule: extractJNI,
1161 Input: aarPath,
1162 Outputs: android.WritablePaths{path},
1163 Description: "extract JNI from AAR",
1164 Args: map[string]string{
1165 "outDir": outDir.String(),
1166 "archString": arch,
1167 },
1168 })
1169 }
1170
1171 ctx.SetProvider(JniPackageProvider, JniPackageInfo{
1172 JniPackages: a.jniPackages,
1173 })
1174 }
Colin Crossdcf71b22021-02-01 13:59:03 -08001175}
Colin Crossfabb6082018-02-20 17:22:23 -08001176
1177func (a *AARImport) HeaderJars() android.Paths {
1178 return android.Paths{a.classpathFile}
1179}
1180
Colin Cross331a1212018-08-15 20:40:52 -07001181func (a *AARImport) ImplementationAndResourcesJars() android.Paths {
1182 return android.Paths{a.classpathFile}
1183}
1184
Ulyana Trafimovich5539e7b2020-06-04 14:08:17 +00001185func (a *AARImport) DexJarBuildPath() android.Path {
Colin Crossf24a22a2019-01-31 14:12:44 -08001186 return nil
1187}
1188
Ulya Trafimovich9f3052c2020-06-09 14:31:19 +01001189func (a *AARImport) DexJarInstallPath() android.Path {
1190 return nil
1191}
1192
Ulya Trafimovichb23d28c2020-10-08 12:53:58 +01001193func (a *AARImport) ClassLoaderContexts() dexpreopt.ClassLoaderContextMap {
Jiyong Park1be96912018-05-28 18:02:19 +09001194 return nil
1195}
1196
Jiyong Park45bf82e2020-12-15 22:29:02 +09001197var _ android.ApexModule = (*AARImport)(nil)
1198
1199// Implements android.ApexModule
Jooyung Hanacc7bbe2020-05-20 09:06:00 +09001200func (a *AARImport) DepIsInSameApex(ctx android.BaseModuleContext, dep android.Module) bool {
1201 return a.depIsInSameApex(ctx, dep)
1202}
1203
Jiyong Park45bf82e2020-12-15 22:29:02 +09001204// Implements android.ApexModule
Dan Albertc8060532020-07-22 22:32:17 -07001205func (g *AARImport) ShouldSupportSdkVersion(ctx android.BaseModuleContext,
1206 sdkVersion android.ApiLevel) error {
Jooyung Han749dc692020-04-15 11:03:39 +09001207 return nil
1208}
1209
Sam Delmericoaf8bb702022-07-25 15:39:32 -04001210var _ android.PrebuiltInterface = (*AARImport)(nil)
Colin Crossfabb6082018-02-20 17:22:23 -08001211
Colin Cross1b16b0e2019-02-12 14:41:32 -08001212// android_library_import imports an `.aar` file into the build graph as if it was built with android_library.
1213//
1214// This module is not suitable for installing on a device, but can be used as a `static_libs` dependency of
1215// an android_app module.
Colin Crossfabb6082018-02-20 17:22:23 -08001216func AARImportFactory() android.Module {
1217 module := &AARImport{}
1218
1219 module.AddProperties(&module.properties)
1220
1221 android.InitPrebuiltModule(module, &module.properties.Aars)
Jooyung Hanacc7bbe2020-05-20 09:06:00 +09001222 android.InitApexModule(module)
Sam Delmerico82602492022-06-10 17:05:42 +00001223 InitJavaModuleMultiTargets(module, android.DeviceSupported)
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001224 android.InitBazelModule(module)
Colin Crossfabb6082018-02-20 17:22:23 -08001225 return module
1226}
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001227
1228type bazelAapt struct {
1229 Manifest bazel.Label
1230 Resource_files bazel.LabelListAttribute
1231}
1232
1233type bazelAndroidLibrary struct {
1234 *javaLibraryAttributes
1235 *bazelAapt
1236}
1237
1238type bazelAndroidLibraryImport struct {
Romain Jobredeaux2eef2e12023-02-24 12:07:08 -05001239 Aar bazel.Label
1240 Deps bazel.LabelListAttribute
1241 Exports bazel.LabelListAttribute
1242 Sdk_version bazel.StringAttribute
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001243}
1244
1245func (a *aapt) convertAaptAttrsWithBp2Build(ctx android.TopDownMutatorContext) *bazelAapt {
1246 manifest := proptools.StringDefault(a.aaptProperties.Manifest, "AndroidManifest.xml")
1247
1248 resourceFiles := bazel.LabelList{
1249 Includes: []bazel.Label{},
1250 }
1251 for _, dir := range android.PathsWithOptionalDefaultForModuleSrc(ctx, a.aaptProperties.Resource_dirs, "res") {
1252 files := android.RootToModuleRelativePaths(ctx, androidResourceGlob(ctx, dir))
1253 resourceFiles.Includes = append(resourceFiles.Includes, files...)
1254 }
1255 return &bazelAapt{
1256 android.BazelLabelForModuleSrcSingle(ctx, manifest),
1257 bazel.MakeLabelListAttribute(resourceFiles),
1258 }
1259}
1260
1261func (a *AARImport) ConvertWithBp2build(ctx android.TopDownMutatorContext) {
1262 aars := android.BazelLabelForModuleSrcExcludes(ctx, a.properties.Aars, []string{})
1263 exportableStaticLibs := []string{}
1264 // TODO(b/240716882): investigate and handle static_libs deps that are not imports. They are not supported for export by Bazel.
1265 for _, depName := range a.properties.Static_libs {
1266 if dep, ok := ctx.ModuleFromName(depName); ok {
1267 switch dep.(type) {
1268 case *AARImport, *Import:
1269 exportableStaticLibs = append(exportableStaticLibs, depName)
1270 }
1271 }
1272 }
1273 name := android.RemoveOptionalPrebuiltPrefix(a.Name())
1274 deps := android.BazelLabelForModuleDeps(ctx, android.LastUniqueStrings(android.CopyOf(append(a.properties.Static_libs, a.properties.Libs...))))
1275 exports := android.BazelLabelForModuleDeps(ctx, android.LastUniqueStrings(exportableStaticLibs))
1276
1277 ctx.CreateBazelTargetModule(
1278 bazel.BazelTargetModuleProperties{
1279 Rule_class: "aar_import",
Alixa381cd12023-05-10 14:49:38 +00001280 Bzl_load_location: "//build/bazel/rules/android:aar_import.bzl",
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001281 },
1282 android.CommonAttributes{Name: name},
1283 &bazelAndroidLibraryImport{
Romain Jobredeaux2eef2e12023-02-24 12:07:08 -05001284 Aar: aars.Includes[0],
1285 Deps: bazel.MakeLabelListAttribute(deps),
1286 Exports: bazel.MakeLabelListAttribute(exports),
1287 Sdk_version: bazel.StringAttribute{Value: a.properties.Sdk_version},
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001288 },
1289 )
1290
Alix14101de2023-01-06 03:42:07 +00001291 neverlink := true
1292 ctx.CreateBazelTargetModule(
Alix32540022023-03-16 21:06:13 +00001293 AndroidLibraryBazelTargetModuleProperties(),
Alix14101de2023-01-06 03:42:07 +00001294 android.CommonAttributes{Name: name + "-neverlink"},
1295 &bazelAndroidLibrary{
1296 javaLibraryAttributes: &javaLibraryAttributes{
1297 Neverlink: bazel.BoolAttribute{Value: &neverlink},
1298 Exports: bazel.MakeSingleLabelListAttribute(bazel.Label{Label: ":" + name}),
Romain Jobredeaux2eef2e12023-02-24 12:07:08 -05001299 javaCommonAttributes: &javaCommonAttributes{
1300 Sdk_version: bazel.StringAttribute{Value: a.properties.Sdk_version},
1301 },
Alix14101de2023-01-06 03:42:07 +00001302 },
1303 },
1304 )
1305
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001306}
Alix32540022023-03-16 21:06:13 +00001307func AndroidLibraryBazelTargetModuleProperties() bazel.BazelTargetModuleProperties {
1308 return bazel.BazelTargetModuleProperties{
1309 Rule_class: "android_library",
Alixa381cd12023-05-10 14:49:38 +00001310 Bzl_load_location: "//build/bazel/rules/android:android_library.bzl",
Alix32540022023-03-16 21:06:13 +00001311 }
1312}
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001313
1314func (a *AndroidLibrary) ConvertWithBp2build(ctx android.TopDownMutatorContext) {
Alix8062f4d2022-11-14 21:38:07 +00001315 commonAttrs, bp2buildInfo := a.convertLibraryAttrsBp2Build(ctx)
1316 depLabels := bp2buildInfo.DepLabels
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001317
1318 deps := depLabels.Deps
1319 if !commonAttrs.Srcs.IsEmpty() {
1320 deps.Append(depLabels.StaticDeps) // we should only append these if there are sources to use them
1321 } else if !depLabels.Deps.IsEmpty() {
1322 ctx.ModuleErrorf("Module has direct dependencies but no sources. Bazel will not allow this.")
1323 }
Alix82fb94e2022-10-26 20:40:18 +00001324 name := a.Name()
Alix32540022023-03-16 21:06:13 +00001325 props := AndroidLibraryBazelTargetModuleProperties()
Alix82fb94e2022-10-26 20:40:18 +00001326
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001327 ctx.CreateBazelTargetModule(
Alix82fb94e2022-10-26 20:40:18 +00001328 props,
1329 android.CommonAttributes{Name: name},
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001330 &bazelAndroidLibrary{
1331 &javaLibraryAttributes{
1332 javaCommonAttributes: commonAttrs,
1333 Deps: deps,
1334 Exports: depLabels.StaticDeps,
1335 },
1336 a.convertAaptAttrsWithBp2Build(ctx),
1337 },
1338 )
Alix82fb94e2022-10-26 20:40:18 +00001339
1340 neverlink := true
1341 ctx.CreateBazelTargetModule(
1342 props,
1343 android.CommonAttributes{Name: name + "-neverlink"},
1344 &bazelAndroidLibrary{
1345 javaLibraryAttributes: &javaLibraryAttributes{
1346 Neverlink: bazel.BoolAttribute{Value: &neverlink},
1347 Exports: bazel.MakeSingleLabelListAttribute(bazel.Label{Label: ":" + name}),
Romain Jobredeaux2eef2e12023-02-24 12:07:08 -05001348 javaCommonAttributes: &javaCommonAttributes{
1349 Sdk_version: bazel.StringAttribute{Value: a.deviceProperties.Sdk_version},
1350 Java_version: bazel.StringAttribute{Value: a.properties.Java_version},
1351 },
Alix82fb94e2022-10-26 20:40:18 +00001352 },
1353 },
1354 )
Romain Jobredeauxc9b2bba2022-02-15 09:35:07 -05001355}