如何在M1 Mac的VS Code中为MAUI项目添加iOS描述文件？

第一步：获取适配物理设备的描述文件 #

你当前能下载的App Store描述文件仅适用于应用商店提交，无法部署到本地物理设备。需先在Apple开发者后台创建/获取开发描述文件（用于调试）或临时分发描述文件（用于内部测试）：

• 登录开发者后台进入「Certificates, Identifiers & Profiles」
• 检查「Profiles」分类：
  • 若已有开发类描述文件但无法下载，大概率是关联的证书过期、或目标设备未添加到账号的「Devices」列表中
  • 若无对应描述文件，点击「+」新建，选择「iOS App Development」类型，关联匹配的App ID、有效开发证书，以及你要部署的物理设备（需提前将设备UDID添加到「Devices」）
• 完成创建后即可下载对应的开发描述文件

第二步：导入描述文件到系统 #

1. 下载.mobileprovision格式的开发描述文件
2. 双击文件，系统会自动将其导入到「钥匙串访问」和Xcode的描述文件库
   • 验证导入：打开「钥匙串访问」→「我的证书」，确认对应开发证书存在且状态正常；或打开Xcode→「设置」→「账号」→ 你的Apple ID→「Manage Profiles」，能看到导入的描述文件

第三步：在VS Code中配置MAUI项目 #

1. 打开项目Platforms/iOS/Info.plist，确保CFBundleIdentifier与描述文件关联的App ID完全一致
2. 若项目无Platforms/iOS/Entitlements.plist则创建，保证文件内的权限配置与描述文件中的权限匹配
3. 两种方式指定描述文件：
   • 终端命令构建：

     dotnet build -f net7.0-ios -t:Run -p:DeviceName="你的设备名称" -p:ProvisioningProfileID="描述文件UUID"
     

     （UUID获取：右键.mobileprovision文件→「显示包内容」，打开embedded.mobileprovision查找UUID字段值）
   • 修改项目.csproj文件，添加iOS平台配置：

     <PropertyGroup Condition="'$(TargetFramework)' == 'net7.0-ios'">
       <ProvisioningProfileID>你的描述文件UUID</ProvisioningProfileID>
       <CodeSigningIdentity>iPhone Developer</CodeSigningIdentity>
     </PropertyGroup>
     

常见排查项 #

• 确保M1 Mac安装了最新版Xcode、iOS SDK，且VS Code的MAUI扩展为最新版本
• 检查钥匙串中对应开发证书未过期，且私钥完整
• 物理设备通过USB连接Mac后，需在设备的「设置→通用→VPN与设备管理」中信任你的开发者账号

内容的提问来源于stack exchange，提问作者eengstroem