使用Xcode14.2+编译Xamarin.iOS应用，Ad Hoc安装缺失application-identifier权限

问题背景 #

• 基于Xamarin Forms的旧应用，原通过Azure DevOps的macOS-11镜像（Xcode 13.2.1、Xamarin.iOS 15.4）构建iOS版本
• 因苹果强制要求使用Xcode 14.1+/iOS 16.1编译提交应用，切换至macOS-12镜像（Xcode 14.2、iOS 16.1），后续升级到Xcode 15
• 因AppCenter即将停用，已迁移至Runway，问题仍未解决

症状 #

• 通过App Center/Runway安装Ad Hoc构建包时，提示：Unable to install "[App Name]" Please try again later
• 设备控制台中installd进程报错：

0x16fccb000 -[MIInstallableBundle _validateApplicationIdentifierForNewBundleSigningInfo:error:]: 981: Application is missing the application-identifier entitlement.

• 对比编译产物：Xcode 13.2.1编译的IPA内app文件包含完整权限信息，Xcode 14.2+编译的产物无任何权限输出

已尝试的无效操作 #

• 在entitlements.plist中手动添加以下配置，未解决问题：

<key>application-identifier</key>
<string>$(AppIdentifierPrefix)$(CFBundleIdentifier)</string>

解决方案 #

1. 确认签名配置与Provisioning Profile匹配 #

• 检查Ad Hoc用的Provisioning Profile：确保它包含application-identifier权限，且配置的App ID与项目的CFBundleIdentifier完全一致
• 在Azure DevOps/Runway的构建任务中，不要勾选"自动管理签名"（高版本Xcode下Xamarin自动签名易出现权限丢失问题），手动选择匹配的签名证书和Provisioning Profile

2. 强制构建时注入权限 #

• 打开iOS项目的.csproj文件，添加以下配置，强制构建从Provisioning Profile提取权限并注入到app包：

<PropertyGroup>
  <CodesignEntitlements>Entitlements.plist</CodesignEntitlements>
  <UseEntitlementsFromProvisioningProfile>true</UseEntitlementsFromProvisioningProfile>
</PropertyGroup>

• 注意：如果Entitlements.plist不在项目根目录，需填写正确的相对路径

3. 清理构建缓存 #

• Azure DevOps/Runway中，在构建任务前添加「清理工作区」步骤，选择「清理所有」，避免旧签名缓存干扰
• 本地编译时，执行清理解决方案，删除bin/obj目录后再重新构建

4. 匹配Xamarin.iOS与Xcode版本 #

• 确保Xamarin.iOS版本与Xcode版本兼容：
  • Xcode 14.2对应Xamarin.iOS 16.2+
  • Xcode 15对应Xamarin.iOS 17.0+
    在Azure DevOps镜像中，可通过脚本指定安装对应版本：

  sudo $AGENT_HOMEDIRECTORY/scripts/select-xamarin-sdk.sh 17.0.0.24
  

5. 验证IPA包权限（排查用） #

• 解压IPA包，找到Payload/[AppName].app/embedded.mobileprovision，用以下命令查看权限：

security cms -D -i embedded.mobileprovision | plutil -extract Entitlements xml1 -o - -

• 同时查看Payload/[AppName].app/Entitlements.plist，确认application-identifier存在且与Provisioning Profile中的值一致

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