提交.NET MAUI应用至Apple TestFlight遇90717错误:大图标验证失败
解决.NET MAUI发布TestFlight时的90717图标Alpha通道错误
以下是针对该问题的实操解决步骤:
- 检查MAUI项目的AppIcon配置完整性:打开项目的AppIcon资源文件(AppIcon.appiconset),确认所有图标尺寸对应的源文件都替换成了无Alpha通道的不透明图片——不要只检查58x58和1024x1024,其他自动生成的尺寸对应的源文件也可能存在问题,建议重新导出所有所需尺寸的图标并替换。
- 手动验证打包后.app包内的图标:找到发布构建生成的
THEAPP.Maui.app文件,右键选择「显示包内容」,进入Resources目录找到所有AppIcon相关文件,用预览工具(如Mac的Preview)检查:打开图片后点击「工具」→「显示检查器」,查看「Alpha通道」选项是否被勾选。如果有任何一个图标存在Alpha通道,说明打包过程中出现了异常处理。 - 重新导出图标文件确保无Alpha:用图像编辑工具(如Photoshop、GIMP)打开原图标,将背景设置为完全不透明,保存为PNG时明确取消「保留透明度」或「Alpha通道」选项;也可以用Mac Preview打开图片,点击「文件」→「导出」,在导出选项中取消勾选「Alpha」,再保存。
- 清理项目缓存后重新构建:删除项目根目录下的
bin和obj文件夹,同时清理Mac上的~/Library/Caches/Xamarin缓存目录,然后重新执行发布构建命令,避免旧缓存文件被复用。 - 检查iOS平台的Info.plist配置:打开
Platforms/iOS/Info.plist,查找CFBundleIcons相关节点,确认所有CFBundleIconFiles条目指向的都是正确的无Alpha图标文件,删除任何多余或错误的图标引用。 - 改用Xcode归档打包:执行命令
dotnet publish -f net7.0-ios -c Release /p:ArchiveOnBuild=true生成.xcarchive文件,用Xcode打开该归档,点击「验证归档」,确认无错误后导出IPA文件,再用Transporter提交——Xcode的打包流程对图标格式的处理更严格,能规避MAUI自动处理时的潜在问题。
内容的提问来源于stack exchange,提问作者David Rutter
相关产品推荐
相关产品推荐

