SafeArgsPlugin.kt
/*
* Copyright 2018 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package androidx.navigation.safeargs.gradle
import com.android.build.api.variant.AndroidComponentsExtension
import com.android.build.api.variant.DynamicFeatureVariant
import com.android.build.gradle.AppExtension
import com.android.build.gradle.BaseExtension
import com.android.build.gradle.LibraryExtension
import groovy.xml.XmlSlurper
import org.gradle.api.GradleException
import org.gradle.api.Plugin
import org.gradle.api.Project
import org.gradle.api.file.ConfigurableFileCollection
import org.gradle.api.provider.Provider
import org.gradle.api.provider.ProviderFactory
import org.jetbrains.kotlin.gradle.dsl.KotlinProjectExtension
import java.io.File
import java.util.Locale
import javax.inject.Inject
import org.jetbrains.kotlin.gradle.utils.property
private const val PLUGIN_DIRNAME = "navigation-args"
internal const val GENERATED_PATH = "generated/source/$PLUGIN_DIRNAME"
internal const val INCREMENTAL_PATH = "intermediates/incremental"
abstract class SafeArgsPlugin protected constructor(
val providerFactory: ProviderFactory
) : Plugin<Project> {
abstract val generateKotlin: Boolean
@Suppress("DEPRECATION") // For BaseVariant should be replaced in later studio versions
private fun forEachVariant(
extension: BaseExtension,
action: (com.android.build.gradle.api.BaseVariant) -> Unit
) {
when {
extension is AppExtension -> extension.applicationVariants.all(action)
extension is LibraryExtension -> {
extension.libraryVariants.all(action)
}
else -> throw GradleException(
"safeargs plugin must be used with android app," +
"library or feature plugin"
)
}
}
override fun apply(project: Project) {
val extension = project.extensions.findByType(BaseExtension::class.java)
?: throw GradleException("safeargs plugin must be used with android plugin")
val isKotlinProject =
project.extensions.findByType(KotlinProjectExtension::class.java) != null
if (!isKotlinProject && generateKotlin) {
throw GradleException(
"androidx.navigation.safeargs.kotlin plugin must be used with kotlin plugin"
)
}
val applicationIds = mutableMapOf<String, Provider<String>>()
val variantExtension =
project.extensions.findByType(AndroidComponentsExtension::class.java)
?: throw GradleException("safeargs plugin must be used with android plugin")
variantExtension.onVariants { variant ->
@Suppress("DEPRECATION") // For ApplicationVariant
when (variant) {
is com.android.build.gradle.api.ApplicationVariant ->
applicationIds.getOrPut(variant.name) {
variant.namespace
}
is DynamicFeatureVariant ->
applicationIds.getOrPut(variant.name) {
variant.applicationId
}
}
}
forEachVariant(extension) { variant ->
val task = project.tasks.create(
"generateSafeArgs${variant.name.replaceFirstChar {
if (it.isLowerCase()) it.titlecase(Locale.US) else it.toString()
}}",
ArgumentsGenerationTask::class.java
) { task ->
task.applicationId.set(
// this will only put in the case where the extension is a Library module
// and should be superseded by `getNamespace()` in agp 7.0+
applicationIds.getOrPut(variant.name) {
providerFactory.provider { variant.applicationId }
}
)
val rPackage = variant.rFilePackage(project)
task.rFilePackage.set(
// If a package name is available we use that by default to ensure we
// continue to support different productFlavors
if (rPackage.get().isNotEmpty()) {
rPackage
} else {
// otherwise, we fall back to the applicationId set on the task to ensure
// we support namespaces as well.
task.applicationId
}
)
task.navigationFiles.setFrom(navigationFiles(variant, project))
task.outputDir.set(File(project.buildDir, "$GENERATED_PATH/${variant.dirName}"))
task.incrementalFolder.set(File(project.buildDir, "$INCREMENTAL_PATH/${task.name}"))
task.useAndroidX.set(
(project.findProperty("android.useAndroidX") == "true").also {
if (!it) {
throw GradleException(
"androidx.navigation.safeargs can only be used with an androidx " +
"project"
)
}
}
)
task.generateKotlin.set(generateKotlin)
}
@Suppress("DEPRECATION") // For BaseVariant should be replaced in later studio versions
variant.registerJavaGeneratingTask(task, task.outputDir.asFile.get())
}
}
@Suppress("DEPRECATION") // For BaseVariant should be replaced in later studio versions
private fun com.android.build.gradle.api.BaseVariant.rFilePackage(
project: Project
): Provider<String> = project.objects.property(String::class.java).apply {
val mainSourceSet = sourceSets.find { it.name == "main" }
val sourceSet = mainSourceSet ?: sourceSets[0]
val manifest = sourceSet.manifestFile
val parsed = XmlSlurper(false, false).parse(manifest)
set(parsed.getProperty("@package").toString())
disallowChanges()
finalizeValueOnRead()
}
@Suppress("DEPRECATION") // For BaseVariant should be replaced in later studio versions
private fun navigationFiles(
variant: com.android.build.gradle.api.BaseVariant,
project: Project
): ConfigurableFileCollection {
val fileProvider = providerFactory.provider {
variant.sourceSets
.flatMap { it.resDirectories }
.mapNotNull {
File(it, "navigation").let { navFolder ->
if (navFolder.exists() && navFolder.isDirectory) navFolder else null
}
}
.flatMap { navFolder -> navFolder.listFiles().asIterable() }
.filter { file -> file.isFile }
.groupBy { file -> file.name }
.map { entry -> entry.value.last() }
}
return project.files(fileProvider)
}
}
@Suppress("unused")
class SafeArgsJavaPlugin @Inject constructor(
providerFactory: ProviderFactory
) : SafeArgsPlugin(providerFactory) {
override val generateKotlin = false
}
@Suppress("unused")
class SafeArgsKotlinPlugin @Inject constructor(
providerFactory: ProviderFactory
) : SafeArgsPlugin(providerFactory) {
override val generateKotlin = true
}