Formbricks iOS SDK独立仓库迁移与多平台发布指南

在移动应用开发领域，提供高质量的SDK对于开发者体验至关重要。本文将详细介绍Formbricks团队如何将其iOS SDK从单体仓库迁移至独立仓库，并实现Swift Package Manager和CocoaPods双平台发布的完整技术方案。

背景与挑战

随着Formbricks产品生态的扩展，原先存放在单体仓库中的iOS SDK面临几个关键问题：版本管理不够灵活、依赖关系复杂、发布流程耦合度高。将iOS SDK迁移至独立仓库能够带来以下优势：

1. 独立的版本控制能力
2. 更清晰的代码所有权
3. 简化的依赖管理
4. 更高效的CI/CD流程

技术实现方案

1. 代码迁移与仓库重构

迁移过程首先需要将原有代码从packages/ios目录完整提取到新仓库。这包括：

• 核心功能实现代码
• 单元测试与UI测试套件
• 资源文件(如图片、本地化文件)
• 构建配置与脚本

迁移后需要特别注意保持Git历史记录的连续性，这可以通过git filter-branch或git subtree split等命令实现。

2. Swift Package Manager集成

SPM作为苹果官方推荐的依赖管理工具，其集成需要创建Package.swift清单文件。关键配置包括：

// Package.swift示例
let package = Package(
    name: "Formbricks",
    platforms: [
        .iOS(.v13)
    ],
    products: [
        .library(
            name: "Formbricks",
            targets: ["Formbricks"]),
    ],
    dependencies: [
        // 声明第三方依赖
    ],
    targets: [
        .target(
            name: "Formbricks",
            dependencies: [],
            path: "Sources",
            resources: [.process("Resources")]),
        .testTarget(
            name: "FormbricksTests",
            dependencies: ["Formbricks"],
            path: "Tests")
    ]
)

需要注意正确处理资源文件路径，确保在SPM构建流程中能够正确打包。

3. CocoaPods支持实现

对于仍在使用CocoaPods的开发者，需要创建.podspec文件：

Pod::Spec.new do |s|
  s.name             = 'Formbricks'
  s.version          = '1.0.0'
  s.summary          = 'Formbricks官方iOS SDK'
  s.homepage         = 'https://formbricks.com'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'Formbricks Team' => '[e-mail]' }
  s.source           = { :git => 'https://github.com/formbricks/ios.git', :tag => s.version.to_s }
  s.ios.deployment_target = '13.0'
  s.source_files = 'Sources/**/*.swift'
  s.resource_bundles = {
    'Formbricks' => ['Resources/**/*']
  }
end

4. 本地验证流程

在正式发布前，必须进行全面的本地验证：

SPM验证步骤：

1. 创建测试项目
2. 通过文件系统本地引用SDK
3. 验证编译、链接和运行时行为
4. 测试资源加载功能

CocoaPods验证步骤：

1. 执行pod lib lint检查规范
2. 创建测试项目并通过本地路径集成
3. 验证所有功能模块

5. 版本发布管理

采用语义化版本控制(SemVer)策略：

1. 创建带注释的Git标签：git tag -a 1.0.0 -m "Initial release"
2. 推送标签至远程仓库
3. 对于CocoaPods发布，执行pod trunk push命令

文档与开发者体验

良好的文档是SDK易用性的关键。需要提供：

1. 安装指南：详细说明SPM和CocoaPods两种方式的集成步骤
2. 快速开始：展示基础功能的使用示例
3. API参考：重要类和方法的详细说明
4. 迁移指南：针对从旧版本迁移的说明
5. 常见问题：收集开发者可能遇到的问题

持续集成与质量保证

建议在新仓库中配置以下自动化流程：

1. 单元测试与UI测试流水线
2. 代码静态分析(Linter)
3. 发布前自动化验证
4. 文档生成与发布

总结

通过将Formbricks iOS SDK迁移至独立仓库并实现多平台发布支持，团队获得了更灵活的版本控制能力和更高效的发布流程。这种架构也为未来的功能扩展和性能优化奠定了坚实基础。开发者现在可以根据项目需求选择SPM或CocoaPods任一方式集成SDK，大大提升了使用体验。