# VC-LTL
**Repository Path**: AbstractFactory/VC-LTL
## Basic Information
- **Project Name**: VC-LTL
- **Description**: 一个修改版的C/C++标准库，将应用程序链接到微软自带的msvcrt.dll，有效减少C/C++应用程序体积。
- **Primary Language**: Unknown
- **License**: EPL-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-03-14
- **Last Updated**: 2024-06-14
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# VC LTL——编译精巧的程序原来如此简单
VC LTL 是一个开源的第三方修改VC库，大家都可以免费，无条件，甚至是用于商业环境。本库基于VC140/141修改，所以也同样适用Common Public License协议。
但我也希望如果你可以在程序的说明文件中声明下，使用了此库，来使更多人受益。
——mingkuang
## 原理：
使用 VC LTL后可以将程序动态链接到系统自带的msvcrt.dll中，来减少程序体积。一般来说一些C/C++的Win32应用程序都可以使用。但是MFC工程不能使用，因为MFC类库太复杂了。
## 亮点
* 无缝使用最新C/C++库以及最新编译器，无需使用陈旧的类库或者编译器，尽情的使用最新规范！
* 晚起的鸟儿也有虫虫吃，优雅的引用方式，仅添加一个属性表就能享受极致的体积体验。
* 支持编译器最新特性，异常流防护（guard:cf）、静态对象线程安全初始化（threadSafeInit）……统统放马过来吧~
* 完善的C++基础类库支持，比如vector、set、iostream、stringstream、cin、cout……（目前刚刚支持，如果存在编译不通过的情况，还请帮忙纠正或者提交BUG）
## 支持平台
### 支持的IDE
* Vistual Studio 2015
* Vistual Studio 2017
### 支持的目标平台（UCRT版本）
* Windows XP平台工具集（Windows 7.0 SDK & Windows 10 10240 UCRT）
* Windows 10 10240目标平台
* Windows 10 15063目标平台（强烈建议使用16299，下个Windows SDK发布时将删除对15063的支持！）
* Windows 10 16299目标平台（推荐使用）
> 目标平台并不影响你的程序兼容老版本Windows（比如Windows XP），一般我们都推荐大家使用高版本目标平台。
### 支持的操作系统
* Windows XP, Windows XP 64, Windows 2003（平台工具集需要调整为 Windows XP平台工具集）
* Windows Vista, Windows 2008
* Windows 7, Windows 2008 R2
* Windows 8, Windows 2012
* Windows 8.1, Windows 2012 R2
* Windows 10, Windows 2016
> 由此所见，采用VC-LTL编译后的程序能兼容Windows XP以上所有操作系统。
## 使用方法：
### 1. 将内容解压到工程目录VC-LTL
比如你的Sln文件在 D:\MySln\MySln.sln，这时你把VC-LTL整个目录复制到D:\MySln\VC-LTL即可。
### 2. 重定向C/C++库到VC LTL
我将相关库引用设置封装在了`VC-LTL\ltlvcrt.props`，你可以打开属性管理器（视图 - 属性管理器），然后Release配置上右键`添加现有属性表`，然后选择`VC-LTL\ltlvcrt.props`即可。
PS：如果需要支持XP，那么请选择`VC-LTL\ltlvcrtWinXp.props`。
如果你不希望使用ltlvcrt.props/ltlvcrtWinXp.props属性表，那么可以手动在Release配置中添加以下设置（2.1 ~ 2.6）
#### 2.1 C/C++ - 附加包含目录（AdditionalIncludeDirectories）的最上方添加以下内容：
* $(SolutionDir)VC-LTL\VC\\$(PlatformToolsetVersion)\include
* $(SolutionDir)VC-LTL\VC\\$(PlatformToolsetVersion)\atlmfc\include
* $(SolutionDir)VC-LTL\ucrt\\$(TargetUniversalCRTVersion)
#### 2.2 链接器 - 附加库目录（AdditionalLibraryDirectories）增加：
* $(SolutionDir)VC-LTL\\$(PlatformShortName)
* $(SolutionDir)VC-LTL\VC\\$(PlatformToolsetVersion)\lib\\$(PlatformShortName)
* $(SolutionDir)VC-LTL\ucrt\\$(TargetUniversalCRTVersion)\lib\\$(PlatformShortName)
#### 2.3 在 C/C++ - 预处理器 增加：
（仅在需要支持XP时才需要做，不需要支持XP直接无视此步骤！）
_ATL_XP_TARGETING
#### 2.4 在 C/C++ - 命令行 增加：
（仅在需要支持XP时才需要做，不需要支持XP直接无视此步骤！）
`/Zc:threadSafeInit-` 禁用线程安全静态初始化，这是编译器本身的BUG，否则Windows XP在全局变量中使用静态变量会导致程序崩溃。
#### 2.5 在链接器 - 输入 - 附加依赖项 增加：
（仅在需要支持XP时才需要做，不需要支持XP直接无视此步骤！）
msvcrt_winxp.obj（WinXP 32）/msvcrt_win2003.obj（WinXP 64）
#### 2.6 在链接器 - 系统 - 所需的最低版本 增加：
（仅在需要支持XP时才需要做，不需要支持XP直接无视此步骤！）
5.01
### 3. 在工程属性（Release配置） C++ - 所有选项：
* 【运行库】调整为 【多线程DLL/MD】
* 【目标平台】调整为【Windows 10 10240/15063/16299（推荐）】（从中选择任意SDK版本，但是尽量不要选择15063，因为在不久会删除15063 SDK 支持）
### 4. 重新编译你的应用程序（Release）
现在是不是体积就小了很多。如果你编译不通过，咋们可以一起研究研究，共同改进VC LTL。
### 5. 文件说明
* ltl1.lib VC2015/VC2017 编译平台使用到的扩展函数，其内容通过编译_msvcrt.cpp以及src文件夹得到
* ltl1xp.lib VC2015/VC2017 XP模式 编译平台使用到的扩展函数，其内容通过编译_msvcrt.cpp以及src文件夹得到
* msvcrt_base.lib Vista msvcrt.dll删除过的导出符号表（从原版中删除了一些无用符号，并且加入了msvcrt.def导出函数）
* msvcrt_vista.lib Vista msvcrt.dll 原版符号表（从DDK提取，仅作备份用途，无实际用途）
* ucrt.lib 从libucrt.lib提取的一些原有lib不支持的函数集合。
* vc.lib 从对应的VC版本编译器msvcrt.lib提取的一些原有lib不支持的函数集合。
* ltlcprt.lib VC2015/VC2017 编译平台使用到的C++支持函数，其内容通过编译src文件夹得到
* ltlcprtxp.lib VC2015/VC2017 XP模式 编译平台使用到的C++支持函数，其内容通过编译src文件夹得到
### 6. VC-LTL兼容性
#### 6.1 已知问题规避
* 由于WinXP本身BUG，printf相关函数输入缓冲区最大字符数为0x3FFFFFFF（包含）。当你需要兼容XP时，请务必确认缓冲区输入长度小于0x3FFFFFFF，或者直接使用 _CRT_STDIO_SIZE_MAX 宏。
* 由于WinXP本身BUG，vsprintf相关函数无法正常支持`%xll`。当你需要兼容XP时，请优先考虑使用`%I64x`代替。vsprintf_s相关版本不存在此问题。
#### 6.2 已知与VC-LTL兼容的项目
此列表只是表示已经有开发者使用VC-LTL编译并使用，并不代表VC-LTL仅能兼容一下项目。
* [duilib](https://github.com/duilib/duilib)
* [FastCopy](https://ipmsg.org/tools/fastcopy.html.en)
* [WinPCK](http://www.winpak.com/en/home/)
* [RapidXml](http://rapidxml.sourceforge.net/)
* [JsonCPP](https://github.com/open-source-parsers/jsoncpp)
* [icu](http://source.icu-project.org/repos/icu/trunk) `99%兼容，暂时需要定义U_USE_STRTOD_L宏才能编译通过`
* [SQLite](http://www.sqlite.org/download.html)
* [LuaJIT](http://luajit.org/)
> 其他更多等你来反馈
## Changes：
2.0.0.1 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）
1.0.0.13 2017-10-11 14:00
* 解决BUG，atanh、acosh、asinh无法使用问题（感谢 stsm85）
* 新增Windows 10 16299 UCRT支持
* 移除Windows 10 14393 UCRT支持
PS：16299已经发布，因此移除老版本14393支持。相关项目请迁徙到15063或者最新16299。
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编译警告，强迫症患者福音。
PS:本次更新后，FastCopy、winpck相关程序直接可以使用VC-LTL编译。
1.0.0.11 2017-08-23 19:00
* 解决BUG，使用_difftime64时Windows XP无法运行。
* 解决BUG，_msvcrt.cpp始终会引入urct_14393.lib问题（感谢 亮叔叔）
* 更新VC141头文件以及实现，全部同步到最新14.11
1.0.0.10 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.9 2017-05-26 14:46
* 改进Windows XP支持
* 优化库结构裁剪ltl库体积
* 解决使用自定义异常导致程序编译不通过问题
* 调整*_p系列函数定义，以免使用*_p系列函数时编译不通过
* 解决使用浮点除法时导致编译不通过问题
1.0.0.8 2017-04-25 20:37
* 简化库引用方式
* 更新14393 ucrt到最新版（2017-01-05版）
* 添加15063 ucrt支持
1.0.0.7 2017-04-22 19:26
* 初步添加Windows XP支持
* 添加C++异常支持
* 添加/GS特性支持
* 添加/guard:cf支持
* VC140库升级到Vistual Studio 2015 Update3
1.0.0.6 2017-3-18 13:46
* 优化文件引用
1.0.0.5 2017-3-16 20:53
* 新增VC 2017支持
1.0.0.3 2016-11-28 12:54
* 改进对C工程的兼容性
1.0.0.2 2016-06-14 12:52
* 解决C编译不通过问题
1.0.0.1 13:42 2016/5/23
* 解决C++异常无法使用问题