Stand with Ukraine flag
Pricing Try it now
PE Mobile Application
Documentation > Build and release mobile app
Getting Started
On this page

Build and release ThingsBoard PE Mobile Application

This guide walks you through creating and releasing the ThingsBoard PE mobile app version 1.7.x for iOS and Android.

Doc info icon

If you need to publish a version earlier than 1.7.x, please use the legacy guide for pre‑1.7 releases.


Before you start

It assumes you created an app bundle in the Mobile center and downloaded the generated configs.json file.

If you need to change any settings:

  • Update them in Mobile center.
  • Re‑download configs.json.
  • Replace the file in your project.
Doc info icon

Do not edit configs.json manually. Always manage settings in Mobile center to keep all environments in sync and reduce misconfigurations.

iOS — Build & Release

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 as well as the --dart-define-from-file flag with your config file:

Flutter build command:

1
flutter build ipa --no-tree-shake-icons --dart-define-from-file configs.json

Android — Build & Release

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 as well as the --dart-define-from-file flag with your config file:

Flutter build command:

1
flutter build appbundle --no-tree-shake-icons --dart-define-from-file configs.json

Build flags explanation

--no-tree-shake-icons
Prevents Flutter from removing unused icons during the build process, this will allow mobile application to display any icon, that was set to notification in the notification center.

--dart-define-from-file configs.json
Loads ThingsBoard PE Mobile Application configuration from the JSON file downloaded from the Mobile center, ensuring your app uses the correct settings for production.