如何配置iOS项目以同时使用SQLCipher与依赖SQLite3的第三方Pod？

核心思路 #

本质是让项目优先链接SQLCipher的库，覆盖系统或其他Pod引入的SQLite3符号，避免重复定义冲突。以下是经过验证的具体配置步骤：

1. 调整Podfile配置 #

在Podfile里明确引入SQLCipher，同时对依赖SQLite3的第三方Pod（比如Adobe Mobile SDK）做特殊处理，移除它们对原生SQLite3的依赖：

platform :ios, '14.0'

target 'YourAppTarget' do
  use_frameworks!

  # 引入SQLCipher
  pod 'SQLCipher'

  # 引入依赖SQLite3的第三方Pod（示例为Adobe Mobile SDK）
  pod 'AdobeMobileSDK'

  # 关键：移除依赖SQLite3的Pod对原生SQLite3的链接
  post_install do |installer|
    installer.pods_project.targets.each do |target|
      # 匹配需要处理的目标，可根据实际Pod名称调整
      if target.name.start_with?('Adobe') || target.name == 'SQLite3'
        target.build_configurations.each do |config|
          config.build_settings['OTHER_LDFLAGS'] = config.build_settings['OTHER_LDFLAGS'].reject { |flag| flag.include?('sqlite3') }
        end
      end
    end
  end
end

修改后执行pod install重新安装依赖。

2. 调整Xcode项目链接顺序与参数 #

• 打开Xcode项目，进入目标工程的Build Settings
• 搜索Other Linker Flags，添加-ObjC和-force_load "$(PODS_ROOT)/SQLCipher/libSQLCipher.a"，强制优先加载SQLCipher静态库
• 搜索Library Search Paths，确认$(PODS_ROOT)/SQLCipher已在列表中，且优先级高于系统SQLite路径
• 进入Build Phases > Link Binary With Libraries，把libSQLCipher.a移到最顶部，确保它最先被链接

3. 设置编译宏定义 #

在目标工程的Build Settings中搜索Preprocessor Macros，添加SQLITE_HAS_CODEC=1和SQLCIPHER_CRYPTO_CC，确保SQLCipher的加密功能正常启用，同时让项目优先使用SQLCipher的头文件定义。

4. 验证冲突解决 #

先清理项目（Cmd+Shift+K），再重新编译。如果还出现重复定义错误，检查这几点：

• 确认所有依赖SQLite3的Pod都已移除对原生SQLite3的链接配置
• 检查Other Linker Flags里有没有残留的sqlite3相关参数
• 确保使用的是SQLCipher的最新稳定版本

关键原理 #

通过强制优先链接SQLCipher的静态库，让项目中所有SQLite相关的符号调用都指向SQLCipher的实现，替代原生SQLite3或其他Pod引入的SQLite版本，从根源上解决符号重复定义的问题。

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