VC-LTL - 编译更轻量级二进制文件的优雅方式。

• 简体中文

我想变成一座石桥，历经五百年风雨，五百年阳光，五百年雨露，但她却走过了这座桥！

1. 关于 VC-LTL

VC-LTL 是一个基于 MS VCRT 的开源 CRT 库，它可以减小程序二进制大小，并告别 Microsoft 运行时 DLL，如 msvcr120.dll、api-ms-win-crt-time-l1-1-0.dll 等依赖项。

VC-LTL 最初是 Dism++ 运行时的专用库，于 2017 年 3 月 6 日从 Dism++ 源代码中独立出来并开源。

大型项目中有很多模块。如果所有二进制文件都使用静态编译，将会占用大量磁盘空间，最终可能会因为纤维局部存储 (FLS) 限制而崩溃。

但 VC-LTL 可以让您的项目使用 Windows 内置的 msvcrt.dll。它有效地解决了 C 运行时部署问题和纤维局部存储 (FLS) 限制问题，并大大减小了二进制文件大小。真是一个实用的库！

任何人都可以免费使用它，甚至可以用于商业用途。当然，我希望如果您在项目中提到了 VC-LTL，因为我希望帮助更多的人。

• QQ 群：633710173

1.1. VC-LTL 的原理

使用 VC-LTL 后，二进制文件将动态链接到 Windows 内置的 msvcrt.dll 或 ucrtbase.dll，以减小二进制文件大小。如果您在项目中使用 C 运行时、STL 或 MFC，则通常可以使用 VC-LTL。

在使用VC-LTL后，如果从C++源代码编译，二进制文件的大小将减少约30%，如果从纯C源代码编译，则减少约50%。

1.2. 突出

• 晚起的鸟儿也有虫虫吃，优雅的引用方式，仅添加一个属性表就能享受极致的体积体验。
• 无缝使用最新C/C++库以及最新编译器，尽情的使用最新规范。神马异常流防护（guard:cf）、静态对象线程安全初始化（threadSafeInit）……统统放马过来吧！！
• 拥有比微软原版更好的兼容性，即使想兼容Windows XP RTM也可以安心的对新编译器说“Yes”。
• 完全的开放代码，广泛的接受用户意见，希望大家能踊跃的 pull requests，为VC-LTL添砖加瓦。

让我们告别Visual Studio 2008。

2. VC-LTL兼容性

2.1. ABI兼容性

从VC-LTL 5.0开始，ABI与微软兼容。你可以使用静态库与VC-LTL链接，无需重新编译！

此外，为了提供行为的一致性，还提供了一个调试版本的库。它仍将使用msvcrt.dll或ucrtbase.dll，但不支持堆调试功能。如果您需要使用堆调试，请禁用VC-LTL。

2.2. 支持的Visual Studio版本

• Visual Studio 2015（支持Clang与Microsoft CodeGen，Clang 3.7与Microsoft CodeGen，Clang-LLVM）
• Visual Studio 2017（支持Clang与Microsoft CodeGen，Clang-LLVM）
• Visual Studio 2019（支持Clang-LLVM）
• Visual Studio 2022

2.3. 支持的构建工具

2.4. 支持的Windows版本

提示：如果您需要编译Windows XP兼容的应用程序（5.1.2600.0/5.2.3790.0），请别忘了使用YY-Thunks。

使用VC-LTL编译的二进制文件与Windows XP和更高版本兼容，即使在未安装任何热修复的环境中也是如此。

3. 如何使用？

我们将进入主题，我们为您的参考准备了丰富的VC-LTL示例，并欢迎您加入我们的QQ群（633710173）。

3.1. 在Visual Studio中使用VC-LTL

3.1.1. 选择引用模式

3.1.1.1. 通过NuGet引用（推荐）

右键单击项目，选择“管理NuGet包”，然后搜索VC-LTL，选择适合您的版本，然后单击安装。

3.1.1.2. 通过注册表引用

如果您已将VC-LTL二进制文件解压缩到D:\Src\VC-LTL，请双击D:\Src\VC-LTL\Install.cmd。

脚本将信息保存到注册表中：HKCU\Code\VC-LTL。

cmake_minimum_required(VERSION 3.5.2)
project(ltltest)

include("VC-LTL helper for cmake.cmake")

add_subdirectory(src)

call "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvars32.bat"
call "D:\VC-LTL\VC-LTL helper for nmake.cmd"

nmake /f Test.mak

$BuiltInVsWhereExe = "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe"
$LatestVisualStudioRoot = & $BuiltInVsWhereExe -latest -prerelease -property installationPath

# x86、amd64、arm、arm64
& "$LatestVisualStudioRoot\Common7\Tools\Launch-VsDevShell.ps1" -arch x86
& D:\VC-LTL\VC-LTL helper for nmake.ps1"

& nmake /f Test.mak