mirror of
https://github.com/expo/config-plugins.git
synced 2026-11-14 10:08:06 -10:00
* chore: git ignore all package build folders in git * chore: clear all package build folders
@config-plugins/react-native-dynamic-app-icon
Config plugin to auto configure react-native-dynamic-app-icon
Install
Tested against Expo SDK 44
yarn add react-native-dynamic-app-icon @config-plugins/react-native-dynamic-app-icon
After installing this npm package, add the config plugin to the plugins array of your app.json or app.config.js. Then rebuild your app as described in the "Adding custom native code" guide.
Example
In your app.json plugins array:
{
"plugins": [
"@config-plugins/react-native-dynamic-app-icon",
["./path/to/image.png", "https://mywebsite.com/my-icon.png"]
]
}
Or as objects:
{
"plugins": [
"@config-plugins/react-native-dynamic-app-icon",
{
"AppIcon1": {
"image": "./path/to/image.png",
"prerendered": true
}
}
]
}
Note: Icon URLs will be downloaded and embedded at build time, you cannot push new icons OTA.
Usage
In list format, icons are named after the item index ('0', '1', '2'), they can be changed like AppIcon.setAppIcon('2') (from the package react-native-dynamic-app-icon).
This isn't tied to react-native-dynamic-app-icon in any way, so any method of swapping icons works.