I’m working on a .NET MAUI app using Visual Studio on Windows, and I’m trying to upload the .ipa file to the App Store using Transporter on a Mac in the cloud. However, I’m running into two issues:
- The app icon is not being included in the build.
- The
CFBundleIconNamefrom theInfo.plistis not being applied.
My Setup
-
App Icon:
All required icon sizes are located inResourcesAppIcon.
The folder contains all the necessary PNG files (e.g.,icon16.png,icon32.png,icon512.png, etc.) along with the baseappicon.svg.
The Build Action for each file is set toMauiImage.
My.csprojincludes the following line for the app icon:<MauiIcon Include="ResourcesAppIconappicon.svg" /> -
Info.plist:
The file includes aCFBundleIconNamekey with the correct app name. -
Splash Screen:
The splash screen is working as expected and is located atResources/Splash/dart_splash.png.
What I’ve Tried
- Verified all icon sizes and ensured their Build Action is set to
MauiImage. - Confirmed the
CFBundleIconNameis present and correctly set inInfo.plist. - Checked the
.csprojfile for correct inclusion of icons and splash screens. - Built the
.ipawithout errors in Visual Studio.
Environment Details
- Development OS: Windows with Visual Studio 2022.
- Mac: Cloud-hosted environment for building the
.ipaand uploading via Transporter. - Framework: .NET MAUI targeting iOS.
Issues
- When I upload the
.ipafile, the app icon doesn’t appear in the App Store. - The app name doesn’t reflect the value of
CFBundleIconName.
Question
What could I be missing in my configuration that prevents the app icon from being included and the CFBundleIconName from being applied? Any suggestions or troubleshooting steps would be appreciated.
the errors i get are below
2
I would suggest to follow the official documentation provided regarding setting your app icon for iOS
In .NET MAUI, by default the info.plist contains <key>XSAppIconAssets</key> and it’ value as Assets.xcassets/appicon.appiconset.
So, Whatever you define as MauiIcon in your .NET MAUI app will be used to generate asset catalog icon set for both iOS and macOS. (So app icon set is generated automatically by MAUI).
There is no need for extra configuration like setting CFBundleIconName.
In you case, you defined MauiIcon like below
<MauiIcon Include="ResourcesAppIconappicon.svg" />
Few things to note:
- There is no
Colorproperty defined. The documentation clearly mentioned to define aColorto avoid an error during App Store Connect verification. - Remove the
CFBundleIconNamekey defined in info.plist and make sure it containsXSAppIconAssetsand it’s value asAssets.xcassets/appicon.appiconset
Note: Make sure below mentioned point in documentation
The Info.plist file contains a
<key>XSAppIconAssets</key>entry, with a corresponding<string>node defined after it. The value of this<string>node follows this format: Assets.xcassets/{name}.appiconset The value for{name}is derived from the .NET MAUI project file’s<MauiIcon>item, specifically the file name defined by the Include attribute, without its path or extension.
3