Skip to content

Commit ca977bd

Browse files
Add documentation for themed icons (monochrome)
1 parent a0a61dc commit ca977bd

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

tutorials/export/exporting_for_android.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,7 @@ There are two types of icons required by Godot:
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 to make adaptive icons more customizable. Applications will need to include a monochrome icon to enable themed icon. If a monochrome icon is not provided the default Godot monochrome icon will be used insted.
103104

104105
.. 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.
105106

@@ -110,6 +111,7 @@ If you don't provide some of the requested icons, Godot will replace them using
110111
- **Main Icon:** Provided main icon -> Project icon -> Default Godot main icon.
111112
- **Adaptive Icon Foreground:** Provided foreground icon -> Provided main icon -> Project icon -> Default Godot foreground icon.
112113
- **Adaptive Icon Background:** Provided background icon -> Default Godot background icon.
114+
- **Adaptive Icon Monochrome:** Provided monochrome icon -> Default Godot monochrome icon.
113115

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

0 commit comments

Comments
 (0)