App Configuration

Dynamic App Icon

Package alternate Android launcher icons and switch among them at runtime through the JavaScript bridge.

Before you start

Enable the module
Turn on Dynamic App Icon for the Android app.
Upload icon slots
Add up to five icons. A square 300 x 300 px or larger source without transparency is the safest choice.
Save and build
The worker generates launcher resources and activity aliases. Existing APKs cannot use newly uploaded icons.
Switch from the website
Call webtoapp.setDynamicAppIcon(1) through 5, or use 0/resetDynamicAppIcon() to restore the default.
Handle launcher behavior
Read the returned JSON and test several launchers. Some update immediately; others refresh after returning home.

const result = JSON.parse(webtoapp.setDynamicAppIcon(1));
if (!result.ok) console.error(result.error);