VC-LTL 项目使用教程

1. 项目介绍

VC-LTL（Visual C++ Lightweight Template Library）是一个基于微软 Visual C++ 运行时（MS VCRT）的开源 CRT 库。它的主要目的是减少程序的二进制文件大小，并避免依赖微软的运行时 DLL，如 msvcr120.dll 等。VC-LTL 最初是为 Dism++ 项目开发的专用运行时，并于 2017 年 3 月 6 日从 Dism++ 源代码中分离并开源。

VC-LTL 通过动态链接到 Windows 内置的 msvcrt.dll 或 ucrtbase.dll 来减少二进制文件的大小。它解决了 C 运行时部署问题和纤程本地存储（FLS）限制问题，并显著减少了二进制文件的大小。VC-LTL 不仅适用于开源项目，也适用于商业用途，并且完全免费。

2. 项目快速启动

2.1 安装 VC-LTL

2.1.1 通过 NuGet 安装（推荐）

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

2.1.2 通过注册表安装

1. 下载并解压 VC-LTL 二进制文件到 D:\Src\VC-LTL。
2. 双击运行 D:\Src\VC-LTL\Install.cmd。
3. 将 VC-LTL helper for Visual Studio.props 复制到你的项目中。
4. 打开属性管理器（视图 - 属性管理器），右键点击 Release 配置，选择“添加现有属性表”，然后选择 VC-LTL helper for Visual Studio.props。

2.2 配置项目属性

1. 在项目属性中，选择 C/C++ - 代码生成 - 运行时库，调整为多线程 (/MT)。
2. 如果需要支持 Windows XP，请右键点击项目，选择属性 - NuGet 包设置 - VC-LTL - 目标 CRT 版本，选择“msvcrt 5.1.2600.0”。
3. 建议安装 YY-Thunks。

2.3 示例代码

以下是一个简单的 C++ 示例代码，展示了如何使用 VC-LTL 编译一个简单的控制台应用程序。

#include <iostream>

int main() {
    std::cout << "Hello, VC-LTL!" << std::endl;
    return 0;
}

3. 应用案例和最佳实践

3.1 应用案例

• Dism++: 初雨团队自身项目，使用 VC-LTL 有效减少程序体积，减少安装包大小。
• 360安全卫士: 360EvtMgr.exe、360leakfixer.exe、360Util.dll、leakrepair.dll 等文件使用 VC-LTL 编译，在 VC-LTL 的支持下：升级新编译器、减少文件尺寸、完美兼容 WinXP。

3.2 最佳实践

• 动态链接: 使用 VC-LTL 时，建议将运行时库设置为多线程 (/MT)，以减少对运行时 DLL 的依赖。
• 兼容性: 如果需要兼容 Windows XP，请确保在项目属性中正确设置目标 CRT 版本，并安装 YY-Thunks。
• 代码优化: 使用 VC-LTL 可以显著减少二进制文件的大小，因此在编写代码时，可以更多地关注性能优化和资源管理。

4. 典型生态项目

• NSudo: 一个强大的系统管理工具，在 VC-LTL 的帮助下减少了 30% 的程序体积，包括 NSudo for arm64。
• Menu98: 经典样式可自定义的开始按钮右键菜单，使用 VC-LTL 移除运行时依赖。
• 壁虎浏览器: 一款专业解决 DNS 劫持的浏览器，使用 VC-LTL 有效减少程序体积，减少安装包大小。
• librech551: 开源跨平台的 CH55x ISP 软件，使用 VC-LTL 移除运行时依赖。

通过这些生态项目，可以看到 VC-LTL 在实际应用中的广泛使用和显著效果。