BuildKonfig

Motivation

Passing values from Android/iOS or any other platform code should work, but it's a hassle.
Setting up Android to read values from properties and add those into BuildConfig, and do the equivalent in iOS?
Rather I'd like to do it once.

Usage

Requirements

• Kotlin 1.5.30 or later
• Kotlin Multiplatform Project
• Gradle 7 or later

Gradle Configuration

Simple configuration

• packageName Set the package name where BuildKonfig is being placed. Required.
• objectName Set the name of the generated object. Defaults to BuildKonfig.
• exposeObjectWithName Set the name of the generated object, and make it public.
• defaultConfigs Set values which you want to have in common. Required.

To generate BuildKonfig files, run generateBuildKonfig task.
This task will be automatically run upon execution of kotlin compile tasks.

Above configuration will generate following simple object.

// commonMain
package com.example.app

internal object BuildKonfig {
    val name: String = "value"
}

Configuring target dependent values

If you want to change value depending on your targets, you can use targetConfigs to define target-dependent values.

• packageName
  • Sets the package name where BuildKonfig is being placed. Required.
• objectName
  • Sets the name of the generated object. Defaults to BuildKonfig.
• exposeObjectWithName
  • Sets the name of the generated object, and make it public.
• defaultConfigs
  • Sets values which you want to have in common. Required.
• targetConfigs
  • Sets target specific values as closure. You can overwrite values specified in defaultConfigs.
• buildConfigField(type: String, name: String, value: String)
  • Adds new value or overwrite existing one.
• buildConfigField(type: String, name: String, value: String, nullable: Boolean = false, const: Boolean = false)
  • In addition to above method, this can configure nullable and const declarations.

Above configuration will generate following codes.

// commonMain
package com.example.app

internal expect object BuildKonfig {
    val name: String
    val nullableField: String?
}

// androidMain
package com.example.app

internal actual object BuildKonfig {
    actual val name: String = "value"
    actual val nullableField: String? = "NonNull-value"
    val name2: String = "value2"
}

// iosMain
package com.example.app

internal actual object BuildKonfig {
    actual val name: String = "valueForNative"
    actual val nullableField: String? = null
}

Product Flavor?

Yes(sort of).
Kotlin Multiplatform Project does not support product flavor. Kotlin/Native part of the project has release/debug distinction, but it's not global.
So to mimick product flavor capability of Android, we need to provide additional property in order to determine flavors.

Specify default flavor in your gradle.properties

# ROOT_DIR/gradle.properties
buildkonfig.flavor=dev

In a development phase you can change value in gradle.properties as you like.
In CI environment, you can pass value via CLI $ ./gradlew build -Pbuildkonfig.flavor=release

Overwriting Values

If you configure same field across multiple defaultConfigs and targetConfigs, flavored targetConfigs is the strongest.

Lefter the stronger.

Flavored TargetConfig > TargetConfig > Flavored DefaultConfig > DefaultConfig

HMPP Support

Supported Types

• String
• Int
• Long
• Float
• Boolean

Try out the sample

There are two samples; sample and sample-kts. As its name implies, sample-kts a Kotlin DSL sample, and the other is a traditional Groovy DSL.

Have a look at ./sample directory.

# Publish the latest version of the plugin to test maven repository(./build/localMaven)
$ ./gradlew publishAllPublicationsToTestMavenRepository -PRELEASE_SIGNING_ENABLED=false

# Try out the samples.
# BuildKonfig will be generated in ./sample/build/buildkonfig
$ ./gradlew -p sample generateBuildKonfig