Recipes for AGP version 9.0

This branch contains recipes compatible with AGP 9.0. If you want to find recipes for other AGP versions, switch to the corresponding agp-* branch.

This branch is read only. Contributions are only accepted on the studio-main branch. See CONTRIBUTION.md there.

Recipes Index

Index is organized in categories, offering different ways to reach the recipe you want.

Themes

• Android Assets - legacyTaskBridging, addGeneratedSourceFolder
• Android Manifest - createSingleArtifact, Transform Manifest (Meta-data), perVariantManifestPlaceholder
• Artifact API - createSingleArtifact, listenToArtifacts, listenToMultipleArtifact, getMultipleArtifact, appendToScopedArtifacts, Transform Manifest (Meta-data), transformMultiple, transformAllClasses, appendToMultipleArtifact, addMultipleArtifact, transformDirectory, getSingleArtifact, workerEnabledTransformation, getScopedArtifacts
• DSL - extendingAgp, addBuildTypeUsingDslFinalize
• Dependency Resolution - variantDependencySubstitutionTest
• Sources - legacyTaskBridging, addCustomSourceType, addGeneratedSourceFolder

Plugin Features

• Fused Library Plugin - applyFusedLibraryPlugin
• Kotlin Multiplatform - kotlinMultiplatformLibrary
• TestFixtures - testFixtures

APIs

