Skip to content

Commit 68d4c35

Browse files
authored
Merge pull request #10464 from syntaxerror247/optional-monochrome
Update Android `themed icons` info
2 parents d3a902e + 14f99b3 commit 68d4c35

File tree

1 file changed

+3
-6
lines changed

1 file changed

+3
-6
lines changed

tutorials/export/exporting_for_android.rst

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -96,24 +96,21 @@ Providing launcher icons
9696

9797
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.
9898

99-
There are two types of icons required by Godot:
99+
There are three types of icons:
100100

101101
- **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.
102102
- **Adaptive Icons:** Starting from Android 8 (inclusive), `Adaptive Icons <https://developer.android.com/guide/practices/ui_guidelines/icon_design_adaptive>`_ 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.
103-
- **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.
104-
105-
.. caution:: It is mandatory to provide a monochrome icon. Failure to do so will result in the default Godot monochrome icon being used.
103+
- **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.
106104

107105
.. seealso:: It's important to adhere to some rules when designing adaptive icons. `Google Design has provided a nice article <https://medium.com/google-design/designing-adaptive-icons-515af294c783>`_ that helps to understand those rules and some of the capabilities of adaptive icons.
108106

109107
.. 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.
110108

111-
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:
109+
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:
112110

113111
- **Main Icon:** Provided main icon -> Project icon -> Default Godot main icon.
114112
- **Adaptive Icon Foreground:** Provided foreground icon -> Provided main icon -> Project icon -> Default Godot foreground icon.
115113
- **Adaptive Icon Background:** Provided background icon -> Default Godot background icon.
116-
- **Adaptive Icon Monochrome:** Provided monochrome icon -> Default Godot monochrome icon.
117114

118115
It's highly recommended to provide all the requested icons with their specified resolutions.
119116
This way, your application will look great on all Android devices and versions.

0 commit comments

Comments
 (0)