From 14f99b3e7582a3026f29b182298940a623929c95 Mon Sep 17 00:00:00 2001 From: Anish Mishra Date: Fri, 3 Jan 2025 18:35:57 +0530 Subject: [PATCH] Update Themed icons doc --- tutorials/export/exporting_for_android.rst | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/tutorials/export/exporting_for_android.rst b/tutorials/export/exporting_for_android.rst index 2a95927f4..ad4eaddc7 100644 --- a/tutorials/export/exporting_for_android.rst +++ b/tutorials/export/exporting_for_android.rst @@ -96,24 +96,21 @@ Providing launcher icons Launcher icons are used by Android launcher apps to represent your application to users. Godot only requires high-resolution icons (for ``xxxhdpi`` density screens) and will automatically generate lower-resolution variants. -There are two types of icons required by Godot: +There are three types of icons: - **Main Icon:** The "classic" icon. This will be used on all Android versions up to Android 8 (Oreo), exclusive. Must be at least 192×192 px. - **Adaptive Icons:** Starting from Android 8 (inclusive), `Adaptive Icons `_ were introduced. Applications will need to include separate background and foreground icons to have a native look. The user's launcher application will control the icon's animation and masking. Must be at least 432×432 px. -- **Themed Icons:** Starting from Android 13 (inclusive), Themed Icons were introduced. Applications will need to include a monochrome icon to enable this feature. The user's launcher application will control the icon's theme. Must be at least 432×432 px. - -.. caution:: It is mandatory to provide a monochrome icon. Failure to do so will result in the default Godot monochrome icon being used. +- **Themed Icons (optional):** Starting from Android 13 (inclusive), Themed Icons were introduced. Applications will need to include a monochrome icon to enable this feature. The user's launcher application will control the icon's theme. Must be at least 432×432 px. .. seealso:: It's important to adhere to some rules when designing adaptive icons. `Google Design has provided a nice article `_ that helps to understand those rules and some of the capabilities of adaptive icons. .. caution:: The most important adaptive icon design rule is to have your icon critical elements inside the safe zone: a centered circle with a diameter of 66dp (264 pixels on ``xxxhdpi``) to avoid being clipped by the launcher. -If you don't provide some of the requested icons, Godot will replace them using a fallback chain, trying the next in line when the current one fails: +If you don't provide the requested icons (except for Monochrome), Godot will replace them using a fallback chain, trying the next in line when the current one fails: - **Main Icon:** Provided main icon -> Project icon -> Default Godot main icon. - **Adaptive Icon Foreground:** Provided foreground icon -> Provided main icon -> Project icon -> Default Godot foreground icon. - **Adaptive Icon Background:** Provided background icon -> Default Godot background icon. -- **Adaptive Icon Monochrome:** Provided monochrome icon -> Default Godot monochrome icon. It's highly recommended to provide all the requested icons with their specified resolutions. This way, your application will look great on all Android devices and versions.