Xamarin.iOS应用归档后Ad Hoc分发触发codesign报「无此类文件或目录」错误

报错核心本质 #

当前签名失败的根因不是项目真的缺失.dylib、.metallib依赖文件，而是Xamarin构建管道在执行代码签名时，触发了无效的递归通配符匹配逻辑——正常流程下代码签名只会对.app包内实际存在的资源执行校验，不会匹配带**通配符的空路径。你提到该项目在其他设备上可以正常完成分发，也侧面印证了项目本身的配置文件、依赖库没有缺失，问题完全出在当前环境的构建流程上，这类报错几乎都和构建配置不匹配、Windows-Mac配对构建的路径映射串扰有关。

已完成常规清理后的专项解决步骤 #

在你已经完成清理重编译、删除bin/obj目录、重配描述文件、清理Windows端Xamarin缓存、重装Visual Studio、重新拉取项目的基础上，可按以下顺序排查解决：

• 修正归档对应的构建配置
  从报错里的归档路径Mobile.iOS/obj/iPhone/Debug/archives/可以确认，你当前是在Debug构建配置下执行的Ad Hoc分发归档。Xamarin的Debug配置默认不会完整打包Metal编译产物（.metallib）、动态依赖库（.dylib），签名流程会因为找不到对应文件触发匹配空路径的bug。直接切换解决方案配置为Release | iPhone，清除旧的Debug归档残留后重新归档，这是该类报错最高频的触发原因。
• 清理Mac构建主机的配对缓存
  报错的路径内容同时出现了Mac端Xamarin构建缓存前缀、Windows端本地项目路径，说明Windows和配对的Mac构建主机之间的MTBS（Mac Build Server）路径映射存在残留串扰。需要在Mac端同步执行缓存清理：
  • 关闭Windows端Visual Studio、Mac端所有Xamarin相关的后台进程
  • 删除Mac端路径~/Library/Caches/Xamarin/mtbs/builds下的全部内容，同步清空Windows端%LOCALAPPDATA%\Xamarin\Mtbs目录的缓存——你此前仅清理了Windows侧的Xamarin常规缓存，未清理Mac侧的MTBS构建映射缓存，就会导致签名步骤拿着Windows的本地项目路径去Mac文件系统中检索文件，自然触发找不到文件的报错。
• 修正项目的资源打包规则
  若切换Release配置后仍出现相同报错，可修改项目配置排除空路径匹配：
  • 打开iOS项目属性，在iOS Build设置中关闭「Fast Deployment」选项，该选项在归档模式下会跳过Metal着色器的打包流程，导致签名逻辑匹配不存在的.metallib文件
  • 检查项目文件中手动引入的动态库配置，确认所有手动添加的.dylib文件的生成操作设置为RemoteSystem，避免被错误排除在.app包外
• 绕过通配符匹配bug
  若以上操作仍无效，可在iOS Bundle Signing配置页，将自动生成的递归通配符签名规则替换为项目内实际存在的动态库、Metal文件的相对路径，避免Xamarin构建脚本去匹配不存在的空通配符路径。

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