You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
You cannot change the splash screen in pre-1.7.0 versions. It will default to your app's icon.
12
+
13
+
### App Icon
14
+
15
+
The Flutter app comes with a default launcher icon. To change it with your custom one, follow these instructions:
16
+
17
+
#### Step 1: Add flutter_launcher_icons Plugin
18
+
19
+
Add the flutter_launcher_icons plugin to your project via command line:
20
+
21
+
```bash
22
+
flutter pub add dev:flutter_launcher_icons
23
+
```
24
+
{: .copy-code}
25
+
#### Step 2: Replace Default Icon
26
+
27
+
Replace `thingsboard.png` in the `assets/images` folder with your custom icon. We recommend using a 432×432 pixel image of your logo centered within the canvas.
28
+
29
+
#### Step 3: Run the Generator
30
+
31
+
Execute the generator to apply your new icon:
32
+
33
+
```bash
34
+
flutter pub run flutter_launcher_icons
35
+
```
36
+
{: .copy-code}
37
+
38
+
#### Step 4: Update Notification Icon (Optional)
39
+
40
+
If you have configured push notifications (see [push notifications setup guide](/docs/pe/mobile/getting-started/#step-2-optional-configure-push-notifications)), we recommend updating the notification icon as well.
41
+
42
+
1. Go to [Android Asset Studio](https://romannurik.github.io/AndroidAssetStudio/icons-notification.html)
43
+
2. Press "Image" and choose your logo
44
+
3. Configure padding if needed
45
+
4. Change the file name to "thingsboard"
46
+
5. Press the download button to get an archive of the "res" folder
47
+
6. Paste the contents to `android/app/src/main` and click "Replace" when prompted
<img width="" src="https://img.thingsboard.io/mobile/asset_studio.png" title="Android asset studio flow" alt="Android asset studio flow">
52
+
</div>
53
+
</div>
54
+
55
+
{% capture pre_version_note %}
56
+
**Note:** Pre-1.7.0 versions have limited customization options compared to newer versions. Consider upgrading to version 1.7.0+ for full branding capabilities.
57
+
{% endcapture %}
58
+
{% include templates/info-banner.md content=pre_version_note %}
Copy file name to clipboardExpand all lines: _includes/docs/mobile/app-icon-splash-screen.md
+10-57Lines changed: 10 additions & 57 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,3 +1,8 @@
1
+
{% if docsPrefix == 'pe/' %}
2
+
{% assign peDocsPrefix = "pe/" %}
3
+
{% else %}
4
+
{% assign peDocsPrefix = "" %}
5
+
{% endif %}
1
6
* TOC
2
7
{:toc}
3
8
@@ -7,10 +12,13 @@ An **app icon** is the visual representation of your application that appears on
7
12
8
13
A **splash screen** is the initial screen displayed when an application is launched, typically showing a logo or branding while the app loads.
9
14
10
-
## App version 1.7.0+
11
-
12
15
For app version 1.7.0 and above, you need several assets to fully customize your app. You will find default examples of the required assets in the `assets/branding` folder.
13
16
17
+
{% capture pre_1_7_0_link %}
18
+
Important Notice: Please use [this guide](/docs/{{peDocsPrefix}}mobile/app-icon-splash-screen-before-v1.7/) for pre 1.7.x configuration
19
+
{% endcapture %} {% include templates/info-banner.md content=pre_1_7_0_link %}
20
+
21
+
14
22
### Required Assets
15
23
16
24
The following assets are required for complete customization:
@@ -143,58 +151,3 @@ dart run flutter_launcher_icons
143
151
dart run flutter_native_splash:create
144
152
```
145
153
{: .copy-code}
146
-
147
-
## App version pre 1.7.0
148
-
149
-
For app versions prior to 1.7.0, the customization process is different and more limited.
150
-
151
-
### Splash Screen
152
-
153
-
You cannot change the splash screen in pre-1.7.0 versions. It will default to your app's icon.
154
-
155
-
### App Icon
156
-
157
-
The Flutter app comes with a default launcher icon. To change it with your custom one, follow these instructions:
158
-
159
-
#### Step 1: Add flutter_launcher_icons Plugin
160
-
161
-
Add the flutter_launcher_icons plugin to your project via command line:
162
-
163
-
```bash
164
-
flutter pub add dev:flutter_launcher_icons
165
-
```
166
-
{: .copy-code}
167
-
#### Step 2: Replace Default Icon
168
-
169
-
Replace `thingsboard.png` in the `assets/images` folder with your custom icon. We recommend using a 432×432 pixel image of your logo centered within the canvas.
170
-
171
-
#### Step 3: Run the Generator
172
-
173
-
Execute the generator to apply your new icon:
174
-
175
-
```bash
176
-
flutter pub run flutter_launcher_icons
177
-
```
178
-
{: .copy-code}
179
-
180
-
#### Step 4: Update Notification Icon (Optional)
181
-
182
-
If you have configured push notifications (see [push notifications setup guide](/docs/pe/mobile/getting-started/#step-2-optional-configure-push-notifications)), we recommend updating the notification icon as well.
183
-
184
-
1. Go to [Android Asset Studio](https://romannurik.github.io/AndroidAssetStudio/icons-notification.html)
185
-
2. Press "Image" and choose your logo
186
-
3. Configure padding if needed
187
-
4. Change the file name to "thingsboard"
188
-
5. Press the download button to get an archive of the "res" folder
189
-
6. Paste the contents to `android/app/src/main` and click "Replace" when prompted
<img width="" src="https://img.thingsboard.io/mobile/asset_studio.png" title="Android asset studio flow" alt="Android asset studio flow">
194
-
</div>
195
-
</div>
196
-
197
-
{% capture pre_version_note %}
198
-
**Note:** Pre-1.7.0 versions have limited customization options compared to newer versions. Consider upgrading to version 1.7.0+ for full branding capabilities.
199
-
{% endcapture %}
200
-
{% include templates/info-banner.md content=pre_version_note %}
Copy file name to clipboardExpand all lines: _includes/docs/mobile/qr-code-settings.md
+5-1Lines changed: 5 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,11 @@
8
8
9
9
This guide provides instructions on how to configure a custom mobile application to launch directly from a [QR code scan](/docs/{{peDocsPrefix}}user-guide/ui/mobile-qr-code/) using your phone's camera.
10
10
11
-
In application version 1.7.0+, we have made QR code settings configuration much easier through the platform interface.
11
+
In application version 1.7.0+, we have made QR code settings configuration much easier by using configuration file.
12
+
13
+
{% capture pre_1_7_0_link %}
14
+
Important Notice: Please use [this guide](/docs/{{peDocsPrefix}}mobile/qr-code-settings-before-v1.7/) for pre 1.7.x qr code configuration
15
+
{% endcapture %} {% include templates/info-banner.md content=pre_1_7_0_link %}
Copy file name to clipboardExpand all lines: _includes/docs/mobile/release.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,10 @@
6
6
* TOC
7
7
{:toc}
8
8
9
+
{% capture pre_1_7_0_link %}
10
+
Important Notice: Please use [this guide](/docs/{{peDocsPrefix}}mobile/release-before-v1.7/) for pre 1.7.x app publish instructions
11
+
{% endcapture %} {% include templates/info-banner.md content=pre_1_7_0_link %}
12
+
9
13
## Configure the App
10
14
11
15
Your app package name and app name will come preconfigured from your Mobile Center in the configuration file that you downloaded after app bundle creation in the Mobile Center.
0 commit comments