VC-LTL——编译精巧的程序原来如此简单

• English

1. 关于VC-LTL

VC-LTL是一个基于微软VC修改的开源运行时，有效减少应用程序体积并摆脱微软运行时DLL，比如msvcr120.dll、api-ms-win-crt-time-l1-1-0.dll等依赖。

VC-LTL最初是Dism++专用运行时。2017年3月6号从Dism++源代码中分离，并正式对外开源，为社区贡献自己的微薄之力。

在大型项目中往往有众多模块，如果都采用静态编译那么造成的空间浪费先不说，最后也会因为Fls上限导致程序无法正常运行。

而VC-LTL能让你的项目如同系统文件一样共享系统内置msvcrt.dll，有效的解决Fls上限以及运行时部署问题，同时大大缩减程序体积，可以说一箭三雕！

所有人都可以无条件、免费使用，包括用于商业环境。当然如果大家在自己的程序说明文件中声明使用了VC-LTL那就更好了。

• GitHub：github.com/Chuyu-Team/VC-LTL（英文）
• 码云：gitee.com/Chuyu-Team/VC-LTL（中文）
• QQ群：633710173

1.1. 原理

使用VC-LTL后可以将程序动态链接到系统自带的msvcrt.dll中，来减少程序体积。目前使用CRT以及STL的工程一般都可以使用。但是MFC工程不能使用，因为MFC类库太复杂了，尚未适配。

使用VC-LTL，C++程序体积大约缩减30%，而纯C程序则大约缩减50%。

1.2. 亮点

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

让我们一起跟VS 2008说拜拜！

2. VC-LTL兼容性

此表展示了VC-LTL，C/C++库函数覆盖率，通过覆盖情况，可以大致了解VC-LTL的完善程度。

2.1. 支持的IDE

• Visual Studio 2015（包含Clang with Microsoft CodeGen、Clang 3.7 with Microsoft CodeGen、Clang-LLVM）
• Visual Studio 2017（包含Clang with Microsoft CodeGen）

2.2. 支持的编译工具

2.3. 支持的操作系统

采用VC-LTL编译后的程序能兼容Windows XP RTM以上所有操作系统，无需安装任何SP补丁包。

3. 使用方法

3.1. 安装VC-LTL

假如，你将VC-LTL Binary下载并解压至D:\Src\VC-LTL（具体位置无任何要求），双击D:\Src\VC-LTL\Install.cmd即可。

脚本会在HKCU\Code\VC-LTL创建注册表。

3.2. 在Visual Studio中使用VC-LTL

3.2.1. 添加VC-LTL属性表

将属性表VC-LTL helper for Visual Studio.props复制到你的工程目录，你可以打开属性管理器（视图 - 属性管理器），然后Release配置上右键添加现有属性表，然后选择VC-LTL helper for Visual Studio.props即可。

3.2.2. 配置工程属性

• C/C++ - 代码生成 -【运行库】调整为【多线程 (/MT)】

如需支持XP，请在平台工具集中选择Windows XP或者修改VC-LTL helper for Visual Studio.props启用 <SupportWinXP>true</SupportWinXP> 即可。

3.3. 在CMake中使用VC-LTL

3.3.1. 添加VC-LTL配置文件

将模块文件VC-LTL helper for cmake.cmake复制到你的工程目录（顶层CMakeLists.txt同级目录）。然后在CMakeLists.txt中添加一行 include("VC-LTL helper for cmake.cmake") 即可。

示例：

cmake_minimum_required(VERSION 3.5.2)
project(ltltest)

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

add_subdirectory(src)

3.3.2. 调整配置工程

务必确保使用/MT编译代码。如需支持XP，请修改VC-LTL helper for cmake.cmake启用 set(SupportWinXP "true") 即可。

3.4. 在NMake/纯CL中使用VC-LTL

3.4.1. 运行VC-LTL辅助脚本

将辅助脚本VC-LTL helper for nmake.cmd复制到你的工程目录。启动vcvars32.bat/vcvars64.bat执行此脚本即可，脚本将自动修改include以及lib环境变量。

示例：

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

3.4.2. 配置工程属性

务必确保使用/MT编译代码。如需支持XP，请修改VC-LTL helper for nmake.cmd启用 set SupportWinXP=true。

3.5. 重新编译（仅Release）

现在是不是体积就小了很多。如果你编译不通过，可以先参考 4. 常见问题。如果还是不通过可以反馈，共同改进VC-LTL。

