Rocket.Chat React Native 项目在 Xcode 16 下的构建问题解决方案

问题背景

随着 macOS Sequoia 和 Xcode 16 的发布，Rocket.Chat React Native 项目在 iOS 平台上的构建遇到了多个技术障碍。这些问题主要涉及依赖库兼容性和构建配置方面，影响了开发者的正常开发流程。

核心问题分析

构建失败主要源于以下几个技术点：

1. WatermelonDB 头文件引用问题：Xcode 16 对头文件引用路径的处理更加严格，导致 WatermelonDB 的桥接头文件无法正确引用。

2. Bitcode 支持变更：Xcode 16 不再支持 Bitcode，而项目中某些依赖库仍包含 Bitcode 信息。

3. 依赖库兼容性问题：特别是 react-native-image-crop-picker 和 expo-apple-authentication 这两个库存在与新 Xcode 版本的兼容性问题。

详细解决方案

WatermelonDB 头文件修复

需要修改 WatermelonDB 的 podspec 文件，调整头文件引用方式：

diff --git a/node_modules/@nozbe/watermelondb/WatermelonDB.podspec b/node_modules/@nozbe/watermelondb/WatermelonDB.podspec
index e9fea58..cfc33ee 100644
--- a/node_modules/@nozbe/watermelondb/WatermelonDB.podspec
+++ b/node_modules/@nozbe/watermelondb/WatermelonDB.podspec
@@ -14,7 +14,7 @@ Pod::Spec.new do |s|
   s.source = { :git => "https://github.com/Nozbe/WatermelonDB.git", :tag => "v#{s.version}" }
   s.source_files = "native/ios/**/*.{h,m,mm,swift,c,cpp}", "native/shared/**/*.{h,c,cpp}"
   s.public_header_files = [
-    'native/ios/WatermelonDB/SupportingFiles/Bridging.h',
+    'native/ios/**/*.h',
     'native/ios/WatermelonDB/JSIInstaller.h',
   ]
   s.requires_arc = true

Bitcode 处理方案

由于 Xcode 16 不再支持 Bitcode，需要手动移除依赖库中的 Bitcode 信息。在 Podfile 的 post_install 阶段添加以下脚本：

bitcode_strip_path = `xcrun --find bitcode_strip`.chop!
def strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
  framework_path = File.join(Dir.pwd, framework_relative_path)
  command = "#{bitcode_strip_path} #{framework_path} -r -o #{framework_path}"
  puts "Stripping bitcode: #{command}"
  system(command)
end

framework_paths = [
  "Pods/FBAEMKit/XCFrameworks/FBAEMKit.xcframework/ios-arm64/FBAEMKit.framework/FBAEMKit",
  "Pods/FBSDKCoreKit/XCFrameworks/FBSDKCoreKit.xcframework/ios-arm64/FBSDKCoreKit.framework/FBSDKCoreKit",
  "Pods/FBSDKCoreKit_Basics/XCFrameworks/FBSDKCoreKit_Basics.xcframework/ios-arm64/FBSDKCoreKit_Basics.framework/FBSDKCoreKit_Basics",
  "Pods/FBSDKGamingServicesKit/XCFrameworks/FBSDKGamingServicesKit.xcframework/ios-arm64/FBSDKGamingServicesKit.framework/FBSDKGamingServicesKit",
  "Pods/FBSDKLoginKit/XCFrameworks/FBSDKLoginKit.xcframework/ios-arm64/FBSDKLoginKit.framework/FBSDKLoginKit",
  "Pods/FBSDKShareKit/XCFrameworks/FBSDKShareKit.xcframework/ios-arm64/FBSDKShareKit.framework/FBSDKShareKit",
  "Pods/OpenSSL-Universal/Frameworks/OpenSSL.xcframework/ios-arm64_armv7/OpenSSL.framework/OpenSSL",
]

framework_paths.each do |framework_relative_path|
  strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
end

依赖库升级建议

将以下依赖库升级到最新版本：

1. react-native-image-crop-picker 升级到 0.41.2 或更高版本
2. expo-apple-authentication 升级到 6.4.2 或更高版本

临时兼容性修复

对于某些数据库操作函数，可能需要临时注释掉实现代码以避免编译错误：

// WatermelonDB+Extensions.swift
func query<T: Codable>(raw: SQL, _ args: QueryArgs = []) -> [T] {
    return []
}

// Database.swift
func readRoomEncryptionKey(rid: String) -> String? {
    return nil
}

func readRoomEncrypted(rid: String) -> Bool {
    return false
}

实施步骤

1. 应用上述所有修改
2. 运行 pod install 命令
3. 处理可能出现的 TOCropViewController 相关错误
4. 最后执行 yarn ios 启动项目

技术原理

这些解决方案背后的技术原理包括：

1. 头文件引用调整：通过扩大头文件搜索范围，确保编译器能找到所有必要的头文件。

2. Bitcode 移除：使用 Xcode 工具链中的 bitcode_strip 工具主动移除不再支持的 Bitcode 信息。

3. 依赖升级：利用库作者针对新 Xcode 版本发布的兼容性更新。

注意事项

1. 实施这些修改后，建议在团队内部进行充分测试，确保功能完整性。

2. 数据库相关函数的临时修改可能会影响某些功能，应尽快寻找永久解决方案。

3. 不同项目可能需要调整 framework_paths 中的路径列表，根据实际使用的依赖库进行调整。

4. 建议关注 Rocket.Chat React Native 项目的官方更新，及时应用正式的兼容性修复。

通过以上技术方案，开发者可以在 Xcode 16 环境下顺利构建和运行 Rocket.Chat React Native 项目，同时为未来的正式兼容性更新做好准备。