Metadata¶

This page includes documentation for changing the app icon, version, package name, and app name.

Changing App Version¶

1
2
3
4
5
6

[versions]
...
app-version-major = "1"
app-version-minor = "0"
app-version-patch = "0"
...

We use a MAJOR.MINOR.PATCH scheme:

• Major → major changes, complete revamp
• Minor → small features or updates
• Patch → bug fixes

Version code is generated as:

(versionMajor * 10000) + (versionMinor * 100) + versionPatch

Example: 2.5.0 → 25000

On iOS, AppConfig.xcconfig is automatically synced from gradle/libs.versions.toml using a Run Script in Build Phases inside Xcode. The first build updates the file; subsequent builds use the updated version.

Platform Specific¶

Android¶

App Icon¶

You can generate an app icon using IconKitchen. Just upload your app icon, and it will generate all required icons.

After exporting, you will get a zip file. Extract it and copy all files from IconKitchen-Output/android/res/* to the androidApp/src/main/res/ folder.

Your Android app icon is now updated.

Removing Monochrome Mode¶

IconKitchen enables monochrome mode by default. If your icon isn't PNG, it can cause Play Store rejection. To disable monochrome mode, remove the following line:

1
2
3
4
5
6

<?xml version="1.0" encoding="utf-8"?>
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
  <background android:drawable="@mipmap/ic_launcher_background"/>
  <foreground android:drawable="@mipmap/ic_launcher_foreground"/>
  <monochrome android:drawable="@mipmap/ic_launcher_monochrome"/>
</adaptive-icon>

App Name¶

1
2
3
4
5

<resources>
    ...
    <string name="app_name">KmpStarter</string>
    ...
</resources>

Change KmpStarter to your app name.

Package Name¶

1
2
3
4
5
6
7
8

android {
    ...
    defaultConfig {
        ...
        applicationId = "com.kmpstarter"
        ...
    }
}

Change com.kmpstarter to your package name.

iOS¶

App Name¶

Use Xcode to change the app name:

Package Name¶

PRODUCT_BUNDLE_IDENTIFIER=com.kmpstarter.nativeapp

Change com.kmpstarter.nativeapp to your package name.

App Icon¶

You can create an app icon using IconComposer, which also gives the Apple Liquid Glass effect.

Step 0¶

Create the app icon using IconComposer:

Step 1¶

Export the app icon with the following settings to generate all variants: You’ll see exported icons like this:

Step 2¶

Open Xcode and go to Assets inside the iosApp target: Drag all corresponding icons to each variant block, e.g.:

• Default -> Any Appearance
• Dark -> Dark Appearance
• Tinted -> Tinted Appearance

Your iOS app icon is now updated.

Support My Project ☕️¶

If you find this project useful, consider supporting it by buying me a coffee. Your support helps me continue working on this project and add more features.