You can customize the Mobile Authenticator Studio app's different types of icons:
To customize the icon(s), you create an image in the required format and upload the image files on the Mobile Authenticator Studio Portal. For detailed instructions how to build and customize the app, see the Mobile Authenticator Studio Portal documentation.
With the exception of the PNG launcher icon for Android on versions prior to Android 8, the customization of any of the icons is optional. However, to ensure compatibility with different devices and Android versions, we recommend customizing the launcher and splash screen icons and use adaptive icons in SVG format.
The specifications for customization of the different icon types vary, see the sections below for more information.
Launcher icon
The launcher icon is displayed on the device dashboard.
iOS
To customize the launcher and / or navigation icons on iOS, create a PNG file in square mode, 1024x1024 px, for upload in the Mobile Authenticator Studio Portal.
For more information about app icons on iOS, refer to the iOS developer documentation.
Android
Android supports two types of app icons: legacy PNG and adaptive SVG icons.
An adaptive icon consists of two layers, foreground and background, each defined in a separate SVG file. This type of icon can display a variety of shapes across different device models. While adaptive icons are the new standard on Android 8.0 and later, a PNG icon is still needed to support versions prior to Android 8.0. For more information about Android adaptive icons, refer to the Android developer documentation on adaptive icons.
A legacy PNG icon does not have a foreground, and background resources can have any shape. Any PNG files you use must be in the highest available resolution. However, we recommend using SVG files instead.
Legacy PNG icons are required for all versions prior to Android 8.
For the customization of the Mobile Authenticator Studio launcher icon, you must always provide a legacy PNG icon. If no adaptive SVG icons are provided, the legacy PNG icons will be used instead across all Android versions. If adaptive SVG icons are provided, they will be used by default on supported system versions, while the legacy PNG icon will serve as fallback on devices running Android versions earlier than 8.0 which do not support adaptive icons.
Specifications for launcher icons
The following table provides the required customization keys and dimensions for each type of launcher icon on Android.
Parameters | Adaptive SVG icons | Legacy PNG icons |
|---|---|---|
Customization keys |
|
|
Dimensions |
|
|
Special considerations for adaptive SVG icons
The foreground and background layers are stacked on top of each other. The foreground layer may include transparency, while the background layer must be completely opaque.
Usually a logo is placed in the foreground layer but this is not a requirement. Placing elements in different layers gives you the opportunity to create advanced visual effects.
Use clean edges. The layers should not have masks or background shadows around the outline.
The generated launcher icon can be of a poor quality (scale up or down depending on the device resolution, which can lead to a blurry icon). The background of the icon will be white.
Customization examples
On devices running Android 8.0 and later, a launcher icon will be created from the ic_launcher_background.svg and ic_launcher_foreground.svg files, on devices running Android 7.1 and lower, ic_launcher.png will be used as a launcher icon.
Customization using adaptive SVG icons
"assets": { "android": { "launcherIcon": "android/icons/ic_launcher.png", "launcherAdaptiveIconBackground": "android/icons/ic_launcher_background.svg", "launcherAdaptiveIconForeground": "android/icons/ic_launcher_foreground.svg", } }Customization using legacy PNG icons
"assets": { "android": { "launcherIcon": "android/icons/ic_launcher.png", } }
Notification icon
The notification icon is displayed for notifications. On Android, you can also customize the icon to use for push notifications from the Mobile Authenticator Studio app. Add the customized icon as PNG or SVG file to the customization of your integration. If you do not provide a file for customization, Mobile Authenticator Studio displays the launcher icon.
Specifications for the notification icon
The following table provides the required customization keys and dimensions for each type of the notification icon on Android.
Parameters | SVG icon | Legacy PNG icon |
|---|---|---|
Customization keys |
|
|
Dimensions |
|
|
Splash screen icon
The splash screen is briefly displayed at app start. In Mobile Authenticator Studio, it consists of two elements:
A static app icon in an SVG format.
If you do not provide a separate static app icon, the launcher icon will be used by default.
Window background
The window background color is a HEX value representing a plain color, which must be a single opaque color. Define this value in the customization file you upload in the OneSpan Mobile Authenticator Studio Portal. The customization key attribute is
splashScreen.
The implementation and customization of a splash screen icon is optional but recommended.
iOS
On iOS, the splash screen must be an SVG file. For more information about icons on iOS, refer to the iOS developer documentation.
Android
On Android, if you do not provide an SVG file for the splash screen, the launcher icon is automatically used as a fallback. This may have different visual effects depending on what was used for the launcher icon:
If an adaptive SVG icon is used, the splash screen will be displayed correctly.
If a legacy PNG icon is provided, the splash screen might appear slightly blurred, depending on the quality of the PNG used.
Specifications for the splash screen icon
Customization key:
splashScreenDimensions: 288x288 dp. The icon must fit within a circle 192 dp in diameter. Everything outside the circle will become invisible (masked).
Animations are not supported in Mobile Authenticator Studio. For more information and best practices regarding splash screens on Android, refer to the Android developer documentation on splash screens.