使用覆盖三联密码

项目
01/10/2024

在 Linux 上构建动态库

可以使用 vcpkg 立即为很多配置构建库。但是，目前不包括 Linux 和 Mac OS 上的共享库。

这并不意味着无法使用 vcpkg 在这些平台上构建动态库！本文档将指导你通过使用 --overlay-triplets 创建自定义三联密码，在 Linux 上轻松构建动态库。

步骤 1：创建自定义三联密码文件

为了节省时间，请复制现有的 x64-linux.cmake 三联密码文件。

~/git$ mkdir custom-triplets
~/git$ cp vcpkg/triplets/x64-linux.cmake custom-triplets/x64-linux-dynamic.cmake

修改 custom-triplets/x64-linux-dynamic.cmake 以匹配以下内容：

# ~/git/custom-triplets/x64-linux-dynamic.cmake
set(VCPKG_TARGET_ARCHITECTURE x64)
set(VCPKG_CRT_LINKAGE dynamic)
set(VCPKG_LIBRARY_LINKAGE dynamic) # This changed from static to dynamic

set(VCPKG_CMAKE_SYSTEM_NAME Linux)

步骤 2：使用 `--overlay-triplets` 构建动态库

使用 --overlay-triplets 选项包含 custom-triplets 目录中的三联密码。

~/git$ vcpkg/vcpkg install sqlite3:x64-linux-dynamic --overlay-triplets=custom-triplets
The following packages will be built and installed:
    sqlite3[core]:x64-linux-dynamic
Starting package 1/1: sqlite3:x64-linux-dynamic
Building package sqlite3[core]:x64-linux-dynamic...
-- Loading triplet configuration from: /home/victor/git/custom-triplets/x64-linux-dynamic.cmake
-- Downloading https://sqlite.org/2019/sqlite-amalgamation-3280000.zip...
-- Extracting source /home/victor/git/vcpkg/downloads/sqlite-amalgamation-3280000.zip
-- Applying patch fix-arm-uwp.patch
-- Using source at /home/victor/git/vcpkg/buildtrees/sqlite3/src/3280000-6a3ff7ce92
-- Configuring x64-linux-dynamic-dbg
-- Configuring x64-linux-dynamic-rel
-- Building x64-linux-dynamic-dbg
-- Building x64-linux-dynamic-rel
-- Performing post-build validation
-- Performing post-build validation done
Building package sqlite3[core]:x64-linux-dynamic... done
Installing package sqlite3[core]:x64-linux-dynamic...
Installing package sqlite3[core]:x64-linux-dynamic... done
Elapsed time for package sqlite3:x64-linux-dynamic: 44.82 s

Total elapsed time: 44.82 s

The package sqlite3:x64-linux-dynamic provides CMake targets:

    find_package(unofficial-sqlite3 CONFIG REQUIRED)
    target_link_libraries(main PRIVATE unofficial::sqlite3::sqlite3)

使用 vcpkg install、vcpkg update、vcpkg upgrade 和 vcpkg remove 时，覆盖三联密码让你可以使用自定义三联文件。

使用 --overlay-triplets 选项时，会显示一条如下所示的消息，告诉你正在使用的是自定义三联密码：

-- Loading triplet configuration from: /home/custom-triplets/x64-linux-dynamic.cmake

覆盖默认三联密码

如前所述，Windows（x86-windows 和 x64-windows）的默认三联密码安装动态库，而静态库则需要一个后缀 (-static)。这与 Linux 和 Mac OS 不同，这两个操作系统中的静态库是由 x64-linux 和 x64-osx 构建的。

可以使用 --overlay-triplets 覆盖默认三联密码以在 Linux 上实现相同的行为：

x64-linux：构建动态库，
x64-linux-static：构建静态库。

步骤 1：创建覆盖三联密码

使用在上一示例中创建的自定义三联密码，将 custom-triplets/x64-linux-dynamic.cmake 重命名为 custom-triplets/x64-linux.cmake。然后，复制 custom-triplets 文件夹中的默认 x64-linux 三联密码（会构建静态库），并将其重命名为 x64-linux-static.cmake。

~/git$ mv custom-triplets/x64-linux-dynamic.cmake custom-triplets/x64-linux.cmake
~/git$ cp vcpkg/triplets/x64-linux.cmake custom-triplets/x64-linux-static.cmake

步骤 2：使用 `--overlay-triplets` 覆盖默认三联密码

使用 --overlay-triplets 选项包含 custom-triplets 目录中的三联密码。

~/git$ vcpkg/vcpkg install sqlite3:x64-linux --overlay-triplets=custom-triplets
The following packages will be built and installed:
    sqlite3[core]:x64-linux
Starting package 1/1: sqlite3:x64-linux
Building package sqlite3[core]:x64-linux...
-- Loading triplet configuration from: /home/victor/git/custom-triplets/x64-linux.cmake
-- Downloading https://sqlite.org/2019/sqlite-amalgamation-3280000.zip...
-- Extracting source /home/victor/git/vcpkg/downloads/sqlite-amalgamation-3280000.zip
-- Applying patch fix-arm-uwp.patch
-- Using source at /home/victor/git/vcpkg/buildtrees/sqlite3/src/3280000-6a3ff7ce92
-- Configuring x64-linux-dbg
-- Configuring x64-linux-rel
-- Building x64-linux-dbg
-- Building x64-linux-rel
-- Performing post-build validation
-- Performing post-build validation done
Building package sqlite3[core]:x64-linux... done
Installing package sqlite3[core]:x64-linux...
Installing package sqlite3[core]:x64-linux... done
Elapsed time for package sqlite3:x64-linux: 44.82 s

Total elapsed time: 44.82 s

The package sqlite3:x64-linux provides CMake targets:

    find_package(unofficial-sqlite3 CONFIG REQUIRED)
    target_link_libraries(main PRIVATE unofficial::sqlite3::sqlite3)

默认三联密码被自定义三联密码过滤：

-- Loading triplet configuration from: /home/victor/git/custom-triplets/x64-linux.cmake

通过