如果正确引用VC-LTL，那么 会在生成时输出：note: 进入ltl普通模式，已准备引用到VC-LTL。定义 _DISABLE_DEPRECATE_LTL_MESSAGE 可关闭信息提示。。

使用VC-LTL编译时必须采用/MT编译，并且所有依赖的静态库也必须使用VC-LTL重新编译。

4. 常见问题

4.1. 未共享到msvcrt.dll

问题原因

未正确引用VC-LTL。建议看看生成日志，是否包含：note: 进入ltl普通模式，已准备引用到VC-LTL。定义 _DISABLE_DEPRECATE_LTL_MESSAGE 可关闭信息提示。。

解决方案

1：请务必确保 VC-LTL helper for Visual Studio.props 已经添加到工程。

2：确保以下设置正确：

• VC++ 目录 - 包含目录 - 【√ 从父项或项目默认设置继承(I)】
• VC++ 目录 - 库目录 - 【√ 从父项或项目默认设置继承(I)】

4.2. 无法解析外部符号 delete 等

问题原因

没有正确引入vc.lib、msvcrt_Platform.lib。

解决方案

• VC++ 目录 - 包含目录 - 【√ 从父项或项目默认设置继承(I)】
• VC++ 目录 - 库目录 - 【√ 从父项或项目默认设置继承(I)】

4.3. 检测到RuntimeLibrary的不匹配项

问题原因

引入了没有使用VC-LTL编译的静态lib文件。

解决方案

使用VC-LTL重新编译对应的静态lib（具体lib名称错误日志会给出）。

4.4. 支持XP时从msvcrt.dll导入大量XP不支持的函数

问题原因

可能没有开启引用消除

解决方案

• C/C++ - 语言 - 移除未引用的代码和数据 - 【是(/Zc:inline)】
• 连接器 - 优化 - 引用 - 【是(/OPT:REF)】

5. 已知问题

• 由于WinXP本身Bug，printf相关函数输入缓冲区最大字符数为0x3FFFFFFF（包含）。当你需要兼容XP时，请务必确认缓冲区输入长度小于0x3FFFFFFF，或者直接使用 _CRT_STDIO_SIZE_MAX 宏。_s 版本不存在此问题。
• 由于WinXP本身Bug，printf相关函数无法正常支持%ll。当你需要兼容XP时，请优先考虑使用%I64代替。_s 版本也存在此问题。
• 由于msvcrt本身限制，setlocale/_create_locale相关函数不支持UCRT的locale name，使用时必须按VC 2008规范使用，比如 setlocale(0, ".936"); 这样调用，而不是传入 setlocale(0, "zh-CN");。

附：已知使用VC-LTL的官方项目

更新日志

1.0.0.1 2016-05-23 13:42

• 解决C++异常无法使用问题。

1.0.0.2 2016-06-14 12:52

• 解决C编译不通过问题。

1.0.0.3 2016-11-28 12:54

• 改进对C工程的兼容性。

1.0.0.4 - 公众第一版（2017-03-06 16:15）

• 与Dism++彻底分离，方便以后与Dism++共享代码。

1.0.0.5 - 新增Visual Studio 2017支持（2017-03-16 20:53）

• 新增VC 2017支持。

1.0.0.6 - 优化引用方式（2017-03-18 13:46）

• 优化文件引用。

1.0.0.7 - 初步添加Windows XP支持（2017-04-22 19:26）

• 初步添加Windows XP支持。
• 添加C++异常支持。
• 添加/GS特性支持。
• 添加/guard:cf支持。
• VC140库升级到Vistual Studio 2015 Update3。

1.0.0.8 - 简化VC-LTL使用（2017-04-25 20:37）

• 简化库引用方式。
• 更新14393 ucrt到最新版（2017-01-05版）。
• 添加15063 ucrt支持。

1.0.0.9 - 添加C++异常支持（2017-05-26 14:46）

• 改进Windows XP支持。
• 优化库结构裁剪ltl库体积。
• 解决使用自定义异常导致程序编译不通过问题。
• 调整*_p系列函数定义，以免使用*_p系列函数时编译不通过。
• 解决使用浮点除法时导致编译不通过问题。

1.0.0.10 - 改进对Windows XP的支持（2017-07-28 20:28）

• 解决Bug 9，某些时候编译器引用异常导致XP模式时意外引入_except_handler4_common（感谢 HwangBae）。
• 解决Bug 8，修复typeid功能无法使用问题（感谢 HwangBae）。
• 调整异常实现代码，尽可能复用msvcrt.dll代码减少代码体积。
• 解决Bug，修复无法使用__argc、__argv、__wargv、_environ、_wenviron全局变量问题（感谢 亮叔叔）。
• 解决微软Bug，修复使用ATL库的程序不支持XP RTM问题。

