How is your experience with the OutSystems Community?
16
Views
2
Comments
Custom mobile icon when installed on devices
Application Type
Mobile

Hello,

I would like to know how can I do something similar to this article:

Modify the App Icon

https://success.outsystems.com/documentation/11/deploying_apps/mobile_apps_packaging_and_delivery/customize_your_mobile_app/modify_the_app_icon/

But for ODC Android Mobile apps

I tried to do something similar with what is done for O11 but without success.

So, I would like to change the installed mobile icon on the devices based on the stage.

Is there any way to do this?

2025-11-18 12-43-07
Mariana Junges
Champion

Hi,
The documentation you referenced applies to OutSystems 11 Mobile Apps, which are built using Cordova/MABS. In that architecture, app icons can be customized through Extensibility Configurations, icons.json, and icon.zip. 

In ODC Mobile, the architecture is different, are built using Capacitor, so the mechanism described in the O11 documentation is not available.

To change the default application icon in ODC, the icon assets must be updated as part of the native build configuration before generating a new mobile build. 

If the requirement is to change the app icon dynamically at runtime (for example, for white-label applications, seasonal branding, or different environments), this is not supported out of the box in ODC. 

However, it can be achieved using a Capacitor-based solution, such as the App Icon Plugin (ODC) available in the OutSystems Forge https://www.outsystems.com/forge/component-overview/23146/app-icon-plugin-odc?utm_source

If this helped, please let me know.

2021-07-01 15-11-45
Fábio Santos

Hello, 

Thanks for your response. For our use case, we only needed a different icon based on the stage.
This would help identify the apps installed on the devices (DEV, TEST, QA, PROD). 
We don't need to change the icon at runtime.

I know that the article is really for Outsystems 11, but I gave it a try anyway since I was generating the APK with Cordova in ODC.

I already changed the name of the app by adding a prefix with the stage before the name of the app.
That already helps, but having the possibility to change the icon would also be helpful.

Community GuidelinesBe kind and respectful, give credit to the original source of content, and search for duplicates before posting.