• AndroidComponentsExtension.beforeVariants() - disableTests, selectVariants
• AndroidComponentsExtension.onVariants() - allProjectsApkAction, registerPreBuild, createSingleArtifact, disableTests, extendingAgp, listenToArtifacts, listenToMultipleArtifact, asmTransformClasses, legacyTaskBridging, addCustomSourceType, getMultipleArtifact, variantDependencySubstitutionTest, appendToScopedArtifacts, onVariants, addGeneratedSourceFolder, Transform Manifest (Meta-data), variantOutput, perVariantManifestPlaceholder, transformMultiple, transformAllClasses, appendToMultipleArtifact, addMultipleArtifact, transformDirectory, addCustomBuildConfigFields, getSingleArtifact, workerEnabledTransformation, getScopedArtifacts
• AndroidComponentsExtension.registerExtension() - extendingAgp
• AndroidComponentsExtension.selector() - allProjectsApkAction, variantOutput, selectVariants
• ApplicationVariant.applicationId - onVariants
• ApplicationVariant.outputs - variantOutput
• Artifact.ContainsMany - listenToArtifacts
• ArtifactTransformationRequest - workerEnabledTransformation
• Artifacts.add() - transformMultiple, addMultipleArtifact
• Artifacts.forScope() - appendToScopedArtifacts, transformAllClasses, getScopedArtifacts
• Artifacts.get() - allProjectsApkAction, legacyTaskBridging, addGeneratedSourceFolder, Transform Manifest (Meta-data), variantOutput, perVariantManifestPlaceholder, transformMultiple, appendToMultipleArtifact, addMultipleArtifact, transformDirectory, getSingleArtifact
• Artifacts.getAll() - getMultipleArtifact
• Artifacts.use() - createSingleArtifact, listenToArtifacts, listenToMultipleArtifact, Transform Manifest (Meta-data), transformMultiple, appendToMultipleArtifact, transformDirectory, workerEnabledTransformation
• BuildConfigField() - addCustomBuildConfigFields
• BuiltArtifact - workerEnabledTransformation
• BuiltArtifact.versionCode - listenToArtifacts
• BuiltArtifact.versionName - listenToArtifacts
• BuiltArtifacts.elements - listenToArtifacts
• BuiltArtifacts.variantName - listenToArtifacts
• BuiltArtifactsLoader.load() - listenToArtifacts
• CanMinifyAndroidResourcesBuilder.shrinkResources - selectVariants
• CanMinifyCodeBuilder.isMinifyEnabled - selectVariants
• CombiningOperationRequest.toTransform() - transformMultiple
• Component.artifacts - createSingleArtifact, legacyTaskBridging, getMultipleArtifact, appendToScopedArtifacts, addGeneratedSourceFolder, Transform Manifest (Meta-data), variantOutput, transformMultiple, appendToMultipleArtifact, addMultipleArtifact, transformDirectory, getScopedArtifacts
• Component.compileConfiguration - variantDependencySubstitutionTest
• Component.runtimeConfiguration - variantDependencySubstitutionTest
• Component.sources - legacyTaskBridging, addCustomSourceType, addGeneratedSourceFolder
• Configuration.resolutionStrategy - variantDependencySubstitutionTest
• DslExtension.Builder.build() - extendingAgp
• DslExtension.Builder.extendBuildTypeWith() - extendingAgp
• DslExtension.Builder.extendProductFlavorWith() - extendingAgp
• DslExtension.Builder.extendProjectWith() - extendingAgp
• DslLifecycle.finalizeDsl() - addBuildTypeUsingDslFinalize
• GeneratesApk.applicationId - onVariants
• Gradle.beforeProject() - allProjectsApkAction
• HasDeviceTests.deviceTests - disableTests
• HasDeviceTestsBuilder.deviceTests - disableTests
• HasHostTests.hostTests - disableTests
• HasHostTestsBuilder.hostTests - disableTests
• HasUnitTestBuilder.enableUnitTest - selectVariants
• InAndOutDirectoryOperationRequest.toTransform() - transformDirectory
• InAndOutDirectoryOperationRequest.toTransformMany() - workerEnabledTransformation
• InAndOutFileOperationRequest.toTransform() - Transform Manifest (Meta-data)
• Instrumentation.transformClassesWith() - asmTransformClasses
• LifeCycleTasks.registerPreBuild() - registerPreBuild
• MapProperty.put() - perVariantManifestPlaceholder, addCustomBuildConfigFields
• MultipleArtifact.MULTIDEX_KEEP_PROGUARD - getMultipleArtifact
• MultipleArtifact.NATIVE_DEBUG_METADATA - listenToMultipleArtifact, transformMultiple, appendToMultipleArtifact, addMultipleArtifact
• MultipleArtifactTypeOutOperationRequest.toListenTo() - listenToMultipleArtifact
• OutOperationRequest.toAppendTo() - appendToMultipleArtifact
• OutOperationRequest.toCreate() - createSingleArtifact
• OutOperationRequest.toListenTo() - listenToArtifacts
• Plugin - allProjectsApkAction
• ResolutionStrategy.dependencySubstitution() - variantDependencySubstitutionTest
• ScopedArtifact.CLASSES - asmTransformClasses, appendToScopedArtifacts, transformAllClasses, getScopedArtifacts
• ScopedArtifacts.Scope.ALL - appendToScopedArtifacts, getScopedArtifacts
• ScopedArtifacts.Scope.PROJECT - asmTransformClasses, appendToScopedArtifacts, transformAllClasses, getScopedArtifacts
• ScopedArtifacts.use() - asmTransformClasses, appendToScopedArtifacts, transformAllClasses, getScopedArtifacts
• ScopedArtifactsOperation.toAppend() - appendToScopedArtifacts
• ScopedArtifactsOperation.toGet() - asmTransformClasses, appendToScopedArtifacts, getScopedArtifacts
• ScopedArtifactsOperation.toTransform() - transformAllClasses
• SingleArtifact.APK - allProjectsApkAction, listenToArtifacts, workerEnabledTransformation
• SingleArtifact.ASSETS - legacyTaskBridging, addGeneratedSourceFolder, transformDirectory
• SingleArtifact.BUNDLE - appendToMultipleArtifact, addMultipleArtifact, getSingleArtifact
• SingleArtifact.MERGED_MANIFEST - createSingleArtifact, Transform Manifest (Meta-data), variantOutput, perVariantManifestPlaceholder
• SourceDirectories.addGeneratedSourceDirectory() - legacyTaskBridging, addCustomSourceType, addGeneratedSourceFolder
• SourceDirectories.addStaticSourceDirectory() - addCustomSourceType
• TaskBasedOperation.wiredWith() - createSingleArtifact, listenToArtifacts, transformMultiple
• TaskBasedOperation.wiredWithDirectories() - transformDirectory, workerEnabledTransformation
• TaskBasedOperation.wiredWithFiles() - Transform Manifest (Meta-data)
• TaskBasedOperation.wiredWithMultiple() - listenToMultipleArtifact
• TaskOutputs.upToDateWhen() - Transform Manifest (Meta-data)
• TaskProvider.flatMap() - createSingleArtifact
• TaskProvider.map() - addCustomBuildConfigFields
• Variant.buildConfigFields - addCustomBuildConfigFields
• Variant.components - variantDependencySubstitutionTest
• Variant.manifestPlaceholders - perVariantManifestPlaceholder
• Variant.nestedComponents - variantDependencySubstitutionTest
• VariantBuilder.minSdk - selectVariants
• VariantExtensionConfig - extendingAgp
• VariantOutput.versionCode - variantOutput
• VariantOutput.versionName - variantOutput
• VariantOutputConfiguration.OutputType.SINGLE - variantOutput
• VariantOutputConfiguration.outputType - variantOutput
• VariantSelector.all() - variantOutput, selectVariants
• VariantSelector.withBuildType() - allProjectsApkAction, variantDependencySubstitutionTest, selectVariants
• VariantSelector.withFlavor() - variantOutput, selectVariants
• VariantSelector.withName() - selectVariants
• task.getOutputs() - Transform Manifest (Meta-data)

