VS 2019 16.9.2版本更新后iOS应用可归档但无法分发

问题触发背景 #

• 异常表现：升级Visual Studio 2019至16.9.2版本后，开发的Xamarin.iOS应用可正常完成构建、归档流程，但无法执行后续分发操作；升级前从构建到分发的全流程功能运行完全正常。
• 已完成的自主排查操作：
  • 跨端清理编译缓存：在Windows开发端、配套连接的Mac构建端分别执行解决方案清理，删除两端项目路径下的bin、obj文件夹，重启两台设备后重新构建编译，问题复现
  • 全量重置证书与配置文件：删除两端所有留存的Provisioning Profiles、开发者证书，重新创建并安装对应证书与配置描述文件，问题复现
  • 切换代码签名模式：在手动签名配置、自动签名配置模式间切换后重新执行构建，问题复现
  • 校验编译配置：确认应用面向最新iOS SDK编译，且当前处于Release发布模式，问题复现
  • 校验配置匹配性：确认应用ID与对应配置描述文件完全匹配，问题复现

执行分发时的原生报错信息 #

Could not create ipa file for distribution of the archive 'AppName'
/usr/bin/codesign exited with code 1

/usr/bin/codesign exited with code 1

Failed to codesign 'Path/obj/iPhone/Release/archives/ProjectName 3-21-21 10.27 AM.xcarchive/Products/Applications/ProjectName.app//**/*.dylib':/Users/xamarin/Libray/Caches/Xamarin/mtbs/builds/ProjectName/GUIDc/C:/Path/obj/iPhone/Release/archives/ProjectName. 3-21-21 10.27 AM.xcarchive/Products/Applications/ProjectName.app//**/*.dylib: No such file or directory

Failed to codesign 'Path/obj/iPhone/Release/archives/ProjectName 3-21-21 10.27 AM.xcarchive/Products/Applications/ProjectName.app//**/*.metalib':/Users/xamarin/Libray/Caches/Xamarin/mtbs/builds/ProjectName/GUIDc/C:/Path/obj/iPhone/Release/archives/ProjectName 3-21-21 10.27 AM.xcarchive/Products/Applications/ProjectName.app//**/*.metalib: No such file or directory

异常根因与解决方法 #

• 根因定位：16.9.2版本内置的Xamarin.iOS构建链路存在路径匹配逻辑缺陷，执行代码签名阶段会错误携带**通配符去匹配.app包内的dylib、metalib资源文件，实际归档目录中不存在这类带通配符的虚拟路径，直接触发codesign执行失败，最终导致ipa文件生成中断。
• 可落地的解决路径：
  • 配置排查调整：打开Windows端iOS项目的属性页，进入「iOS Bundle Signing」配置栏，逐项检查「Custom Entitlements」「Extra Code Args」的引用路径，移除所有包含**通配符的无效路径配置，确保所有资源指向真实存在的实体文件路径。
  • 稳定版本回退：若调整配置后问题仍复现，可将Visual Studio 2019从16.9.2版本回退至之前运行稳定的16.8.x版本，该版本未引入通配符路径匹配的相关逻辑，可正常完成全流程分发操作。
  • 版本补丁升级：将Visual Studio 2019升级至16.9.3及以上小版本，微软已在后续发布的补丁中修复了该通配符路径匹配的逻辑错误，升级后无需修改原有项目配置即可正常执行归档、分发流程。

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