blob: 96fd22d4878af7ae205dbe528876673c20f69d4d [file] [log] [blame]
Colin Cross30e076a2015-04-13 13:58:27 -07001// Copyright 2015 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
17// This file contains the module types for compiling Android apps.
18
19import (
Colin Cross43f08db2018-11-12 10:13:39 -080020 "path/filepath"
Colin Cross30e076a2015-04-13 13:58:27 -070021 "strings"
22
Colin Crossa4f08812018-10-02 22:03:40 -070023 "github.com/google/blueprint"
Colin Cross76b5f0c2017-08-29 16:02:06 -070024 "github.com/google/blueprint/proptools"
Colin Cross30e076a2015-04-13 13:58:27 -070025
Colin Cross635c3b02016-05-18 15:37:25 -070026 "android/soong/android"
Colin Crossa4f08812018-10-02 22:03:40 -070027 "android/soong/cc"
Colin Cross303e21f2018-08-07 16:49:25 -070028 "android/soong/tradefed"
Colin Cross30e076a2015-04-13 13:58:27 -070029)
30
Colin Cross3bc7ffa2017-11-22 16:19:37 -080031func init() {
Colin Cross5ab4e6d2017-11-22 16:20:45 -080032 android.RegisterModuleType("android_app", AndroidAppFactory)
Colin Crossae5caf52018-05-22 11:11:52 -070033 android.RegisterModuleType("android_test", AndroidTestFactory)
Colin Cross252fc6f2018-10-04 15:22:03 -070034 android.RegisterModuleType("android_test_helper_app", AndroidTestHelperAppFactory)
Colin Crossbd01e2a2018-10-04 15:21:03 -070035 android.RegisterModuleType("android_app_certificate", AndroidAppCertificateFactory)
Jaewoong Jung525443a2019-02-28 15:35:54 -080036 android.RegisterModuleType("override_android_app", OverrideAndroidAppModuleFactory)
Jaewoong Jungccbb3932019-04-15 09:48:31 -070037 android.RegisterModuleType("android_app_import", AndroidAppImportFactory)
Colin Cross3bc7ffa2017-11-22 16:19:37 -080038}
39
Colin Cross30e076a2015-04-13 13:58:27 -070040// AndroidManifest.xml merging
41// package splits
42
Colin Crossfabb6082018-02-20 17:22:23 -080043type appProperties struct {
Colin Crossbd01e2a2018-10-04 15:21:03 -070044 // Names of extra android_app_certificate modules to sign the apk with in the form ":module".
Colin Cross7d5136f2015-05-11 13:39:40 -070045 Additional_certificates []string
46
47 // If set, create package-export.apk, which other packages can
48 // use to get PRODUCT-agnostic resource data like IDs and type definitions.
Nan Zhangea568a42017-11-08 21:20:04 -080049 Export_package_resources *bool
Colin Cross7d5136f2015-05-11 13:39:40 -070050
Colin Cross16056062017-12-13 22:46:28 -080051 // Specifies that this app should be installed to the priv-app directory,
52 // where the system will grant it additional privileges not available to
53 // normal apps.
54 Privileged *bool
Colin Crossa97c5d32018-03-28 14:58:31 -070055
56 // list of resource labels to generate individual resource packages
57 Package_splits []string
Jason Monkd4122be2018-08-10 09:33:36 -040058
59 // Names of modules to be overridden. Listed modules can only be other binaries
60 // (in Make or Soong).
61 // This does not completely prevent installation of the overridden binaries, but if both
62 // binaries would be installed by default (in PRODUCT_PACKAGES) the other binary will be removed
63 // from PRODUCT_PACKAGES.
64 Overrides []string
Colin Crossa4f08812018-10-02 22:03:40 -070065
66 // list of native libraries that will be provided in or alongside the resulting jar
67 Jni_libs []string `android:"arch_variant"`
68
Colin Crosse4246ab2019-02-05 21:55:21 -080069 // Store native libraries uncompressed in the APK and set the android:extractNativeLibs="false" manifest
70 // flag so that they are used from inside the APK at runtime. Defaults to true for android_test modules unless
71 // sdk_version or min_sdk_version is set to a version that doesn't support it (<23), defaults to false for other
72 // module types where the native libraries are generally preinstalled outside the APK.
73 Use_embedded_native_libs *bool
Colin Cross46abdad2019-02-07 13:07:08 -080074
75 // Store dex files uncompressed in the APK and set the android:useEmbeddedDex="true" manifest attribute so that
76 // they are used from inside the APK at runtime.
77 Use_embedded_dex *bool
Colin Cross47fa9d32019-03-26 10:51:39 -070078
79 // Forces native libraries to always be packaged into the APK,
80 // Use_embedded_native_libs still selects whether they are stored uncompressed and aligned or compressed.
81 // True for android_test* modules.
82 AlwaysPackageNativeLibs bool `blueprint:"mutated"`
Colin Cross7d5136f2015-05-11 13:39:40 -070083}
84
Jaewoong Jung525443a2019-02-28 15:35:54 -080085// android_app properties that can be overridden by override_android_app
86type overridableAppProperties struct {
87 // The name of a certificate in the default certificate directory, blank to use the default product certificate,
88 // or an android_app_certificate module name in the form ":module".
89 Certificate *string
Jaewoong Jung6f373f62019-03-13 10:13:24 -070090
91 // the package name of this app. The package name in the manifest file is used if one was not given.
92 Package_name *string
Jaewoong Jung525443a2019-02-28 15:35:54 -080093}
94
Colin Cross30e076a2015-04-13 13:58:27 -070095type AndroidApp struct {
Colin Crossa97c5d32018-03-28 14:58:31 -070096 Library
97 aapt
Jaewoong Jung525443a2019-02-28 15:35:54 -080098 android.OverridableModuleBase
Colin Crossa97c5d32018-03-28 14:58:31 -070099
Jiyong Parkc00cbd92018-10-30 21:20:05 +0900100 certificate Certificate
Colin Cross30e076a2015-04-13 13:58:27 -0700101
Colin Crossfabb6082018-02-20 17:22:23 -0800102 appProperties appProperties
Colin Crossae5caf52018-05-22 11:11:52 -0700103
Jaewoong Jung525443a2019-02-28 15:35:54 -0800104 overridableAppProperties overridableAppProperties
105
Colin Crossa4f08812018-10-02 22:03:40 -0700106 installJniLibs []jniLib
Colin Crossf6237212018-10-29 23:14:58 -0700107
108 bundleFile android.Path
Jaewoong Jung9d22a912019-01-23 16:27:47 -0800109
110 // the install APK name is normally the same as the module name, but can be overridden with PRODUCT_PACKAGE_NAME_OVERRIDES.
111 installApkName string
Jaewoong Jung4102e5d2019-02-27 16:26:28 -0800112
113 additionalAaptFlags []string
Colin Crosse1731a52017-12-14 11:22:55 -0800114}
115
Colin Cross89c31582018-04-30 15:55:11 -0700116func (a *AndroidApp) ExportedProguardFlagFiles() android.Paths {
117 return nil
118}
119
Colin Cross66f78822018-05-02 12:58:28 -0700120func (a *AndroidApp) ExportedStaticPackages() android.Paths {
121 return nil
122}
123
Colin Crossa97c5d32018-03-28 14:58:31 -0700124var _ AndroidLibraryDependency = (*AndroidApp)(nil)
125
Jiyong Parkc00cbd92018-10-30 21:20:05 +0900126type Certificate struct {
127 Pem, Key android.Path
Colin Cross30e076a2015-04-13 13:58:27 -0700128}
129
Colin Cross46c9b8b2017-06-22 16:51:17 -0700130func (a *AndroidApp) DepsMutator(ctx android.BottomUpMutatorContext) {
131 a.Module.deps(ctx)
Colin Crossa4f08812018-10-02 22:03:40 -0700132
Colin Cross3bc7ffa2017-11-22 16:19:37 -0800133 if !Bool(a.properties.No_framework_libs) && !Bool(a.properties.No_standard_libs) {
Colin Cross83bb3162018-06-25 15:48:06 -0700134 a.aapt.deps(ctx, sdkContext(a))
Colin Cross30e076a2015-04-13 13:58:27 -0700135 }
Colin Crossa4f08812018-10-02 22:03:40 -0700136
137 for _, jniTarget := range ctx.MultiTargets() {
138 variation := []blueprint.Variation{
139 {Mutator: "arch", Variation: jniTarget.String()},
140 {Mutator: "link", Variation: "shared"},
141 }
142 tag := &jniDependencyTag{
143 target: jniTarget,
144 }
145 ctx.AddFarVariationDependencies(variation, tag, a.appProperties.Jni_libs...)
146 }
Colin Crossbd01e2a2018-10-04 15:21:03 -0700147
Jaewoong Jung2ad817c2019-01-18 14:27:16 -0800148 cert := android.SrcIsModule(a.getCertString(ctx))
Colin Crossbd01e2a2018-10-04 15:21:03 -0700149 if cert != "" {
150 ctx.AddDependency(ctx.Module(), certificateTag, cert)
151 }
152
153 for _, cert := range a.appProperties.Additional_certificates {
154 cert = android.SrcIsModule(cert)
155 if cert != "" {
156 ctx.AddDependency(ctx.Module(), certificateTag, cert)
157 } else {
158 ctx.PropertyErrorf("additional_certificates",
159 `must be names of android_app_certificate modules in the form ":module"`)
160 }
161 }
Colin Cross30e076a2015-04-13 13:58:27 -0700162}
163
Colin Cross46c9b8b2017-06-22 16:51:17 -0700164func (a *AndroidApp) GenerateAndroidBuildActions(ctx android.ModuleContext) {
Colin Crosse4246ab2019-02-05 21:55:21 -0800165 a.aapt.uncompressedJNI = a.shouldUncompressJNI(ctx)
Colin Cross46abdad2019-02-07 13:07:08 -0800166 a.aapt.useEmbeddedDex = Bool(a.appProperties.Use_embedded_dex)
Colin Crossae5caf52018-05-22 11:11:52 -0700167 a.generateAndroidBuildActions(ctx)
168}
169
Colin Crosse4246ab2019-02-05 21:55:21 -0800170// shouldUncompressJNI returns true if the native libraries should be stored in the APK uncompressed and the
171// extractNativeLibs application flag should be set to false in the manifest.
172func (a *AndroidApp) shouldUncompressJNI(ctx android.ModuleContext) bool {
173 minSdkVersion, err := sdkVersionToNumber(ctx, a.minSdkVersion())
174 if err != nil {
175 ctx.PropertyErrorf("min_sdk_version", "invalid value %q: %s", a.minSdkVersion(), err)
176 }
177
178 return minSdkVersion >= 23 && Bool(a.appProperties.Use_embedded_native_libs)
179}
180
Colin Cross43f08db2018-11-12 10:13:39 -0800181// Returns whether this module should have the dex file stored uncompressed in the APK.
182func (a *AndroidApp) shouldUncompressDex(ctx android.ModuleContext) bool {
Colin Cross46abdad2019-02-07 13:07:08 -0800183 if Bool(a.appProperties.Use_embedded_dex) {
184 return true
185 }
186
Colin Cross5a0dcd52018-10-05 14:20:06 -0700187 if ctx.Config().UnbundledBuild() {
Colin Cross43f08db2018-11-12 10:13:39 -0800188 return false
Colin Cross5a0dcd52018-10-05 14:20:06 -0700189 }
190
Colin Cross5a0dcd52018-10-05 14:20:06 -0700191 // Uncompress dex in APKs of privileged apps, and modules used by privileged apps.
Nicolas Geoffrayfa6e9ec2019-02-12 13:12:16 +0000192 if ctx.Config().UncompressPrivAppDex() &&
Colin Cross5a0dcd52018-10-05 14:20:06 -0700193 (Bool(a.appProperties.Privileged) ||
Nicolas Geoffrayfa6e9ec2019-02-12 13:12:16 +0000194 inList(ctx.ModuleName(), ctx.Config().ModulesLoadedByPrivilegedModules())) {
195 return true
196 }
197
198 // Uncompress if the dex files is preopted on /system.
199 if !a.dexpreopter.dexpreoptDisabled(ctx) && (ctx.Host() || !odexOnSystemOther(ctx, a.dexpreopter.installPath)) {
200 return true
201 }
202
203 return false
Colin Cross5a0dcd52018-10-05 14:20:06 -0700204}
205
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800206func (a *AndroidApp) aaptBuildActions(ctx android.ModuleContext) {
David Brazdild25060a2019-02-18 18:24:16 +0000207 a.aapt.usesNonSdkApis = Bool(a.Module.deviceProperties.Platform_apis)
208
Jaewoong Jungde4c02f2019-01-22 11:19:56 -0800209 aaptLinkFlags := []string{}
Colin Cross3bc7ffa2017-11-22 16:19:37 -0800210
Jaewoong Jungde4c02f2019-01-22 11:19:56 -0800211 // Add TARGET_AAPT_CHARACTERISTICS values to AAPT link flags if they exist and --product flags were not provided.
Colin Crosse78dcd32018-04-19 15:25:19 -0700212 hasProduct := false
213 for _, f := range a.aaptProperties.Aaptflags {
214 if strings.HasPrefix(f, "--product") {
215 hasProduct = true
Jaewoong Jungde4c02f2019-01-22 11:19:56 -0800216 break
Colin Crosse78dcd32018-04-19 15:25:19 -0700217 }
218 }
Colin Crosse78dcd32018-04-19 15:25:19 -0700219 if !hasProduct && len(ctx.Config().ProductAAPTCharacteristics()) > 0 {
Jaewoong Jungde4c02f2019-01-22 11:19:56 -0800220 aaptLinkFlags = append(aaptLinkFlags, "--product", ctx.Config().ProductAAPTCharacteristics())
Colin Crosse78dcd32018-04-19 15:25:19 -0700221 }
222
Dan Willemsen72be5902018-10-24 20:24:57 -0700223 if !Bool(a.aaptProperties.Aapt_include_all_resources) {
224 // Product AAPT config
225 for _, aaptConfig := range ctx.Config().ProductAAPTConfig() {
Jaewoong Jungde4c02f2019-01-22 11:19:56 -0800226 aaptLinkFlags = append(aaptLinkFlags, "-c", aaptConfig)
Dan Willemsen72be5902018-10-24 20:24:57 -0700227 }
Colin Crosse78dcd32018-04-19 15:25:19 -0700228
Dan Willemsen72be5902018-10-24 20:24:57 -0700229 // Product AAPT preferred config
230 if len(ctx.Config().ProductAAPTPreferredConfig()) > 0 {
Jaewoong Jungde4c02f2019-01-22 11:19:56 -0800231 aaptLinkFlags = append(aaptLinkFlags, "--preferred-density", ctx.Config().ProductAAPTPreferredConfig())
Dan Willemsen72be5902018-10-24 20:24:57 -0700232 }
Colin Crosse78dcd32018-04-19 15:25:19 -0700233 }
234
Jiyong Park7f67f482019-01-05 12:57:48 +0900235 manifestPackageName, overridden := ctx.DeviceConfig().OverrideManifestPackageNameFor(ctx.ModuleName())
Jaewoong Jung6f373f62019-03-13 10:13:24 -0700236 if overridden || a.overridableAppProperties.Package_name != nil {
237 // The product override variable has a priority over the package_name property.
238 if !overridden {
239 manifestPackageName = *a.overridableAppProperties.Package_name
240 }
Jaewoong Jungde4c02f2019-01-22 11:19:56 -0800241 aaptLinkFlags = append(aaptLinkFlags, "--rename-manifest-package "+manifestPackageName)
Jiyong Park7f67f482019-01-05 12:57:48 +0900242 }
243
Jaewoong Jung4102e5d2019-02-27 16:26:28 -0800244 aaptLinkFlags = append(aaptLinkFlags, a.additionalAaptFlags...)
245
Colin Crosse560c4a2019-03-19 16:03:11 -0700246 a.aapt.splitNames = a.appProperties.Package_splits
247
Jaewoong Jungde4c02f2019-01-22 11:19:56 -0800248 a.aapt.buildActions(ctx, sdkContext(a), aaptLinkFlags...)
Colin Cross30e076a2015-04-13 13:58:27 -0700249
Colin Cross46c9b8b2017-06-22 16:51:17 -0700250 // apps manifests are handled by aapt, don't let Module see them
Dan Willemsen34cc69e2015-09-23 15:26:20 -0700251 a.properties.Manifest = nil
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800252}
Colin Cross30e076a2015-04-13 13:58:27 -0700253
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800254func (a *AndroidApp) proguardBuildActions(ctx android.ModuleContext) {
Colin Cross89c31582018-04-30 15:55:11 -0700255 var staticLibProguardFlagFiles android.Paths
256 ctx.VisitDirectDeps(func(m android.Module) {
257 if lib, ok := m.(AndroidLibraryDependency); ok && ctx.OtherModuleDependencyTag(m) == staticLibTag {
258 staticLibProguardFlagFiles = append(staticLibProguardFlagFiles, lib.ExportedProguardFlagFiles()...)
259 }
260 })
261
262 staticLibProguardFlagFiles = android.FirstUniquePaths(staticLibProguardFlagFiles)
263
264 a.Module.extraProguardFlagFiles = append(a.Module.extraProguardFlagFiles, staticLibProguardFlagFiles...)
265 a.Module.extraProguardFlagFiles = append(a.Module.extraProguardFlagFiles, a.proguardOptionsFile)
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800266}
Colin Cross66dbc0b2017-12-28 12:23:20 -0800267
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800268func (a *AndroidApp) dexBuildActions(ctx android.ModuleContext) android.Path {
Colin Cross43f08db2018-11-12 10:13:39 -0800269
270 var installDir string
271 if ctx.ModuleName() == "framework-res" {
272 // framework-res.apk is installed as system/framework/framework-res.apk
273 installDir = "framework"
274 } else if Bool(a.appProperties.Privileged) {
Jaewoong Jung9d22a912019-01-23 16:27:47 -0800275 installDir = filepath.Join("priv-app", a.installApkName)
Colin Cross43f08db2018-11-12 10:13:39 -0800276 } else {
Jaewoong Jung9d22a912019-01-23 16:27:47 -0800277 installDir = filepath.Join("app", a.installApkName)
Colin Cross43f08db2018-11-12 10:13:39 -0800278 }
Jaewoong Jung9d22a912019-01-23 16:27:47 -0800279 a.dexpreopter.installPath = android.PathForModuleInstall(ctx, installDir, a.installApkName+".apk")
Nicolas Geoffrayfa6e9ec2019-02-12 13:12:16 +0000280 a.dexpreopter.isInstallable = Bool(a.properties.Installable)
281 a.dexpreopter.uncompressedDex = a.shouldUncompressDex(ctx)
282 a.deviceProperties.UncompressDex = a.dexpreopter.uncompressedDex
Colin Cross5a0dcd52018-10-05 14:20:06 -0700283
Colin Cross5ab4e6d2017-11-22 16:20:45 -0800284 if ctx.ModuleName() != "framework-res" {
285 a.Module.compile(ctx, a.aaptSrcJar)
286 }
Colin Cross30e076a2015-04-13 13:58:27 -0700287
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800288 return a.maybeStrippedDexJarFile
289}
Colin Cross3bc7ffa2017-11-22 16:19:37 -0800290
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800291func (a *AndroidApp) jniBuildActions(jniLibs []jniLib, ctx android.ModuleContext) android.WritablePath {
Colin Crossa4f08812018-10-02 22:03:40 -0700292 var jniJarFile android.WritablePath
Colin Crossa4f08812018-10-02 22:03:40 -0700293 if len(jniLibs) > 0 {
Colin Cross47fa9d32019-03-26 10:51:39 -0700294 embedJni := ctx.Config().UnbundledBuild() || Bool(a.appProperties.Use_embedded_native_libs) ||
295 a.appProperties.AlwaysPackageNativeLibs
Colin Crossa4f08812018-10-02 22:03:40 -0700296 if embedJni {
297 jniJarFile = android.PathForModuleOut(ctx, "jnilibs.zip")
Colin Crosse4246ab2019-02-05 21:55:21 -0800298 TransformJniLibsToJar(ctx, jniJarFile, jniLibs, a.shouldUncompressJNI(ctx))
Colin Crossa4f08812018-10-02 22:03:40 -0700299 } else {
300 a.installJniLibs = jniLibs
301 }
302 }
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800303 return jniJarFile
304}
Colin Crossa4f08812018-10-02 22:03:40 -0700305
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700306// Reads and prepends a main cert from the default cert dir if it hasn't been set already, i.e. it
307// isn't a cert module reference. Also checks and enforces system cert restriction if applicable.
308func processMainCert(m android.ModuleBase, certPropValue string, certificates []Certificate, ctx android.ModuleContext) []Certificate {
309 if android.SrcIsModule(certPropValue) == "" {
310 var mainCert Certificate
311 if certPropValue != "" {
312 defaultDir := ctx.Config().DefaultAppCertificateDir(ctx)
313 mainCert = Certificate{
314 defaultDir.Join(ctx, certPropValue+".x509.pem"),
315 defaultDir.Join(ctx, certPropValue+".pk8"),
316 }
317 } else {
318 pem, key := ctx.Config().DefaultAppCertificate(ctx)
319 mainCert = Certificate{pem, key}
Colin Crossbd01e2a2018-10-04 15:21:03 -0700320 }
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700321 certificates = append([]Certificate{mainCert}, certificates...)
Colin Crossbd01e2a2018-10-04 15:21:03 -0700322 }
323
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700324 if !m.Platform() {
325 certPath := certificates[0].Pem.String()
Jeongik Chac9464142019-01-07 12:07:27 +0900326 systemCertPath := ctx.Config().DefaultAppCertificateDir(ctx).String()
327 if strings.HasPrefix(certPath, systemCertPath) {
328 enforceSystemCert := ctx.Config().EnforceSystemCertificate()
329 whitelist := ctx.Config().EnforceSystemCertificateWhitelist()
330
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700331 if enforceSystemCert && !inList(m.Name(), whitelist) {
Jeongik Chac9464142019-01-07 12:07:27 +0900332 ctx.PropertyErrorf("certificate", "The module in product partition cannot be signed with certificate in system.")
333 }
334 }
335 }
336
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700337 return certificates
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800338}
339
340func (a *AndroidApp) generateAndroidBuildActions(ctx android.ModuleContext) {
Jaewoong Jung9d22a912019-01-23 16:27:47 -0800341 // Check if the install APK name needs to be overridden.
Jaewoong Jung525443a2019-02-28 15:35:54 -0800342 a.installApkName = ctx.DeviceConfig().OverridePackageNameFor(a.Name())
Jaewoong Jung9d22a912019-01-23 16:27:47 -0800343
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800344 // Process all building blocks, from AAPT to certificates.
345 a.aaptBuildActions(ctx)
346
347 a.proguardBuildActions(ctx)
348
349 dexJarFile := a.dexBuildActions(ctx)
350
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700351 jniLibs, certificateDeps := collectAppDeps(ctx)
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800352 jniJarFile := a.jniBuildActions(jniLibs, ctx)
353
354 if ctx.Failed() {
355 return
356 }
357
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700358 certificates := processMainCert(a.ModuleBase, a.getCertString(ctx), certificateDeps, ctx)
359 a.certificate = certificates[0]
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800360
361 // Build a final signed app package.
Jaewoong Jung525443a2019-02-28 15:35:54 -0800362 // TODO(jungjw): Consider changing this to installApkName.
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800363 packageFile := android.PathForModuleOut(ctx, ctx.ModuleName()+".apk")
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700364 CreateAndSignAppPackage(ctx, packageFile, a.exportPackage, jniJarFile, dexJarFile, certificates)
Colin Cross3bc7ffa2017-11-22 16:19:37 -0800365 a.outputFile = packageFile
366
Colin Crosse560c4a2019-03-19 16:03:11 -0700367 for _, split := range a.aapt.splits {
368 // Sign the split APKs
369 packageFile := android.PathForModuleOut(ctx, ctx.ModuleName()+"_"+split.suffix+".apk")
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700370 CreateAndSignAppPackage(ctx, packageFile, split.path, nil, nil, certificates)
Colin Crosse560c4a2019-03-19 16:03:11 -0700371 a.extraOutputFiles = append(a.extraOutputFiles, packageFile)
372 }
373
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800374 // Build an app bundle.
Colin Crossf6237212018-10-29 23:14:58 -0700375 bundleFile := android.PathForModuleOut(ctx, "base.zip")
376 BuildBundleModule(ctx, bundleFile, a.exportPackage, jniJarFile, dexJarFile)
377 a.bundleFile = bundleFile
378
Jaewoong Jung590b1ae2019-01-22 16:40:58 -0800379 // Install the app package.
Colin Crosse560c4a2019-03-19 16:03:11 -0700380 var installDir android.OutputPath
Colin Cross5ab4e6d2017-11-22 16:20:45 -0800381 if ctx.ModuleName() == "framework-res" {
382 // framework-res.apk is installed as system/framework/framework-res.apk
Colin Crosse560c4a2019-03-19 16:03:11 -0700383 installDir = android.PathForModuleInstall(ctx, "framework")
Colin Cross16056062017-12-13 22:46:28 -0800384 } else if Bool(a.appProperties.Privileged) {
Colin Crosse560c4a2019-03-19 16:03:11 -0700385 installDir = android.PathForModuleInstall(ctx, "priv-app", a.installApkName)
Colin Cross5ab4e6d2017-11-22 16:20:45 -0800386 } else {
Colin Crosse560c4a2019-03-19 16:03:11 -0700387 installDir = android.PathForModuleInstall(ctx, "app", a.installApkName)
388 }
389
390 ctx.InstallFile(installDir, a.installApkName+".apk", a.outputFile)
391 for _, split := range a.aapt.splits {
392 ctx.InstallFile(installDir, a.installApkName+"_"+split.suffix+".apk", split.path)
Colin Cross5ab4e6d2017-11-22 16:20:45 -0800393 }
Colin Cross30e076a2015-04-13 13:58:27 -0700394}
395
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700396func collectAppDeps(ctx android.ModuleContext) ([]jniLib, []Certificate) {
Colin Crossa4f08812018-10-02 22:03:40 -0700397 var jniLibs []jniLib
Jiyong Parkc00cbd92018-10-30 21:20:05 +0900398 var certificates []Certificate
Colin Crossa4f08812018-10-02 22:03:40 -0700399
400 ctx.VisitDirectDeps(func(module android.Module) {
401 otherName := ctx.OtherModuleName(module)
402 tag := ctx.OtherModuleDependencyTag(module)
403
404 if jniTag, ok := tag.(*jniDependencyTag); ok {
405 if dep, ok := module.(*cc.Module); ok {
406 lib := dep.OutputFile()
407 if lib.Valid() {
408 jniLibs = append(jniLibs, jniLib{
409 name: ctx.OtherModuleName(module),
410 path: lib.Path(),
411 target: jniTag.target,
412 })
413 } else {
414 ctx.ModuleErrorf("dependency %q missing output file", otherName)
415 }
416 } else {
417 ctx.ModuleErrorf("jni_libs dependency %q must be a cc library", otherName)
Colin Crossa4f08812018-10-02 22:03:40 -0700418 }
Colin Crossbd01e2a2018-10-04 15:21:03 -0700419 } else if tag == certificateTag {
420 if dep, ok := module.(*AndroidAppCertificate); ok {
Jiyong Parkc00cbd92018-10-30 21:20:05 +0900421 certificates = append(certificates, dep.Certificate)
Colin Crossbd01e2a2018-10-04 15:21:03 -0700422 } else {
423 ctx.ModuleErrorf("certificate dependency %q must be an android_app_certificate module", otherName)
424 }
Colin Crossa4f08812018-10-02 22:03:40 -0700425 }
426 })
427
Colin Crossbd01e2a2018-10-04 15:21:03 -0700428 return jniLibs, certificates
Colin Crossa4f08812018-10-02 22:03:40 -0700429}
430
Jaewoong Jung2ad817c2019-01-18 14:27:16 -0800431func (a *AndroidApp) getCertString(ctx android.BaseContext) string {
432 certificate, overridden := ctx.DeviceConfig().OverrideCertificateFor(ctx.ModuleName())
433 if overridden {
Jaewoong Jungacb6db32019-02-28 16:22:30 +0000434 return ":" + certificate
Jaewoong Jung2ad817c2019-01-18 14:27:16 -0800435 }
Jaewoong Jung525443a2019-02-28 15:35:54 -0800436 return String(a.overridableAppProperties.Certificate)
Jaewoong Jung2ad817c2019-01-18 14:27:16 -0800437}
438
Colin Cross1b16b0e2019-02-12 14:41:32 -0800439// android_app compiles sources and Android resources into an Android application package `.apk` file.
Colin Cross36242852017-06-23 15:06:31 -0700440func AndroidAppFactory() android.Module {
Colin Cross30e076a2015-04-13 13:58:27 -0700441 module := &AndroidApp{}
442
Sasha Smundak2057f822019-04-16 17:16:58 -0700443 module.Module.deviceProperties.Optimize.EnabledByDefault = true
Colin Cross66dbc0b2017-12-28 12:23:20 -0800444 module.Module.deviceProperties.Optimize.Shrink = proptools.BoolPtr(true)
445
Colin Crossae5caf52018-05-22 11:11:52 -0700446 module.Module.properties.Instrument = true
Colin Cross9ae1b922018-06-26 17:59:05 -0700447 module.Module.properties.Installable = proptools.BoolPtr(true)
Colin Crossae5caf52018-05-22 11:11:52 -0700448
Colin Cross36242852017-06-23 15:06:31 -0700449 module.AddProperties(
Colin Cross540eff82017-06-22 17:01:52 -0700450 &module.Module.properties,
451 &module.Module.deviceProperties,
Colin Cross43f08db2018-11-12 10:13:39 -0800452 &module.Module.dexpreoptProperties,
Colin Crossa97c5d32018-03-28 14:58:31 -0700453 &module.Module.protoProperties,
454 &module.aaptProperties,
Jaewoong Jung525443a2019-02-28 15:35:54 -0800455 &module.appProperties,
456 &module.overridableAppProperties)
Colin Cross36242852017-06-23 15:06:31 -0700457
Colin Crossa9d8bee2018-10-02 13:59:46 -0700458 module.Prefer32(func(ctx android.BaseModuleContext, base *android.ModuleBase, class android.OsClass) bool {
459 return class == android.Device && ctx.Config().DevicePrefer32BitApps()
460 })
461
Colin Crossa4f08812018-10-02 22:03:40 -0700462 android.InitAndroidMultiTargetsArchModule(module, android.DeviceSupported, android.MultilibCommon)
463 android.InitDefaultableModule(module)
Jaewoong Jung525443a2019-02-28 15:35:54 -0800464 android.InitOverridableModule(module, &module.appProperties.Overrides)
Colin Crossa4f08812018-10-02 22:03:40 -0700465
Colin Cross36242852017-06-23 15:06:31 -0700466 return module
Colin Cross30e076a2015-04-13 13:58:27 -0700467}
Colin Crossae5caf52018-05-22 11:11:52 -0700468
469type appTestProperties struct {
470 Instrumentation_for *string
471}
472
473type AndroidTest struct {
474 AndroidApp
475
476 appTestProperties appTestProperties
477
478 testProperties testProperties
Colin Cross303e21f2018-08-07 16:49:25 -0700479
480 testConfig android.Path
Colin Crossd96ca352018-08-10 16:06:24 -0700481 data android.Paths
Colin Crossae5caf52018-05-22 11:11:52 -0700482}
483
484func (a *AndroidTest) GenerateAndroidBuildActions(ctx android.ModuleContext) {
Jaewoong Jung4102e5d2019-02-27 16:26:28 -0800485 // Check if the instrumentation target package is overridden before generating build actions.
486 if a.appTestProperties.Instrumentation_for != nil {
487 manifestPackageName, overridden := ctx.DeviceConfig().OverrideManifestPackageNameFor(*a.appTestProperties.Instrumentation_for)
488 if overridden {
489 a.additionalAaptFlags = append(a.additionalAaptFlags, "--rename-instrumentation-target-package "+manifestPackageName)
490 }
491 }
Colin Crossae5caf52018-05-22 11:11:52 -0700492 a.generateAndroidBuildActions(ctx)
Colin Cross303e21f2018-08-07 16:49:25 -0700493
yangbill4f41bc22019-02-13 21:45:47 +0800494 a.testConfig = tradefed.AutoGenInstrumentationTestConfig(ctx, a.testProperties.Test_config, a.testProperties.Test_config_template, a.manifestPath, a.testProperties.Test_suites)
Colin Cross8a497952019-03-05 22:25:09 -0800495 a.data = android.PathsForModuleSrc(ctx, a.testProperties.Data)
Colin Cross303e21f2018-08-07 16:49:25 -0700496}
497
498func (a *AndroidTest) DepsMutator(ctx android.BottomUpMutatorContext) {
Colin Cross303e21f2018-08-07 16:49:25 -0700499 a.AndroidApp.DepsMutator(ctx)
Colin Cross4b964c02018-10-15 16:18:06 -0700500 if a.appTestProperties.Instrumentation_for != nil {
501 // The android_app dependency listed in instrumentation_for needs to be added to the classpath for javac,
502 // but not added to the aapt2 link includes like a normal android_app or android_library dependency, so
503 // use instrumentationForTag instead of libTag.
504 ctx.AddVariationDependencies(nil, instrumentationForTag, String(a.appTestProperties.Instrumentation_for))
505 }
Colin Crossae5caf52018-05-22 11:11:52 -0700506}
507
Colin Cross1b16b0e2019-02-12 14:41:32 -0800508// android_test compiles test sources and Android resources into an Android application package `.apk` file and
509// creates an `AndroidTest.xml` file to allow running the test with `atest` or a `TEST_MAPPING` file.
Colin Crossae5caf52018-05-22 11:11:52 -0700510func AndroidTestFactory() android.Module {
511 module := &AndroidTest{}
512
Sasha Smundak2057f822019-04-16 17:16:58 -0700513 module.Module.deviceProperties.Optimize.EnabledByDefault = true
Colin Cross5067db92018-09-17 16:46:35 -0700514
515 module.Module.properties.Instrument = true
Colin Cross9ae1b922018-06-26 17:59:05 -0700516 module.Module.properties.Installable = proptools.BoolPtr(true)
Colin Crosse4246ab2019-02-05 21:55:21 -0800517 module.appProperties.Use_embedded_native_libs = proptools.BoolPtr(true)
Colin Cross47fa9d32019-03-26 10:51:39 -0700518 module.appProperties.AlwaysPackageNativeLibs = true
Colin Cross43f08db2018-11-12 10:13:39 -0800519 module.Module.dexpreopter.isTest = true
Colin Crossae5caf52018-05-22 11:11:52 -0700520
521 module.AddProperties(
522 &module.Module.properties,
523 &module.Module.deviceProperties,
Colin Cross43f08db2018-11-12 10:13:39 -0800524 &module.Module.dexpreoptProperties,
Colin Crossae5caf52018-05-22 11:11:52 -0700525 &module.Module.protoProperties,
526 &module.aaptProperties,
527 &module.appProperties,
Dan Willemsenf5531d22018-07-16 17:21:19 -0700528 &module.appTestProperties,
Jaewoong Jung525443a2019-02-28 15:35:54 -0800529 &module.overridableAppProperties,
Dan Willemsenf5531d22018-07-16 17:21:19 -0700530 &module.testProperties)
Colin Crossae5caf52018-05-22 11:11:52 -0700531
Colin Crossa4f08812018-10-02 22:03:40 -0700532 android.InitAndroidMultiTargetsArchModule(module, android.DeviceSupported, android.MultilibCommon)
533 android.InitDefaultableModule(module)
Colin Crossae5caf52018-05-22 11:11:52 -0700534 return module
535}
Colin Crossbd01e2a2018-10-04 15:21:03 -0700536
Colin Cross252fc6f2018-10-04 15:22:03 -0700537type appTestHelperAppProperties struct {
538 // list of compatibility suites (for example "cts", "vts") that the module should be
539 // installed into.
540 Test_suites []string `android:"arch_variant"`
541}
542
543type AndroidTestHelperApp struct {
544 AndroidApp
545
546 appTestHelperAppProperties appTestHelperAppProperties
547}
548
Colin Cross1b16b0e2019-02-12 14:41:32 -0800549// android_test_helper_app compiles sources and Android resources into an Android application package `.apk` file that
550// will be used by tests, but does not produce an `AndroidTest.xml` file so the module will not be run directly as a
551// test.
Colin Cross252fc6f2018-10-04 15:22:03 -0700552func AndroidTestHelperAppFactory() android.Module {
553 module := &AndroidTestHelperApp{}
554
Sasha Smundak2057f822019-04-16 17:16:58 -0700555 module.Module.deviceProperties.Optimize.EnabledByDefault = true
Colin Cross252fc6f2018-10-04 15:22:03 -0700556
557 module.Module.properties.Installable = proptools.BoolPtr(true)
Colin Crosse4246ab2019-02-05 21:55:21 -0800558 module.appProperties.Use_embedded_native_libs = proptools.BoolPtr(true)
Colin Cross47fa9d32019-03-26 10:51:39 -0700559 module.appProperties.AlwaysPackageNativeLibs = true
Colin Cross43f08db2018-11-12 10:13:39 -0800560 module.Module.dexpreopter.isTest = true
Colin Cross252fc6f2018-10-04 15:22:03 -0700561
562 module.AddProperties(
563 &module.Module.properties,
564 &module.Module.deviceProperties,
Colin Cross43f08db2018-11-12 10:13:39 -0800565 &module.Module.dexpreoptProperties,
Colin Cross252fc6f2018-10-04 15:22:03 -0700566 &module.Module.protoProperties,
567 &module.aaptProperties,
568 &module.appProperties,
Jaewoong Jung525443a2019-02-28 15:35:54 -0800569 &module.appTestHelperAppProperties,
570 &module.overridableAppProperties)
Colin Cross252fc6f2018-10-04 15:22:03 -0700571
572 android.InitAndroidMultiTargetsArchModule(module, android.DeviceSupported, android.MultilibCommon)
573 android.InitDefaultableModule(module)
574 return module
575}
576
Colin Crossbd01e2a2018-10-04 15:21:03 -0700577type AndroidAppCertificate struct {
578 android.ModuleBase
579 properties AndroidAppCertificateProperties
Jiyong Parkc00cbd92018-10-30 21:20:05 +0900580 Certificate Certificate
Colin Crossbd01e2a2018-10-04 15:21:03 -0700581}
582
583type AndroidAppCertificateProperties struct {
584 // Name of the certificate files. Extensions .x509.pem and .pk8 will be added to the name.
585 Certificate *string
586}
587
Colin Cross1b16b0e2019-02-12 14:41:32 -0800588// android_app_certificate modules can be referenced by the certificates property of android_app modules to select
589// the signing key.
Colin Crossbd01e2a2018-10-04 15:21:03 -0700590func AndroidAppCertificateFactory() android.Module {
591 module := &AndroidAppCertificate{}
592 module.AddProperties(&module.properties)
593 android.InitAndroidModule(module)
594 return module
595}
596
Colin Crossbd01e2a2018-10-04 15:21:03 -0700597func (c *AndroidAppCertificate) GenerateAndroidBuildActions(ctx android.ModuleContext) {
598 cert := String(c.properties.Certificate)
Jiyong Parkc00cbd92018-10-30 21:20:05 +0900599 c.Certificate = Certificate{
Colin Crossbd01e2a2018-10-04 15:21:03 -0700600 android.PathForModuleSrc(ctx, cert+".x509.pem"),
601 android.PathForModuleSrc(ctx, cert+".pk8"),
602 }
603}
Jaewoong Jung525443a2019-02-28 15:35:54 -0800604
605type OverrideAndroidApp struct {
606 android.ModuleBase
607 android.OverrideModuleBase
608}
609
610func (i *OverrideAndroidApp) GenerateAndroidBuildActions(ctx android.ModuleContext) {
611 // All the overrides happen in the base module.
612 // TODO(jungjw): Check the base module type.
613}
614
615// override_android_app is used to create an android_app module based on another android_app by overriding
616// some of its properties.
617func OverrideAndroidAppModuleFactory() android.Module {
618 m := &OverrideAndroidApp{}
619 m.AddProperties(&overridableAppProperties{})
620
621 android.InitAndroidModule(m)
622 android.InitOverrideModule(m)
623 return m
624}
Jaewoong Jungccbb3932019-04-15 09:48:31 -0700625
626type AndroidAppImport struct {
627 android.ModuleBase
628 android.DefaultableModuleBase
629 prebuilt android.Prebuilt
630
631 properties AndroidAppImportProperties
632
633 outputFile android.Path
634 certificate *Certificate
635
636 dexpreopter
637}
638
639type AndroidAppImportProperties struct {
640 // A prebuilt apk to import
641 Apk string
642
643 // The name of a certificate in the default certificate directory, blank to use the default
644 // product certificate, or an android_app_certificate module name in the form ":module".
645 Certificate *string
646
647 // Set this flag to true if the prebuilt apk is already signed. The certificate property must not
648 // be set for presigned modules.
649 Presigned *bool
650
651 // Specifies that this app should be installed to the priv-app directory,
652 // where the system will grant it additional privileges not available to
653 // normal apps.
654 Privileged *bool
655
656 // Names of modules to be overridden. Listed modules can only be other binaries
657 // (in Make or Soong).
658 // This does not completely prevent installation of the overridden binaries, but if both
659 // binaries would be installed by default (in PRODUCT_PACKAGES) the other binary will be removed
660 // from PRODUCT_PACKAGES.
661 Overrides []string
662}
663
664func (a *AndroidAppImport) DepsMutator(ctx android.BottomUpMutatorContext) {
665 cert := android.SrcIsModule(String(a.properties.Certificate))
666 if cert != "" {
667 ctx.AddDependency(ctx.Module(), certificateTag, cert)
668 }
669}
670
671func (a *AndroidAppImport) uncompressEmbeddedJniLibs(
672 ctx android.ModuleContext, inputPath android.Path, outputPath android.OutputPath) {
673 rule := android.NewRuleBuilder()
674 rule.Command().
675 Textf(`if (zipinfo %s 'lib/*.so' 2>/dev/null | grep -v ' stor ' >/dev/null) ; then`, inputPath).
676 Tool(ctx.Config().HostToolPath(ctx, "zip2zip")).
677 FlagWithInput("-i ", inputPath).
678 FlagWithOutput("-o ", outputPath).
679 FlagWithArg("-0 ", "'lib/**/*.so'").
680 Textf(`; else cp -f %s %s; fi`, inputPath, outputPath)
681 rule.Build(pctx, ctx, "uncompress-embedded-jni-libs", "Uncompress embedded JIN libs")
682}
683
684func (a *AndroidAppImport) GenerateAndroidBuildActions(ctx android.ModuleContext) {
685 if String(a.properties.Certificate) == "" && !Bool(a.properties.Presigned) {
686 ctx.PropertyErrorf("certificate", "No certificate specified for prebuilt")
687 }
688 if String(a.properties.Certificate) != "" && Bool(a.properties.Presigned) {
689 ctx.PropertyErrorf("certificate", "Certificate can't be specified for presigned modules")
690 }
691
692 _, certificates := collectAppDeps(ctx)
693
694 // TODO: LOCAL_EXTRACT_APK/LOCAL_EXTRACT_DPI_APK
695 // TODO: LOCAL_DPI_VARIANTS
696 // TODO: LOCAL_PACKAGE_SPLITS
697
698 srcApk := a.prebuilt.SingleSourcePath(ctx)
699
700 // TODO: Install or embed JNI libraries
701
702 // Uncompress JNI libraries in the apk
703 jnisUncompressed := android.PathForModuleOut(ctx, "jnis-uncompressed", ctx.ModuleName()+".apk")
704 a.uncompressEmbeddedJniLibs(ctx, srcApk, jnisUncompressed.OutputPath)
705
706 // TODO: Uncompress dex if applicable
707
708 installDir := android.PathForModuleInstall(ctx, "app", a.BaseModuleName())
709 a.dexpreopter.installPath = installDir.Join(ctx, a.BaseModuleName()+".apk")
710 a.dexpreopter.isInstallable = true
711 a.dexpreopter.isPresignedPrebuilt = Bool(a.properties.Presigned)
712 dexOutput := a.dexpreopter.dexpreopt(ctx, jnisUncompressed)
713
714 // Sign or align the package
715 // TODO: Handle EXTERNAL
716 if !Bool(a.properties.Presigned) {
717 certificates = processMainCert(a.ModuleBase, *a.properties.Certificate, certificates, ctx)
718 if len(certificates) != 1 {
719 ctx.ModuleErrorf("Unexpected number of certificates were extracted: %q", certificates)
720 }
721 a.certificate = &certificates[0]
722 signed := android.PathForModuleOut(ctx, "signed", ctx.ModuleName()+".apk")
723 SignAppPackage(ctx, signed, dexOutput, certificates)
724 a.outputFile = signed
725 } else {
726 alignedApk := android.PathForModuleOut(ctx, "zip-aligned", ctx.ModuleName()+".apk")
727 TransformZipAlign(ctx, alignedApk, dexOutput)
728 a.outputFile = alignedApk
729 }
730
731 // TODO: Optionally compress the output apk.
732
733 ctx.InstallFile(installDir, a.BaseModuleName()+".apk", a.outputFile)
734
735 // TODO: androidmk converter jni libs
736}
737
738func (a *AndroidAppImport) Prebuilt() *android.Prebuilt {
739 return &a.prebuilt
740}
741
742func (a *AndroidAppImport) Name() string {
743 return a.prebuilt.Name(a.ModuleBase.Name())
744}
745
746// android_app_import imports a prebuilt apk with additional processing specified in the module.
747func AndroidAppImportFactory() android.Module {
748 module := &AndroidAppImport{}
749 module.AddProperties(&module.properties)
750 module.AddProperties(&module.dexpreoptProperties)
751
752 InitJavaModule(module, android.DeviceSupported)
753 android.InitSingleSourcePrebuiltModule(module, &module.properties.Apk)
754
755 return module
756}