1.0.0.11 - 解决lib依赖问题（2017-08-23 19:00）

• 解决Bug，使用_difftime64时Windows XP无法运行。
• 解决Bug，_msvcrt.cpp始终会引入urct_14393.lib问题（感谢 亮叔叔）。
• 更新VC141头文件以及实现，全部同步到最新14.11。

1.0.0.12 - 解决某些函数无法使用问题（2017-09-15 13:33）

• 解决Bug，使用strcat_s时在Windows XP中提示找不到指定符号（感谢 stsm85）。
• 解决Bug，解决SSE2除法导致编译不通过问题（感谢 stsm85）。
• 解决Bug，解决wcstoll、vsnprintf、rand_s、strtoll无法使用问题（感谢 stsm85）。
• 代码调整，消除所有VC-LTL编译警告，强迫症患者福音。

本次更新后，FastCopy、winpck相关程序直接可以使用VC-LTL编译。

1.0.0.13 - 新增 Windows 10 16299 UCRT支持（2017-10-11 14:00）

• 解决Bug，atanh、acosh、asinh无法使用问题（感谢 stsm85）。
• 新增Windows 10 16299 UCRT支持。
• 移除Windows 10 14393 UCRT支持。

16299已经发布，因此移除老版本14393支持。相关项目请迁徙到15063或者最新16299。

2.0.0.1 - 新增C++类库支持（2017-10-29 22:23）

• 新增iostream、stringstream支持。
• 解决使用_fstat32、_fstat32i64、_fstat64i32、_stat32、_stat32i64、_stat64i32、_wstat32、_wstat32i64、_wstat64i32导致编译不通过问题。
• 修正__acrt_iob_func始终返回输入流问题。
• 解决 type_info operator != 功能无法使用问题（感谢 sonyps5201314）。
• 解决_daylight，_dstbias，_timezone，_tzname无法使用问题（感谢 sonyps5201314）。
• 解决32位 SSE高精度数据函数无法使用问题，比如_libm_sse2_tan_precise，_libm_sse2_sqrt_precise，_libm_sse2_sin_precise（感谢 stsm85）。

2.0.0.2 - 扩充对C++类库的支持（2017-11-05 14:14）

• 新增 _configthreadlocale、_get_current_locale、_create_locale、_free_locale接口支持。
• 为Windows XP添加 _time32、_fseeki64静态实现。
• 解决Bug 14，新增 _getpid、_sys_nerr、_sys_errlist无法使用问题（感谢 HwangBae）。
• 新增C++类，mutex、thread、xtime、xonce支持。
• 优化编译方式，消除无意义符号，减少ltl库体积。

2.0.0.3 - 补充大量XP静态实现（2017-11-18 14:18）

• Vista编译模式，CRT函数覆盖率达到90%以上。
• XP编译模式，CRT函数覆盖率达到80%以上。
• 简化注册表引用方式。
• 添加std::thread支持。

2.0.0.4 - 全面覆盖STL、ConcRT（2017-12-03 20:40）

• 全面覆盖STL、ConcRT库，让C++如鱼得水，尽情使用STL。
• 全新的weak别名转发技术，实现零jmp解决新老CRT命名冲突。

2.0.0.5 - 增强C++ 17支持（2017-12-10 20:56）

• 新增C++ 17 align new/delete支持。
• 解决兼容WinXP时可能出现的ntdll.lib依赖失败以及某些函数转发切换到weak别名技术。

本次更新主要添加对Vistual Studio 2017 15.5以及更高版本新增的C++ 17功能支持。

2.0.0.6 - 2018新春贺岁版（2018-01-17 17:15）

• 添加Vistual Studio 2017 15.5新增函数支持。
• 新增Shared.props改进属性表引用灵活性。
• 新增VC-LTL轻量模式以及高级模式支持（修改Shared.props可以调整模式）。
• 继续扩充CRT函数支持。

2.0.0.7 - 重新规范VC-LTL（2018-03-06 17:17）

• 重新整理VC-LTL，尽可能减少对原版改动。
• 解决一些Bug（感谢 亮亮、layerfsd、waiting4love）。

2.0.0.8 - 累计BUG修复以及适配新版本（2018-03-23 14:58）

