Skip to content

chore: add Kotlin DSL instructions to Android flavors guide #437

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bryanoltman merged 3 commits into from
Oct 29, 2025
Merged

chore: add Kotlin DSL instructions to Android flavors guide #437

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
671d7e6
chore: add Kotlin DSL instructions to Android flavors guide
bryanoltman Oct 14, 2025
4f12870
format
bryanoltman Oct 14, 2025
65ed73f
Merge branch 'main' into bo/android-flavors-kotlin-dsl
bryanoltman Oct 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 39 additions & 1 deletion src/content/docs/code-push/guides/flavors/android.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ sidebar:
order: 21
---

import { Tabs, TabItem } from '@astrojs/starlight/components';

This guide will walk through how to setup an app in which there are 2 deployment
flavors: `internal` and `stable`. It will cover how to validate a patch on the
internal flavor and then promote the patch to the stable flavor on Android.
Expand All @@ -30,7 +32,40 @@ Create a new project using `flutter create flavors`.

## Configure Flavors

Next, edit the `android/app/build.gradle` to contain two productFlavors:
<Tabs>

<TabItem value="kotlin" label="Kotlin DSL">

Next edit the `android/app/build.gradle.kts` to contain two productFlavors:

```diff
defaultConfig {
...
}

+ flavorDimensions += "track"
+ productFlavors {
+ create("internal") {
+ dimension = "track"
+ applicationIdSuffix = ".internal"
+ manifestPlaceholders["applicationLabel"] = "[Internal] Shorebird Example"
+ }
+ create("stable") {
+ dimension = "track"
+ manifestPlaceholders["applicationLabel"] = "Shorebird Example"
+ }
+ }

buildTypes {
...
}
```

</TabItem>

<TabItem value="groovy" label="Groovy DSL">

Next edit the `android/app/build.gradle` to contain two productFlavors:

```diff
defaultConfig {
Expand All @@ -55,6 +90,9 @@ buildTypes {
}
```

</TabItem>
</Tabs>

Lastly, edit `android/app/src/main/AndroidManifest.xml` to use the
`applicationLabel` so that we can differentiate the two apps easily:

Expand Down