Customizing the image assets of mobile apps
Match the icons in your mobile app with the branding requirements of your company or project by replacing the default image assets with a set of custom graphics.
By uploading your custom assets in a single.zip
file, you can customize the icons that appear on the home
screen and on the launch screen when the mobile app starts.- To specify different icons for iOS and Android apps.
- To upload icon images in a format other than the default SVG format, for
example,
.png
. - To upload icon images in a resolution other than the recommended 512 x 512 pixels.
- For Android apps, to upload a custom notification icon for the status bar of your mobile app.
Otherwise, customize the icon and launch screen of your mobile app in a low-code environment. For more information, see Customizing the icon and launch screen of mobile apps.
.zip
file, ensure that you keep the directory structure,
file names, and image dimensions of your custom assets .zip
file identical to the setup in the default .zip
file. If a
specific image asset is missing in your custom assets .zip
file, the operating system of the mobile device rescales the existing assets
(Android), or replaces the missing assets with the system-default resources
(iOS).- Download the simplified assets
.zip
file that matches your version of Pega Mobile Client.For more information, see Branding assets templates for Pega Mobile Client. - Extract the contents of the
.zip
file. - Replace the image assets in the folders that you extracted from the
.zip
file to customize any of the following graphics:Choices Actions Mobile app icon (iOS) - In the
common_assets
folder, replace theicon.svg
file with the image file that you want to use.Note: If you plan to publish your mobile app in the Apple App Store, use a rectangular icon. iOS mobile devices also rescale the icon.svg
file and use it as an icon to display notifications on the status bar of your mobile app.
Mobile app icon (Android) - In the
common_assets
folder, replace theicon.svg
file with the image file that you want to use. - In the
android
folder, replace theicon_round.svg
file with the image file that you want to use.Note: Use a circular icon. Android devices that support circular launcher icons use the icon_round.svg
file instead of theicon.svg file
as the app icon. - In the
android
folder, replace thenotification_icon.svg
file with the image file that you want to use.Android mobile devices use this icon to display notifications on the status bar of your mobile app.Note: Use an icon that matches the following requirements: - Image format – 32-bit
.png
(with alpha) - Transparent image
- Transparency Color Index – White (#FFFFFF)
- Image format – 32-bit
- Optional: To enable adaptive icons for your mobile app, in the
android
folder, replace theicon_background.svg
andicon_foreground.svg
files with the image files that you want to use.For more information about adaptive icons in Android operating systems, see the Adaptive icons article on the Android Developers website.
Splash screen logo (iOS and Android) In the common_assets
folder, replace thesplashlogo.svg
file with the image file that you want to use. - In the
- Select the folders that you extracted from the
.zip
file that now contain your custom assets, and then compress them into a single.zip
file. - Open your mobile channel:
- In the navigation pane of App Studio, click Channels.
- In the Current channel interfaces section, click the tile that represents a mobile channel for your app.
- On the mobile channel page, on the Layout tab, click Branding.
- In the Branding section, click the Configure advanced branding icon, and then select the Advanced Branding check box.
- In the Upload custom branding file section, click
Choose file, and then select the
.zip
file that contains your custom assets. - Confirm your selection by clicking OK.
- Click Save.
.zip
assets file that you uploaded in the mobile
channel.Previous topic Customizing the icon and launch screen of mobile apps Next topic Customizing the theme of mobile apps