返回

解决 macOS Xcode 错误: resource fork, Finder information...

IOS

macOS Monterey 和 Xcode 中出现 "resource fork, Finder information, or similar detritus not allowed" 错误怎么解决？

构建 iOS 应用时遇到 “resource fork, Finder information, or similar detritus not allowed” 错误，挺让人头疼的，这通常表示你的应用包里有些 macOS 系统不喜欢的“垃圾”文件。

问题原因

简单来说，错误信息提示我们，应用包中包含了资源分叉（resource fork）、Finder 信息或类似的 macOS 特有数据。 从 macOS Catalina (10.15) 开始，苹果对应用签名有更严格的要求，不再允许这些旧式的元数据存在于应用包内。 这些数据通常是在文件复制或者项目迁移时产生的。

更具体的, 这些数据通常与扩展属性 (Extended Attributes, xattr) 相关。 这些扩展属性是一些附加在文件上的元数据, 包含的信息可能干扰代码签名过程。

解决办法

针对这个错误，可以试试下面这几种办法，逐步排除问题：

1. 清理扩展属性 (xattr)

这是最常见也是最有效的解决方法。 你可以用 xattr 命令行工具来查看和删除文件的扩展属性。

  • 原理: 扩展属性是附加到文件上的键值对元数据。某些工具或操作（比如通过网络共享复制文件）可能会在文件上添加一些 macOS 特有的扩展属性，导致代码签名失败。

  • 操作步骤:

    1. 打开终端 (Terminal)。
    2. 定位到你的项目目录（错误信息里有，比如例子中的 /Volumes/Development/Project/Top Best Games/19. Lets Flow/35/let's FLOW - source/proj.ios_mac）。
    3. 用 xattr -lr . 命令查看当前目录及子目录下所有文件的扩展属性。这会列出很多信息，仔细查看是否有可疑的属性，尤其注意 com.apple.FinderInfo 和 com.apple.ResourceFork。
    4. 用 xattr -cr . 命令清除当前目录及子目录下所有文件的扩展属性。 这个命令非常直接, 会移除全部的扩展属性, 小心误操作到重要文件。

  • 代码示例:

    # 切换到项目目录 (根据你自己的错误信息修改路径)
cd /Volumes/Development/Project/Top\ Best\ Games/19.\ Lets\ Flow/35/let\'s\ FLOW\ -\ source/proj.ios_mac

# 查看扩展属性
xattr -lr .

# 清除扩展属性
xattr -cr .

  • 安全建议： 在执行xattr -cr .之前, 最好备份项目。避免意外删除重要数据。如果担心误操作，可以先只删除com.apple.FinderInfo和com.apple.ResourceFork这两个属性：xattr -d com.apple.FinderInfo <filename> 和 xattr -d com.apple.ResourceFork <filename> (把 <filename> 替换成具体的文件名)。

  • 进阶： 假如不想一次性移除所有的扩展属性，而是针对性删除某个文件的扩展属性，可按下面的命令来：

    xattr -l <filename> #查看该文件的扩展属性
xattr -d <attribute_name> <filename> # 删除指定属性

2. 清理 Xcode 缓存

Xcode 的缓存有时候也会导致一些奇怪的问题。 清理一下或许有帮助。

  • 原理: Xcode 会缓存构建过程中的中间文件和数据，有时候这些缓存会损坏或过时，导致构建错误。
  • 操作步骤:
    1. 关闭 Xcode。
    2. 打开 Finder, 点击菜单栏的 "前往" -> "前往文件夹..."。
    3. 输入 ~/Library/Developer/Xcode/DerivedData 并回车，进入 DerivedData 文件夹。
    4. 删除该文件夹下的所有内容。
    5. 重启 Xcode, 重新构建项目。
  • 命令行方式 
    rm -rf ~/Library/Developer/Xcode/DerivedData/*

3. 检查文件系统

如果你的项目位于外部驱动器或网络共享文件夹上，确保文件系统是兼容的。

  • 原理: 某些文件系统（如 FAT32、NTFS）在处理 macOS 扩展属性时可能存在问题，导致文件拷贝后出现这些额外的元数据。
  • 操作步骤:
    1. 检查你项目的存放位置，确定它是在一个兼容的文件系统 (如 APFS, HFS+) 上。
    2. 如果你的项目在不兼容的卷上，考虑把整个工程文件夹移动到本地的、格式化为 APFS 或 HFS+ 的硬盘驱动器上。

4. 检查第三方库或资源

如果你使用了第三方库或资源，它们可能包含了导致问题的元数据。

  • 原理 第三方库和资源包，可能会自带这类属性信息。
  • 操作步骤:
    1. 查看项目有没包含第三方framework或资源包。
    2. 对这些第三方framework及资源包，执行 xattr -cr 清除操作。
    3. 如果可能，尽量通过Cocoapods、Carthage、SPM等方式引入。这些工具一般不会引入额外的东西。

5. 重置代码签名设置

确保你的 Xcode 项目中正确设置了代码签名标识和配置文件。

  • 原理: 错误的签名设置有时可能导致这个问题（虽然错误信息看着不相关）。 确保选中正确的 Provisioning Profile 和 Signing Certificate。
  • 操作步骤:
    1. 打开你的 Xcode 项目。
    2. 点击项目导航栏中的项目文件，选择 "Targets" 下的你的应用。
    3. 选择 "Signing & Capabilities" 选项卡。
    4. 在 "Signing" 部分，确保选择了正确的 Team、Provisioning Profile 和 Signing Certificate。 如果不确定, 可以尝试关闭"Automatically manage signing", 再重新启用。

6. 全新安装(终极方法)

以上操作一般就可以解决了，万一实在不行...那就整个搬迁到新的项目目录，做一次全新安装吧。

  • 原理: 有些文件系统深层潜藏的隐藏属性，难以彻底排查，那就重装。
  • 操作步骤：
    1. 创建新的Xcode项目.
    2. 复制所有源代码文件（.h, .m, .swift 等）到新项目。
    3. 复制资源文件（图片, 声音, 数据文件等），小心不要包含旧项目中的任何构建输出或隐藏的配置文件。
    4. 重新安装任何第三方库和依赖。尽量用CocoaPods, Carthage或Swift Package Manager管理。
    5. 在新项目中重新配置项目的构建设置，包括代码签名。
    6. 测试新的项目,构建，运行。

重要说明： 在尝试任何可能删除文件或更改项目设置的操作之前，强烈建议先备份你的项目! (可以使用 Git 做版本控制，或简单地复制整个项目文件夹到另一个位置)