[
https://issues.apache.org/jira/browse/CB-2606?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13958770#comment-13958770
]
ASF GitHub Bot commented on CB-2606:
------------------------------------
Github user sgrebnov commented on a diff in the pull request:
https://github.com/apache/cordova-docs/pull/201#discussion_r11249330
--- Diff: docs/en/edge/config_ref/images.md ---
@@ -26,45 +26,76 @@ SDK tools (detailed in the Platform Guides).
## Configuring Icons in the CLI
-When working in the CLI, icon source files are located within various
-platform-specific subdirectories within the project's `www/res/icons`
-directory. Newly created projects come with a default set of Cordova
-icons for you to replace for the platforms you wish to target.
+When working in the CLI you can define app icon(s) via `<icon>` element
(`config.xml`).
+If you do not specify an icon then the Apache Cordova logo is used.
-Android specifies icons for low, medium, high, and extra-high resolutions:
+ <icon src="res/ios/icon.png" platform="ios" width="57" height="57"
density="mdpi" />
- android/icon-36-ldpi.png
- android/icon-48-mdpi.png
- android/icon-72-hdpi.png
- android/icon-96-xhdpi.png
+src: (required) specifies the location of the image file, relative to your
www directory
-The iOS platform specifies 72-pixel-square icons for iPads, and
-57-pixel icons for iPhones and iPods, with high-resolution _2x_
-variants for retina displays:
+platform: (optional) target platform
- ios/icon-57-2x.png
- ios/icon-57.png
- ios/icon-72-2x.png
- ios/icon-72.png
+width: (optional) icon width in pixels
-Windows Phone specifies a default 48-pixel icon, along with various
-devices' background tiling images used when representing applications:
+height: (optional) icon height in pixels
- windows-phone/icon-48.png
- windows-phone/icon-62-tile.png
- windows-phone/icon-173-tile.png
+density: (optional) android specific, specifies icon density
-Blackberry 10 requires an icon element in config.xml:
--- End diff --
Temporary removed BB10 and Tizen related info since not sure it is actual.
Will review and bring it back.
> Add support for <icon> elements in config.xml
> ---------------------------------------------
>
> Key: CB-2606
> URL: https://issues.apache.org/jira/browse/CB-2606
> Project: Apache Cordova
> Issue Type: Wish
> Components: Docs
> Reporter: Filip Maj
> Assignee: Mark Koudritsky
>
> This feature would add support for specifying the application icon by
> changing values inside the {{config.xml}} document.
> Relevant details for Cordova:
> - {{<icon>}} elements _may_ have {{width}} and {{height}} attributes
> representing the preferred size of the icon in CSS pixels.
> - {{<icon>}} elements _must_ have a {{src}} attribute, which contains a path
> string relative to the {{www/}} folder (or equivalent) in the platform.
> See [the Widget Spec's section on
> icons|http://www.w3.org/TR/widgets/#the-icon-element-and-its-attributes] for
> specifics.
--
This message was sent by Atlassian JIRA
(v6.2#6252)
