如何在Swift Framework的.swiftinterface文件中隐藏内部依赖？

要让Alamofire、Lottie、TensorFlowLite这些内部依赖不暴露给框架使用者，核心是将依赖的使用限制在框架内部，避免公共API直接引用依赖类型，同时确保依赖被静态打包进框架。具体做法如下：

• 用访问控制隔离内部实现
  框架中所有直接调用依赖的类、方法、属性，都保持默认的internal访问级别（不要标记为public/open）。公共接口只暴露你自己定义的类型，比如：

  // 内部使用Alamofire的类，仅框架可见
  internal class InternalAPIClient {
      func fetchData() async throws -> Data {
          return try await AF.request("https://example.com").serializingData().value
      }
  }
  
  // 暴露给使用者的公共服务类，不涉及Alamofire类型
  public class APIService {
      private let client = InternalAPIClient()
      
      public func loadData(completion: @escaping (Result<Data, Error>) -> Void) {
          Task {
              do {
                  let data = try await client.fetchData()
                  completion(.success(data))
              } catch {
                  completion(.failure(error))
              }
          }
      }
  }
  

• 封装内部依赖的逻辑
  对每个外部依赖做一层封装，框架内部依赖封装层，公共接口只和封装层交互。比如针对Lottie，写一个InternalAnimationPlayer处理动画播放逻辑，公共的AnimationService只提供启动/停止动画的方法，完全隐藏Lottie的LottieAnimationView等类型。

• 静态链接依赖到框架
  确保依赖被静态打包进你的框架，这样使用者不需要单独安装这些库：

  • 如果用Swift Package Manager，在Package.swift中指定依赖的产品类型为静态：

    dependencies: [
        .package(url: "https://github.com/Alamofire/Alamofire.git", from: "5.8.0"),
    ],
    targets: [
        .target(
            name: "YourFramework",
            dependencies: [
                .product(name: "Alamofire", package: "Alamofire", type: .static)
            ]
        ),
    ]
    

  • 如果用CocoaPods，在Podfile中设置静态链接：

    use_frameworks! :linkage => :static
    pod 'Alamofire', '~> 5.8'
    pod 'Lottie', '~> 4.0'
    

• 检查并清理公共接口
  构建框架后，查看生成的.swiftinterface文件（位于框架包的Modules/YourFramework.swiftmodule目录下），确认没有依赖类型意外暴露。如果发现有，回溯代码找到公共API中引用依赖类型的地方，替换成自定义类型或调整访问级别。

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