AppIconChangerUnity icon indicating copy to clipboard operation
AppIconChangerUnity copied to clipboard

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. Screen Shot 2022-02-25 at 15 01 24

Quickstart

  • Create AppIconChanger > AlternateIcon from the context menu
Screen Shot 2022-02-26 at 13 15 02
  • Set the name and icon
Screen Shot 2022-02-26 at 13 15 47
  • 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.
Screen Shot 2022-02-26 at 13 16 15

How to disable native popup?

It cannot be disabled because it is a popup that iOS displays automatically.
But... https://github.com/kyubuns/AppIconChangerUnity/issues/11

Requirements

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

License

MIT License (see LICENSE)