xinatcg / appiconchangerunity

Change the app icon dynamically in Unity (iOS only)

AppIconChangerUnity

Change the app icon dynamically in Unity
Support for new icon formats in Xcode13
-> This means that A/B Test on AppStore is also supported.

• iOS only, require iOS 10.3 or later

Instructions

• Import by PackageManager https://github.com/kyubuns/AppIconChangerUnity.git?path=Assets/AppIconChanger
  • (Optional) You can import a demo scene on PackageManager.

Quickstart

• Create AppIconChanger > AlternateIcon from the context menu

• Set the name and icon

• The following methods are available
  • AppIconChanger.iOS.SupportsAlternateIcons
    • Check to see if the icon can be changed
    • https://developer.apple.com/documentation/uikit/uiapplication/2806815-supportsalternateicons
  • AppIconChanger.iOS.AlternateIconName
    • Check the current icon name (null is the default)
    • https://developer.apple.com/documentation/uikit/uiapplication/2806808-alternateiconname
  • AppIconChanger.iOS.SetAlternateIconName(iconName)
    • Set the icon (null to restore the default)
    • https://developer.apple.com/documentation/uikit/uiapplication/2806818-setalternateiconname

Tips

What is the best size for the app icon?

When the Type of AlternateIcon is set to Auto Generate, the icon will be automatically resized at build time, so there is nothing to worry about. （The maximum size is 1024px.)
If you want to control it in detail, you can change the Type to Manual.

Requirements

• Unity 2020.3 or higher.
• Xcode 13 or higher.

License

MIT License (see LICENSE)