MAUI打包iOS应用并发布到App Store,核心是完成代码签名、预配配置、元数据准备和审核提交四步。整个流程必须在Mac上操作,且需加入Apple Developer Program(年费99美元),不能跳过。
基础前提与环境准备
确保以下全部就绪,缺一不可:
一台运行macOS的Mac电脑(推荐Ventura或更新系统) 已安装Xcode(14.1+,需启用Command Line Tools) 已注册Apple Developer Program,并用同一Apple ID登录开发者中心和App Store Connect Visual Studio for Mac 或 Windows + 已配对的Mac生成主机(推荐VS for Mac更稳定) .NET 8 SDK + MAUI工作负载已安装:dotnet workload install maui
项目配置与自动预配设置
先让Visual Studio自动处理证书和配置文件,大幅降低手动出错概率:
在项目属性 → iOS → 捆绑签名中,选择“自动预配”方案 点击“配置自动预配”,选中你的开发团队(需管理员权限) 确保Info.plist中
CFBundleIdentifier已设为唯一Bundle ID(如
com.yourname.appname),不能含下划线或大写字母 检查
Directory.Build.props是否定义了版本信息,例如:
1.0.0
1
iOS发布构建与IPA生成
命令行方式最可控,适合CI/CD或复现问题:
终端进入项目根目录,执行:dotnet publish -f:net8.0-ios -c:Release /p:ArchiveOnBuild=true /p:CodesignKey="Apple Distribution" /p:CodesignProvision="iOS App Store"确认
CodesignKey和
CodesignProvision名称与钥匙串和开发者中心完全一致(区分Development/Distribution) 生成的IPA默认路径:
bin/Release/net8.0-ios/ios-arm64/publish/YourApp.ipa注意:必须使用
Apple Distribution证书和
iOS App Store预配描述文件,测试用的Development配置无法提交审核
App Store Connect提交与审核要点
IPA只是载体,App Store Connect才是发布中枢:
登录App Store Connect,创建新App,填写名称、副标题、描述、关键词(注意字符限制) 上传1024×1024图标(无圆角、无透明、PNG格式)、各尺寸截图(iPhone/iPad真机截,非模拟器) 填写隐私清单(dotnet publish -f:net8.0-ios -c:Release /p:ArchiveOnBuild=true /p:CodesignKey="Apple Distribution" /p:CodesignProvision="iOS App Store")——2025年起强制要求:列出所有数据类型(如位置、相册、联系人)及使用原因,否则直接被拒 使用Transporter应用上传IPA(推荐),或通过Xcode Organizer归档后上传 提交审核前,在“App审核信息”中如实填写测试账号、关键路径说明;勾选“此App使用了加密”仅当真用了加密API时才选
基本上就这些。自动预配能省掉80%的手动证书管理,但Bundle ID、隐私清单、截图规格这三项最容易卡审,建议提前对照Apple最新指南核对。审核周期通常1–3天,首次提交建议预留一周缓冲。
