如何用CMake将iOS交叉编译C++共享库封装为Swift共享框架

我之前刚好折腾过类似的C++库转iOS共享框架+Swift调用的需求，踩了不少坑，下面一步步给你捋清楚怎么用CMake搞定这个事儿，包括框架创建、桥接层编写、后台线程处理和Swift调用的全流程。

我们要做的核心三件事：

• 用CMake配置iOS交叉编译，把你的C++库打包成符合iOS规范的.framework共享框架
• 写一个Objective-C++桥接层（后缀.mm），把C++的服务器逻辑封装成Swift能识别的Objective-C API
• 用GCD把C++服务器的启动逻辑放到后台线程，避免阻塞Swift的主线程

首先得把CMake的交叉编译环境搭好，下面是一个完整的CMakeLists.txt模板，你可以根据自己的库路径调整：

cmake_minimum_required(VERSION 3.21)
project(MyCppServerFramework)

# 配置iOS交叉编译参数
set(CMAKE_SYSTEM_NAME iOS)
set(CMAKE_OSX_SYSROOT iphoneos) # 自动匹配当前Xcode的iOS SDK
set(CMAKE_OSX_ARCHITECTURES "arm64;x86_64") # 同时支持真机和模拟器
set(CMAKE_XCODE_ATTRIBUTE_CODE_SIGNING_ALLOWED "NO") # 调试阶段可以先关签名，避免证书问题

# 引入你的C++共享库（如果是源码就add_subdirectory，如果是预编译库就用find_library）
add_subdirectory(path/to/your/cpp/server/library)

# 创建iOS共享框架目标
add_library(MyCppServerFramework SHARED
    ServerBridge.mm # 后面要写的桥接实现文件
)

# 设置框架的核心属性
set_target_properties(MyCppServerFramework PROPERTIES
    FRAMEWORK TRUE
    FRAMEWORK_VERSION A
    MACOSX_FRAMEWORK_IDENTIFIER com.yourcompany.MyCppServerFramework # 改成你的公司标识
    MACOSX_FRAMEWORK_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in # 配置文件模板
    PUBLIC_HEADER ServerBridge.h # 要暴露给Swift的桥接头文件
)

# 链接你的C++库
target_link_libraries(MyCppServerFramework PRIVATE YourCppServerLibrary)

# 指定C++标准（和你的C++库保持一致）
target_compile_features(MyCppServerFramework PRIVATE cxx_std_17)

还需要一个Info.plist.in模板文件，放在CMakeLists.txt同目录下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>CFBundleDisplayName</key>
    <string>MyCppServerFramework</string>
    <key>CFBundleIdentifier</key>
    <string>@MACOSX_FRAMEWORK_IDENTIFIER@</string>
    <key>CFBundleVersion</key>
    <string>1.0</string>
    <key>CFBundleShortVersionString</key>
    <string>1.0</string>
</dict>
</plist>

编译的时候，直接用CMake生成Xcode项目或者直接编译：

mkdir build && cd build
cmake .. -G Xcode
# 然后可以用xcodebuild编译，或者直接打开生成的.xcodeproj文件

桥接层是关键，因为Swift不能直接调用C代码，但可以调用Objective-C代码，而Objective-C（.mm文件）可以同时兼容C++和Objective-C。

首先写暴露给Swift的头文件ServerBridge.h（要加到CMake的PUBLIC_HEADER里）：

#import <Foundation/Foundation.h>

@interface MyCppServerManager : NSObject

/// 在后台线程启动服务器
/// @param port 服务器监听端口
/// @param completion 启动结果回调（回到主线程）
+ (void)startServerInBackgroundWithPort:(NSUInteger)port completion:(void(^)(BOOL success))completion;

/// 停止服务器
+ (void)stopServer;

/// 检查服务器是否在运行
+ (BOOL)isServerRunning;

@end

然后写实现文件ServerBridge.mm，这里处理C++服务器的启动、停止和线程安全：

#import "ServerBridge.h"
#include "your_cpp_server_header.h" // 替换成你的C++服务器头文件

// 全局变量保存服务器实例，用串行队列保证线程安全
static std::unique_ptr<YourCppServerClass> s_server;
static dispatch_queue_t s_serverQueue;

@implementation MyCppServerManager

+ (void)initialize {
    if (self == [MyCppServerManager class]) {
        // 创建串行队列，所有服务器操作都在这个队列里执行，避免多线程竞争
        s_serverQueue = dispatch_queue_create("com.yourcompany.MyCppServerQueue", DISPATCH_QUEUE_SERIAL);
    }
}

+ (void)startServerInBackgroundWithPort:(NSUInteger)port completion:(void(^)(BOOL success))completion {
    dispatch_async(s_serverQueue, ^{
        // 先检查服务器是否已经在运行
        if (s_server) {
            dispatch_async(dispatch_get_main_queue(), ^{
                completion(YES);
            });
            return;
        }
        
        try {
            // 初始化C++服务器
            s_server = std::make_unique<YourCppServerClass>(port);
            // 启动服务器（假设你的C++服务器的start()方法是阻塞式的，会一直运行直到stop被调用）
            s_server->start();
            
            dispatch_async(dispatch_get_main_queue(), ^{
                completion(YES);
            });
        } catch (const std::exception& e) {
            NSLog(@"服务器启动失败: %s", e.what());
            s_server.reset();
            dispatch_async(dispatch_get_main_queue(), ^{
                completion(NO);
            });
        }
    });
}

+ (void)stopServer {
    dispatch_async(s_serverQueue, ^{
        if (s_server) {
            // 调用C++服务器的停止方法，要确保这个方法能让start()退出阻塞
            s_server->stop();
            s_server.reset();
        }
    });
}

+ (BOOL)isServerRunning {
    __block BOOL running = NO;
    // 用同步队列获取状态，保证线程安全
    dispatch_sync(s_serverQueue, ^{
        running = (s_server != nullptr);
    });
    return running;
}

@end

这里要注意：你的C++服务器必须支持优雅停止，比如用一个原子布尔变量作为运行标志，start()方法里循环检查这个标志，stop()方法设置标志为false，这样start()才能退出阻塞。

把编译好的MyCppServerFramework.framework拖到你的Xcode Swift项目里，然后直接调用就行：

import MyCppServerFramework

// 启动服务器
MyCppServerManager.startServerInBackground(withPort: 8080) { success in
    if success {
        print("服务器启动成功！")
        // 这里可以写Swift端的连接逻辑，比如用URLSession连接本地服务器
    } else {
        print("服务器启动失败")
    }
}

// 停止服务器（比如在页面销毁时调用）
// MyCppServerManager.stopServer()

// 检查服务器状态
// let isRunning = MyCppServerManager.isServerRunning()

• 交叉编译失败：检查CMake版本是否≥3.21（iOS框架支持需要这个版本以上），Xcode是否安装正确，CMAKE_OSX_SYSROOT是否能找到iOS SDK
• Swift找不到框架方法：确保ServerBridge.h被加到了CMake的PUBLIC_HEADER里，框架的Info.plist配置正确，编译时没有报错
• 服务器阻塞主线程：一定要把C++服务器的start()方法放到GCD的后台队列里，不能在主线程调用阻塞方法
• 线程安全问题：所有操作服务器实例的代码都要放到同一个串行队列里，避免多线程同时读写导致的崩溃

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