将Firebase二进制xcframework封装为SPM包并解决链接错误

针对Undefined symbol和GoogleAppMeasurement链接失败的修复步骤 #

• 检查XCFramework完整性：确认从Firebase官网下载的XCFramework包含所有必需架构（arm64、x86_64），以及GoogleAppMeasurement相关的依赖XCFramework（比如GoogleAppMeasurement.xcframework、GoogleUtilities.xcframework等），Firebase核心依赖链较长，不能只导入单个Firebase模块。
• 修正Package.swift配置：
  1. 在products里的FirebaseWrapper目标中，确保所有依赖的XCFramework都被正确声明为binaryTarget，示例：

  let package = Package(
      name: "FirebaseWrapper",
      products: [
          .library(name: "FirebaseWrapper", targets: ["FirebaseWrapper"]),
      ],
      targets: [
          .target(
              name: "FirebaseWrapper",
              dependencies: [
                  .target(name: "FirebaseCore"),
                  .target(name: "GoogleAppMeasurement"),
                  // 其他依赖的XCFramework目标
              ]
          ),
          .binaryTarget(name: "FirebaseCore", path: "artifacts/FirebaseCore.xcframework"),
          .binaryTarget(name: "GoogleAppMeasurement", path: "artifacts/GoogleAppMeasurement.xcframework"),
          // 逐个添加所有依赖的XCFramework
      ]
  )
  

  2. 确保FirebaseWrapper的target中，linkerSettings添加必要的链接标记，比如针对GoogleAppMeasurement的-ObjC：

  linkerSettings: [
      .linkedFlag("-ObjC")
  ]
  

• 关闭自动链接冲突：在项目的Build Settings中，找到Other Linker Flags，添加-Xlinker -no_google_app_measurement_auto_link，避免手动导入二进制后自动链接重复引入导致冲突。
• 验证构建阶段顺序：确保FirebaseWrapper在项目的Link Binary With Libraries阶段排在所有其他依赖之前，并且没有重复导入相同的Firebase模块。
• 清理缓存：执行Xcode的Product > Clean Build Folder，删除DerivedData目录后重新构建项目。

• Xcode官方文档：重点研读「Build System Overview」「Framework Programming Guide」章节，理解Xcode构建流程、依赖解析规则，以及静态/动态框架的核心区别。
• WWDC视频：
  • WWDC 2020「Build System Best Practices」：讲解构建系统优化、依赖管理的实用技巧。
  • WWDC 2019「Modernizing Your Build for Swift 5」：涉及Swift Package与二进制框架的集成要点。
• Swift Package Manager官方指南：深入学习Package.swift的配置细节，尤其是二进制目标声明、依赖链管理逻辑。
• 书籍《iOS App Architecture》：其中有专门章节讲解框架编排、模块化设计，以及构建速度优化的实践方案。

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