VISUAL STUDIO   Windows Mac

Application Icons

Using an Image as an Icon in Xamarin.iOS.

PDF for offline use
Sample Code:
Related Articles:
Related SDKs:

Let us know how you feel about this

Translation Quality


0/250

last updated: 2017-03

This article covers the steps required to move an older iOS app to using Asset Catalogs for the App Icon.

Overview

This article covers several deprecated image technologies and technique that might be required to maintain an older Xamarin.iOS app:

Pre-rendered Icons (iOS 6.1 and earlier)

In iOS6.1 (and earlier), a gloss effect can be applied to the app icons, however the developer can opt-out of this effect by checking the Prerendered checkbox in the AppIcons asset of the Assets.xcassets file:

The gloss effect is not supported in iOS 7 and later, so this setting has no affect on iOS app running on this version of the OS.

Migrating from Info.plist to Asset Catalogs

For an existing Xamarin.iOS app using the Info.plist file to manage it's icons, it is highly suggested that the developer switch it over to use the AppIcons Image Asset inside the Assets.xcassets.

Do the following:

  1. Double-Click the Info.plist file in the Solution Explorer to open it for editing.
  2. Scroll down to the App Icons section.
  3. From the Source dropdown list, select Migrate to Asset Catalogs:

  4. Any existing Icons defined in the Info.plist file will be migrated to a AppIcons Image Set added to Assets.xcassets:

  1. Double-Click the Info.plist file in the Solution Explorer to open it for editing.
  2. Click on the iPhone Icons section:

  3. Scroll down to the Icons section.
  4. From the Asset Catalog dropdown list, select Use Asset Catalogs.
  5. Any existing Icons defined in the Info.plist file will be migrated to a Images set added to Assets.xcassets.
  6. Save the changes to the Info.plist file.

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.