解决Hermes引擎在Xcode 16中的Bitcode验证问题

在React Native项目中使用Hermes引擎时，开发者可能会遇到Xcode 16上传应用到App Store时出现的"Asset validation failed"错误。这个错误提示表明Hermes框架中包含了Bitcode，而苹果在Xcode 16中对此有更严格的验证要求。

问题背景

Bitcode是苹果引入的一种中间代码格式，允许苹果在提交应用后重新优化应用的二进制文件。然而，随着Xcode版本的更新，苹果对Bitcode的支持政策发生了变化。在Xcode 16中，苹果不再允许框架中包含Bitcode，这导致了使用Hermes引擎的React Native项目在上传时出现验证失败的问题。

解决方案

方法一：使用bitcode_strip工具

最有效的解决方案是使用Xcode自带的bitcode_strip工具手动移除Hermes框架中的Bitcode。这可以通过在Podfile中添加post_install脚本来实现：

post_install do |installer|
  bitcode_strip_path = `xcrun --find bitcode_strip`.chop!
  
  def strip_bitcode(bitcode_strip_path, framework_path)
    command = "#{bitcode_strip_path} #{framework_path} -r -o #{framework_path}"
    puts "Stripping bitcode: #{command}"
    system(command)
  end

  framework_paths = [
    "Pods/hermes-engine/destroot/Library/Frameworks/universal/hermes.xcframework/ios-arm64/hermes.framework/hermes",
    "Pods/hermes-engine/destroot/Library/Frameworks/universal/hermes.xcframework/ios-arm64_x86_64-simulator/hermes.framework/hermes",
    "Pods/hermes-engine/destroot/Library/Frameworks/macosx/hermes.framework/hermes"
  ]

  framework_paths.each do |path|
    strip_bitcode(bitcode_strip_path, path) if File.exist?(path)
  end
end

方法二：动态查找Hermes二进制文件

对于更复杂的项目结构或使用CI/CD系统的情况，可以使用Ruby的Dir.glob方法动态查找所有Hermes二进制文件：

post_install do |installer|
  bitcode_strip_path = `xcrun --find bitcode_strip`.chomp
  
  Dir.glob("Pods/hermes-engine/**/*.framework/hermes").each do |hermes_bin|
    system("#{bitcode_strip_path} #{hermes_bin} -r -o #{hermes_bin}")
  end
end

方法三：处理其他框架的Bitcode问题

除了Hermes，项目中可能还有其他框架也包含Bitcode。常见的包括Facebook SDK、LogRocket等。可以扩展framework_paths数组来包含这些框架：

framework_paths = [
  "Pods/FBSDKCoreKit/XCFrameworks/FBSDKCoreKit.xcframework/ios-arm64/FBSDKCoreKit.framework/FBSDKCoreKit",
  "Pods/LogRocket/LogRocket.xcframework/ios-arm64/LogRocket.framework/LogRocket",
  # 添加其他框架路径
]

实施步骤

1. 打开项目中的ios/Podfile文件
2. 在文件末尾的post_install块中添加上述代码
3. 运行pod install --repo-update命令
4. 清理项目(包括Derived Data)
5. 重新构建并上传应用

注意事项

• 路径可能因项目结构或React Native版本不同而有所变化
• 在CI/CD环境中使用时，需要确保路径正确
• 即使解决了Bitcode问题，Xcode可能仍会显示警告，这通常不会影响应用上传
• 对于React Native 0.73及以上版本，这个问题可能已经被修复

总结

Xcode 16对Bitcode的严格验证导致使用Hermes引擎的React Native项目在上传时遇到问题。通过使用bitcode_strip工具手动移除框架中的Bitcode，开发者可以顺利解决这个验证错误。这种方法不仅适用于Hermes，也可以扩展到项目中其他可能包含Bitcode的框架。

对于长期解决方案，建议考虑升级到React Native的最新版本，因为官方可能已经针对这个问题进行了修复。同时，保持对苹果开发者文档的关注，了解Bitcode相关政策的任何变化。