cordova-plugin-app-icon-changer

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #go #machine-learning #docker #nodejs #windows #pytorch #ios #openai #open-source

cordova-plugin-app-icon-changer

(★ 31)

Change the homescreen icon of your Cordova iOS app at runtime!

cordova-plugin-app-icon-changer Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Cordova App Icon Changer

[![NPM version][npm-image]][npm-url]
[![Downloads][downloads-image]][npm-url]
[![Twitter Follow][twitter-image]][twitter-url]

[npm-image]:http://img.shields.io/npm/v/cordova-plugin-app-icon-changer.svg
[npm-url]:https://npmjs.org/package/cordova-plugin-app-icon-changer
[downloads-image]:http://img.shields.io/npm/dm/cordova-plugin-app-icon-changer.svg
[twitter-image]:https://img.shields.io/twitter/follow/eddyverbruggen.svg?style=social&label=Follow%20me
[twitter-url]:https://twitter.com/eddyverbruggen

## Installation

```
$ cordova plugin add cordova-plugin-app-icon-changer
```

## API

> Make sure to wait for `deviceready` before using any of these functions.

### `isSupported`

Only iOS 10.3 and up support this feature, so you may want to check beforehand:

```js
AppIconChanger.isSupported(
  function(supported) {
    console.log("Supported? " + supported);
  }
);
```

### `changeIcon`

To be able to switch to a different icon add it to your Xcode project as explained below and pass `iconName` to `changeIcon`.

Note 1: iOS will notify the user the icon changed, but this plugin allows you to suppress that message (it's the default even). It's probably not what Apple would like you to do, but no apps have been disapproved with suppression enabled.

Note 2: Changing the app icon is only allowed when the app is in the foreground, so forget about that weather app which silently updates its app icon.

```js
AppIconChanger.changeIcon(
    {
      iconName: "icon-phonegap",
      suppressUserNotification: true
    },
    function() { console.log("OK")},
    function(err) { console.log(err) }
);
```

## Preparing your app for icon switching
Apple doesn't allow switching to arbitrary icons, so they must be bundled with your app before releasing the app to the store.

Add the icons you'd like your users to be able to switch to for all relevant resolutions as usual.

> Note that you DON'T NEED to provide all those resolutions; you could get away with adding just the largest resolution and refer to it in the plist file. iOS will scale it down to other resolutions for you.

Drag the relevant icons to the Resources folder so it looks like this:

The plist file can be edited in Xcode, or with your favorite text editor. If you use the latter you can copy-paste a snippet like the one below:

```xml
<plist>
<dict>

<key>CFBundleIcons</key>
  <dict>
    <key>CFBundleAlternateIcons</key>
    <dict>
      
      <key>icon-phonegap</key>
      <dict>
        <key>UIPrerenderedIcon</key>
        <true/>
        <key>CFBundleIconFiles</key>
        <array>
          
          <string>icon-phonegap-60</string>
        </array>
      </dict>
    </dict>
  </dict>

</dict>
</plist>
```

> Need iPad support as well? Just duplicate that plist config and change `<key>CFBundleIcons</key>` to `<key>CFBundleIcons~ipad</key>`.

cordova-plugin-app-icon-changer

cordova-plugin-app-icon-changer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

cordova-plugin-app-icon-changer

cordova-plugin-app-icon-changer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README