[ 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)