Stand with Ukraine flag
Pricing Try it now
Mobile Application
Documentation > Publish your app (Mobile app v1.6.x)
Getting Started
On this page

Build and release ThingsBoard Mobile Application

Before publishing your app, you may want to polish it. Each app should have its own identification. Therefore, we recommend setting a unique label name and app launch icon before releasing it to the world.

Change App Name

Here are the simple steps to change the label name of your app using the terminal:

Install the Rename Package

First, activate the rename package globally:

1
flutter pub global activate rename

Set App Name for Both Platforms

Using this command, you will get identical app names for both iOS and Android platforms:

1
rename setAppName --targets android,ios --value "Your desired app name"

Set Different Names for Each Platform

If you want to have different names for every platform, simply run:

1
2
rename setAppName --targets android --value "Your Android app name"
rename setAppName --targets ios --value "Your iOS app name"

Change Package Name

Doc info icon

Please note: Your package names should be identical to the package name you configured in your Mobile Center on the ThingsBoard platform.

Set Package Names

1
2
rename setBundleId --targets android --value "org.yourCompany.app"
rename setBundleId --targets ios --value "org.yourCompany.app.ios"
Doc info icon

Current ThingsBoard Platform Limitation: Each app should have a unique package name even if they are for different platforms. That’s why we added the .ios suffix to the IOS package name in the rename command. You can use any package name you want, as long as your IOS and Android package names are different.

Change Launcher Icon

Please follow the App icon and splash screen guide for detailed instructions on customizing your app icon.

Build and Release an Android Version

When preparing a release version of your app for publishing on Google Play, follow the official “Build and release an Android app” guide.

Doc info icon

Important Notice: While preparing the app for release, for example, when producing a build archive, you must provide the --no-tree-shake-icons flag to your build command:

1
flutter build appbundle --no-tree-shake-icons

Build and Release an iOS Version

When preparing a release version of your app for publishing on the App Store and TestFlight, follow the official “Build and release an iOS app” guide.

Doc info icon

Important Notice: While preparing the app for release, for example, when producing a build archive, you must provide the --no-tree-shake-icons flag to your build command:

1
flutter build ipa --no-tree-shake-icons