Call chains

• DslExtension.Builder().extendProjectWith().extendBuildTypeWith().extendProductFlavorWith().build() - extendingAgp
• HasDeviceTests.deviceTests.get() - disableTests
• HasDeviceTestsBuilder.deviceTests.get().enable - disableTests
• HasHostTests.hostTests.get() - disableTests
• HasHostTestsBuilder.hostTests.get().enable - disableTests
• androidComponents.beforeVariants {} - disableTests, selectVariants
• androidComponents.finalizeDsl {} - addBuildTypeUsingDslFinalize
• androidComponents.onVariants {} - allProjectsApkAction, registerPreBuild, createSingleArtifact, disableTests, extendingAgp, listenToArtifacts, listenToMultipleArtifact, asmTransformClasses, legacyTaskBridging, addCustomSourceType, getMultipleArtifact, variantDependencySubstitutionTest, appendToScopedArtifacts, onVariants, addGeneratedSourceFolder, Transform Manifest (Meta-data), variantOutput, perVariantManifestPlaceholder, transformMultiple, transformAllClasses, appendToMultipleArtifact, addMultipleArtifact, transformDirectory, addCustomBuildConfigFields, getSingleArtifact, workerEnabledTransformation, getScopedArtifacts
• androidComponents.registerExtension() - extendingAgp
• androidComponents.selector().all() - variantOutput, selectVariants
• androidComponents.selector().withBuildType() - allProjectsApkAction, variantDependencySubstitutionTest, selectVariants
• androidComponents.selector().withFlavor() - variantOutput, selectVariants
• androidComponents.selector().withName() - selectVariants
• configuration.resolutionStrategy.dependencySubstitution {} - variantDependencySubstitutionTest
• settings.gradle.beforeProject {} - allProjectsApkAction
• substitute().using() - variantDependencySubstitutionTest
• task.outputs.upToDateWhen {} - Transform Manifest (Meta-data)
• transformationRequest.submit() - workerEnabledTransformation
• variant.applicationId - onVariants
• variant.artifacts.add() - transformMultiple, addMultipleArtifact
• variant.artifacts.forScope().use().toAppend() - appendToScopedArtifacts
• variant.artifacts.forScope().use().toGet() - asmTransformClasses, getScopedArtifacts
• variant.artifacts.forScope().use().toTransform() - transformAllClasses
• variant.artifacts.get() - allProjectsApkAction, asmTransformClasses, legacyTaskBridging, addGeneratedSourceFolder, Transform Manifest (Meta-data), variantOutput, perVariantManifestPlaceholder, transformMultiple, appendToMultipleArtifact, addMultipleArtifact, transformDirectory, getSingleArtifact
• variant.artifacts.getAll() - getMultipleArtifact
• variant.artifacts.use().wiredWith().toAppendTo() - appendToMultipleArtifact
• variant.artifacts.use().wiredWith().toCreate() - createSingleArtifact
• variant.artifacts.use().wiredWith().toListenTo() - listenToArtifacts, listenToMultipleArtifact
• variant.artifacts.use().wiredWith().toTransform() - transformMultiple
• variant.artifacts.use().wiredWithDirectories().toTransform() - transformDirectory
• variant.artifacts.use().wiredWithDirectories().toTransformMany() - workerEnabledTransformation
• variant.artifacts.use().wiredWithFiles().toTransform() - Transform Manifest (Meta-data)
• variant.buildConfigFields.put() - addCustomBuildConfigFields
• variant.instrumentation.transformClassesWith() - asmTransformClasses
• variant.manifestPlaceholders.put() - perVariantManifestPlaceholder
• variant.registerPreBuild() - registerPreBuild
• variant.sources.*.addGeneratedSourceDirectory() - legacyTaskBridging, addCustomSourceType, addGeneratedSourceFolder
• variant.sources.*.addStaticSourceDirectory() - addCustomSourceType
• variant.sources.*.all - addCustomSourceType, addGeneratedSourceFolder

Custom Tasks

• Manifest Transformation - Transform Manifest (Meta-data)

Others

• All projects - allProjectsApkAction
• DeviceTestBuilder.ANDROID_TEST_TYPE - disableTests
• Extending AGP DSL - extendingAgp
• HostTestBuilder.UNIT_TEST_TYPE - disableTests
• Legacy API bridging - legacyTaskBridging
• Placeholders - perVariantManifestPlaceholder
• Renaming APKs - listenToArtifacts
• SourceDirectories.Flat - addCustomSourceType
• SourceDirectories.Layered - addGeneratedSourceFolder
• SourceDirectories.add - addCustomSourceType
• registerSourceType - addCustomSourceType

License

Copyright 2022 The Android Open Source Project

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.