This is an automated email from the ASF dual-hosted git repository.
GitToTheHub pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cordova-docs.git
The following commit(s) were added to refs/heads/master by this push:
new 27b6bf20b0 docs: clarify Android vector icon guidance (#1519)
27b6bf20b0 is described below
commit 27b6bf20b014c2fbb69746ed4cf8ab7361c19863
Author: WeiHaoxuan <[email protected]>
AuthorDate: Tue Aug 25 16:02:34 2026 +0800
docs: clarify Android vector icon guidance (#1519)
- explain that Android vector drawable resources are XML, not regular SVG
files
- document the Android Studio Vector Asset Studio conversion path and
density behavior
- replace the Android icon references with current official documentation
links
- Fixes #1501
---
www/docs/en/latest/config_ref/images.md | 12 ++++++++++--
1 file changed, 10 insertions(+), 2 deletions(-)
diff --git a/www/docs/en/latest/config_ref/images.md
b/www/docs/en/latest/config_ref/images.md
index 6b71913cd2..ff42e46195 100644
--- a/www/docs/en/latest/config_ref/images.md
+++ b/www/docs/en/latest/config_ref/images.md
@@ -79,6 +79,12 @@ To use the adaptive icons the `background`, `foreground` and
optionally `monochr
#### Adaptive Icon with Vectors:
+Android vector drawable resources are XML files, not regular SVG files. To
convert an SVG for use
+as a vector drawable, open Vector Asset Studio in Android Studio by
right-clicking the `res` folder
+and selecting `New > Vector Asset`, then import the SVG. A vector drawable can
be resized for
+different screen densities without losing image quality; Android Studio can
also generate bitmap
+fallbacks for older Android versions that do not support vector drawables.
+
```xml
<platform name="android">
<icon monochrome="res/icon/android/ldpi-monochrome.png"
background="res/icon/android/ldpi-background.xml" density="ldpi"
foreground="res/icon/android/ldpi-foreground.xml" src="res/android/ldpi.png" />
@@ -140,9 +146,11 @@ In the `config.xml`, we will add `resource-file` to copy
the `colors.xml` into t
**See Also:**
-- [Android icon
guide](https://developer.android.com/guide/practices/ui_guidelines/icon_design_adaptive)
+- [Create app icons with Android
Studio](https://developer.android.com/studio/write/create-app-icons)
+- [Add multi-density vector graphics with Vector Asset
Studio](https://developer.android.com/studio/write/vector-asset-studio)
+- [Adaptive icon design
guidance](https://developer.android.com/develop/ui/compose/system/icon_design_adaptive)
- [Android Adaptive icons - User
theming](https://developer.android.com/develop/ui/views/launch/icon_design_adaptive#user-theming)
-- [Android - Supporting multiple
screens](https://developer.android.com/guide/practices/screens_support.html)
+- [Android - Supporting multiple
screens](https://developer.android.com/guide/practices/screens_support)
## Browser
Icons are not applicable to the Browser platform.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
