在 iOS 项目开发中，我们常常需要引入第三方静态库（.a 文件）来使用特定功能，比如某些闭源 SDK、游戏手柄驱动、音频编解码模块等。本文结合实际问题，介绍如何在 Swift 组件中通过 CocoaPods 集成第三方静态库，并解决架构不匹配、模块导入失败等常见问题。

一、问题背景

我们拿到的 SDK 内容包括：

• libWechatOpenSDK.a：静态库
• .h 头文件
• 无 modulemap 文件
• 仅支持 arm64（真机架构）

目标是通过 CocoaPods 本地集成该库，并暴露给 Swift 使用。

二、创建 Podspec 文件

创建 WechatOpenSDK.podspec，内容如下：

Pod::Spec.new do |s|
  s.name         = 'WechatOpenSDK'
  s.version      = '2.0.4'
  s.summary      = '本地集成的微信 OpenSDK'
  s.homepage     = 'https://open.weixin.qq.com'
  s.license      = { :type => 'Commercial' }
  s.author       = { 'WeChat' => 'wechat@tencent.com' }
  s.source       = { :path => '.' }

  s.ios.deployment_target = '9.0'
  s.swift_version = '5.0'
  s.requires_arc = true
  s.static_framework = true
  
  # 真机
  #s.source_files         = 'WechatOpenSDK/ios-arm64_armv7/*'
  #s.vendored_libraries   = 'WechatOpenSDK/ios-arm64_armv7/*.a'
  
  # 模拟器
  s.source_files         = 'WechatOpenSDK/ios-arm64_i386_x86_64-simulator/*'
  s.vendored_libraries   = 'WechatOpenSDK/ios-arm64_i386_x86_64-simulator/*.a'
  
  # SDK依赖
  s.libraries = 'c++'
  
end