• 解决一些潜在找不到符号问题以及链接失败问题（感谢 Too Simple）。
• 修正__crtLCMapString相关字符串操作兼容性问题（感谢 Too Simple）。
• 解决_getptd_noexit在获取msvcrt.dl的DllMain中创建的 ptd结构时会返回失败问题（感谢 亮亮）。
• 添加最新Vistual Studio 2017 15.6支持。

3.0.0.1 - 改进平台支持（2018-04-26 18:48）

• 解决Bug 27，非中文环境调用_set_abort_behavior输出警告问题（感谢 myfreeer）。
• 解决Bug 21，特定情况nothrow符号冲突问题（感谢 waiting4love）。
• 解决Bug，解决x64系统无法使用__p__*系列函数问题（感谢 昌平）。
• 改进体验，当RC中意外引入_msvcrt.h时 自动跳过处理，避免RC报错（感谢 风清凉）。
• 改进体验，“Shared.props”改名为“VC-LTL helper for Visual Studio.props”并大幅度增强对某些极端工程的支持。
• 新增Fea 25，添加“VC-LTL helper for nmake.cmd”，方便nmake引入VC-LTL。
• 新增Fea，添加“VC-LTL helper for cmake.cmake”，方便cmake引入VC-LTL（感谢 Sandro）。
• 新增Fea，全面支持ARM、ARM64支持。

3.0.0.2 - 添加Vistual Studio 2017 15.7支持（2018-05-18 21:07）

• 新增Fea，添加VC 14.0.24234以及14.14.26428支持。
• 新增Fea，添加UCRT 10.0.17134.0支持。
• 新增Fea，添加Spectre缓解库支持。
• 解决Bug，找不到gets符号问题（感谢 npc）。

VC-LTL本次从仓库中剔除了lib文件，VC-LTL用户请下载VC-LTL Binary，然后再使用VC-LTL编译代码。

3.0.0.3 - 儿童节专版（2018-05-31 17:07）

• 解决Bug 32，链接时找不到符号__p__fmode（感谢 augustheart）。
• 更新许可。

3.1.0.1 - 添加Clang支持（2018-06-18 13:13）

• 新增Fea 34，添加Clang with Microsoft CodeGen、Clang 3.7 with Microsoft CodeGen、Clang-LLVM工具集支持（感谢 hzqst）。
• 解决Bug，非中文代码页corecrt.h报告 C4828警告（感谢 临渊羡鱼乎）。
• 解决Bug 35，调用vsnprintf时触发警告C4389: “==”: 有符号/无符号不匹配（感谢 zhaooptimus）
• 解决Bug，减少amd64程序调用_hypotf函数时的二进制体积。
• 解决Bug，解决VS15.7 special_math无法使用问题

4.0.0.2 - 添加VC-LTL动态库支持（2018-08-14 12:30）

全新的VC-LTL 4.0，代号——“破晓”，作为大版本升级某些行为已经更改：

1. VC-LTL 4.0 开始，如需静态编译（仅依赖msvcrt.dll）请使用/MT编译。
2. VC-LTL 4.0 不兼容VC-LTL 3.X编译的静态库，你需要使用VC-LTL 4.0（破晓）重新编译。

• 新增Fea，添加VC-LTL动态库支持，使用/MD编译即可链接到 ucrtbase_ltl.dll 等DLL。
• 新增Fea，彻底抛弃DDK，重构CRT库，全面支持指针混淆、quick_exit、__stdio_common等功能。
• 新增Fea，添加ARM、ARM64链接到msvcrt.dll支持。
• 新增Fea，添加WinRT（CX）支持（仅限于Windows 8.1以及更高版本支持）。
• 改进体验，XP模式时无需手动指定所需的最低版本。
• 改进体验，充分利用msvcp60.dll缩小程序体积。

4.0.0.8 Preview - 添加Vistual Studio 2017 15.8支持（2018-08-21 18:00）

• 解决Bug，修正4.0.0.3中14.15.26726 ARM脚本错误问题（感谢 毛利）。
• 解决Bug，解决CMake脚本语法错误（感谢 MaMy丶）。
• 解决Bug，解决CMake脚本文件路径判断方式不正确问题。
• 解决Bug，解决CMkae、NMake脚本lib路径错误问题（感谢 Too Simple、MaMy丶）。
• 解决Bug，修正4.0.0.6中CMake脚本 UCRT条件判断多写了个NOT。
• 解决Bug，修正MD模式报告找不到_libm_sse2_tan_precise相关符号问题（感谢 13732650）。
• 新增Fea，添加Vistual Studio 2017 15.8支持。
• 新增Fea，添加lib文件检测，如果不存在则报错。