使用FastBuild实现自定义C++库与libcurl源码一同分发及按需构建

第一步：libcurl源码集成 #

• 将libcurl官方源码的核心目录（include、src）存放到你仓库的第三方依赖目录下，例如3rdparty/libcurl，无需保留libcurl自带的其他构建系统配置文件，避免和你的FastBuild逻辑冲突，可复用现有集成tinyxml的目录管理逻辑。
• 新增全局构建开关FB_BUILD_CURL_FROM_SRC，默认值设为true，支持用户自定义是否使用你仓库内置的libcurl源码构建。

第二步：FastBuild脚本配置 #

• 编写独立的libcurl编译目标，继承你工程的全局编译参数（包括运行时类型、优化级别、目标架构、平台标识等），避免编译参数不匹配导致的兼容性问题。
• 把libcurl的特性裁剪选项（例如协议禁用开关CURL_DISABLE_FTP、SSL后端选择参数等）封装为可配置的全局变量，无需用户修改你的构建脚本即可调整libcurl的编译特性。
• 将libcurl编译目标设为你自研C++库的前置依赖，自动关联头文件路径和编译输出的lib文件，对用户完全透明，逻辑和现有tinyxml的集成逻辑对齐。
• 脚本中增加平台适配逻辑：Windows静态编译时自动添加CURL_STATICLIB宏定义，Linux/macOS构建时自动链接pthread、dl等系统依赖库。

以下是参考脚本片段：

// 全局可配置参数
.FB_BUILD_CURL_FROM_SRC = true // 构建时传入false可切换为链接系统libcurl
.CurlCustomDefines = [
    'CURL_STATICLIB',
    'CURL_DISABLE_FTP',
    'CURL_DISABLE_SMB'
]

// libcurl编译目标
Library('libcurl_builtin')
{
    .Compiler = $GlobalCompiler
    .CompilerOptions = $GlobalCompileOpts + .CurlCustomDefines
    .IncludePaths = '3rdparty/libcurl/include'
    .InputFiles = '3rdparty/libcurl/src/*.c'
    .Platform = $TargetPlatform
    .Output = '$OutputDir/libcurl.lib'
}

// 自研库编译目标
Library('your_custom_lib')
{
    .Compiler = $GlobalCompiler
    .CompilerOptions = $GlobalCompileOpts
    .IncludePaths = 'include' + '3rdparty/libcurl/include'
    .InputFiles = 'src/*.cpp'
    // 根据开关自动选择依赖来源
    .Libraries = .FB_BUILD_CURL_FROM_SRC ? 'libcurl_builtin' : $SystemLibcurlPath
    .Platform = $TargetPlatform
    .Output = '$OutputDir/your_custom_lib.lib'
}

第三步：用户侧使用适配 #

• 默认场景下用户拉取代码后直接执行原有构建命令即可，自动编译内置libcurl和你的自研库，无额外配置步骤。
• 若用户需要自定义libcurl的编译特性，直接在构建命令中传入对应的参数即可，例如要开启OpenSSL支持可传入CurlCustomDefines += 'CURL_USE_OPENSSL=1'。
• 若用户希望使用本地已安装的libcurl，只需在构建时传入FB_BUILD_CURL_FROM_SRC=false，脚本会自动链接系统路径下的libcurl，适配特殊场景需求。

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