基于CMake的Qt iOS项目Swift库导入Objective-C问题排查

问题1：YandexMobileAds头文件无法被.mm文件找到 #

核心原因 #

1. CMake生成的主项目未配置Pod头文件搜索路径：CocoaPods安装的头文件默认存放在Pods/Headers/Public目录下，但CMake不会自动将这个路径加入项目的头文件搜索列表。
2. 未启用模块化导入：YandexMobileAds包含Swift代码，需要通过模块化方式导入头文件，而非相对路径；若Podfile未配置use_modular_headers!或use_frameworks!，会导致自动生成的YandexMobileAds-Swift.h无法被正确识别。
3. Build Phases无Headers环节：CMake生成的iOS App项目默认不会显示Headers阶段，因为Qt的CMake配置将头文件处理逻辑封装了，无需手动添加，重点还是要靠CMake配置路径。

解决步骤 #

• 在CMakeLists.txt中，为你的Qt iOS目标添加Pod头文件搜索路径：

  target_include_directories(YourQtTargetName
    PRIVATE
    ${CMAKE_CURRENT_BINARY_DIR}/Pods/Headers/Public
    ${CMAKE_CURRENT_BINARY_DIR}/Pods/Headers/Public/YandexMobileAds
  )
  

  注意：${CMAKE_CURRENT_BINARY_DIR}是CMake的构建目录，需对应你执行pod install的路径。
• 确保Podfile中添加模块化配置：

  use_modular_headers!
  pod 'YandexMobileAds'
  

  之后重新执行pod install，再在.mm文件中用模块化方式导入：

  #import <YandexMobileAds/YandexMobileAds-Swift.h>
  

• 验证Xcode项目的头文件搜索路径：打开xcworkspace，进入主项目的Build Settings -> Header Search Paths，确认是否包含Pods/Headers/Public的递归路径（若CMake配置正确，这里会自动生成）。

问题2：仅生成YandexMobileAds头文件，无YandexMobileAdsMediation头文件 #

核心原因 #

1. Podfile未引入mediation相关依赖：YandexMobileAds的mediation库是独立的Pod，需单独声明，默认只安装YandexMobileAds不会自动包含mediation组件。
2. Mediation Pod未正确安装：若Podfile中有声明但未生成头文件，可能是Pod版本不兼容、网络问题导致安装不完整，或mediation库本身是静态库且头文件未公开。

解决步骤 #

• 修改Podfile，添加需要的mediation适配器，例如：

  use_modular_headers!
  pod 'YandexMobileAds'
  # 示例：添加AdMob mediation适配器
  pod 'YandexMobileAdsMediationAdMob'
  

• 执行pod update或pod install --repo-update，确保mediation Pod被完整下载。
• 检查Pods/Headers/Public目录下是否存在YandexMobileAdsMediationXXX文件夹，若存在，在CMakeLists.txt中添加对应路径到target_include_directories，然后用模块化方式导入头文件。

问题3：通过CMake为Qt iOS项目添加Swift包 #

可以实现，以下是两种可行方案：

方案1：利用CMake原生Swift支持（CMake 3.15+） #

1. 在CMakeLists.txt中启用Swift语言支持：

   enable_language(Swift)
   

2. 使用FetchContent拉取Swift包源码（若包支持CMake构建）：

   include(FetchContent)
   FetchContent_Declare(
     YourSwiftPackage
     GIT_REPOSITORY https://github.com/xxx/xxx.git
     GIT_TAG        1.0.0
   )
   FetchContent_MakeAvailable(YourSwiftPackage)
   

3. 将Swift包的目标链接到你的Qt iOS目标：

   target_link_libraries(YourQtTargetName
     PRIVATE
     YourSwiftPackageTarget
   )
   

方案2：结合Xcode Swift Package Manager集成 #

1. 打开xcworkspace，通过Xcode的File -> Add Packages...添加Swift包，完成后Xcode会自动生成对应的库目标。
2. 在CMakeLists.txt中，链接Xcode生成的Swift库：

   find_library(SWIFT_PACKAGE_LIB
     NAMES YourSwiftPackageName
     PATHS ${CMAKE_CURRENT_BINARY_DIR}/YourSwiftPackageName.build/Debug-iphoneos
     NO_DEFAULT_PATH
   )
   target_link_libraries(YourQtTargetName
     PRIVATE
     ${SWIFT_PACKAGE_LIB}
   )
   

3. 若Swift包包含头文件，同样需要在CMake中添加对应的头文件搜索路径。

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