解决Xcode打包CompileAssetCatalog错误

liuian 2025-08-05 19:29 31 浏览

今天在Jenkins上设置编译打包iOS版本Unity3D游戏项目时遇到一个奇怪的问题，前面的xcode项目导出和编译都没有问题，但在Archive的时候总是出错，错误信息如下

 ** ARCHIVE FAILED **
 
 The following build commands failed:
   CompileAssetCatalog /Users/devops/Library/Developer/Xcode/DerivedData/
   Unity-iPhone-fczjhjylfseudjavxrxfkoxxmflu/Build/Intermediates.noindex/
   ArchiveIntermediates/Unity-iPhone/InstallationBuildProductsLocation/
   Applications/search.app Unity-iPhone/Images.xcassets

在网上搜索，发现大多数遇到类似问题的案例，都是因为Image.xcassets目录下存在一些非法的文件（例如文件名中有空格，或者有pdf或者jpg文件 -- 奇怪的是为什么jpg文件也是非法的？），或者是DeriveData目录缓存的问题导致的。然而我根据这些建议，作了如下尝试：

整理Image.xcassets目录/清空DeriveData目录 - 问题仍然存在

将Image.xcassets目录下的jpg文件全部换成png格式，并去掉文件名中的空格后，编译时仍然报相同的错误；将DeriveData目录清空，Archive 之前 clean builds目录再重新打包，问题也仍然存在。

修改Jenkins脚本运行用户，改为通过当前登录用户执行 - 问题依然存在

后来我尝试不通过Jenkins调用，而是直接在控制台终端执行打包的脚本，则可以打包成功，因此怀疑是Jenkins执行脚本运行权限问题（Jenkins在Mac OS上是通过LaunchDaemon启动的，有专门的运行用户账号），受文章 "
https://afoo.me/posts/2014-12-12-understanding-launch-daemons-of-macosx.html" 启发，尝试：

将 org.jenkins-ci.plist 文件中的运行用户名/用户组修改为登录用户名和登录用户所属组，
修改相关目录的访问权限（/User/Shared/Jenkins）给当前登录用户和所属组
修改/Users/devops/Library/Developer/Xcode/DerivedData/目录权限，给当前登录用户和所属组
将 org.jenkins-ci.plist 从 /Library/LaunchDaemons/ 移动到/Library/LaunchAgents/

重启Jenkins服务器后再次打包，问题依然存在。

在xcode中修改DeriveData路径为相对当前工作空间路径，重启电脑后重新编译 - 问题解决

仍然怀疑可能是访问权限问题（毕竟目前DerivedData在系统的Library目录下），于是到Xcode->Preferences->Locations中，将Derived Data的路径改为”Relative“，即相对当前工作空间的路径 ${Work Space}/DerivedData

修改后执行Product->Clean Build Folder，然后重启电脑（强迫症）后，进入Jenkins执行编译打包，问题顺利解决！

疑问

虽然问题得到解决，但我仍然无法确定导致这个问题的真正原因究竟是什么？

如果是DerivedData目录访问权限的原因，那么我直接将/Library/Developer/Xcode/DerivedData 目录的读写权限赋予Jenkins运行用户为什么不行呢？
网上有用户遇到这个问题，有些通过清空DerivedData，Clean Build Folder后就可以正常编译；有些说重新导入Images.xcassets下的图片资源，移除pdf和jpg文件后也可以正常编译，解决的方法各不相同，但都没有说清楚导致这个问题的原因纠结是什么？

如果哪位朋友知道这个问题的确切原因，还请不吝赐教，谢谢！

xcodebuild