Skip to content

Latest commit

 

History

History
214 lines (142 loc) · 12 KB

Readme.osc.md

File metadata and controls

214 lines (142 loc) · 12 KB

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

license downloads contributors release nuget crates.io Build&Test

Logo
我愿化成一座做石桥,经受五百年的风吹,五百年的日晒,五百年的雨打,只求她从桥上走过!

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或者ucrtbase.dll,有效的解决Fls上限以及运行时部署问题,同时大大缩减程序体积,可以说一箭三雕!

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

1.1. 原理

使用VC-LTL后可以将程序动态链接到系统自带的msvcrt.dll或者ucrtbase.dll中,来减少程序体积。目前使用CRT、STL以及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的完善程度。

模块 5.1.2600.0/5.2.3790.0 6.0.6000.0 6.2.9200.0 10.0.10240.0 相关文件
依赖 msvcrt.dll msvcrt.dll msvcrt.dll ucrtbase.dll
VCRT 100% 100% 100% 100% vcruntime[d].lib、libvcruntime[d].lib
UCRT 97.458% 97.676% 97.676% 100% libucrt[d].lib、ucrt[d].lib
WinRT X X 99.609% 100% vccorlib.lib(仅支持Windows 8.1以及更高版本)
STL 100% 100% 100% 100% Visual Studio自身提供。
ConcRT 100% 100% 100% 100% Visual Studio自身提供。
ATL 100% 100% 100% 100% Visual Studio自身提供。
MFC 100% 100% 100% 100% Visual Studio自身提供。
AMP X X X 100% Visual Studio自身提供,需要带上vcamp140.dll
OpenMP 100% 100% 100% 100% Visual Studio自身提供,需要带上vcomp140.dll

2.1. ABI兼容性

VC-LTL 5.0开始,ABI与微软原版兼容,您可以直接使用现有的静态库与VC-LTL进行链接,无需重新编译!

除此之外,为了提供行为的一致性还提供了Debug版库,它依然会使用msvcrt.dll或者ucrtbase.dll,但是它不支持堆调试功能,如果您需要在Debug使用堆调试功能请临时禁用VC-LTL。

2.2. 支持的Visual Studio版本

  • Visual Studio 2015(包含Clang with Microsoft CodeGen、Clang 3.7 with Microsoft CodeGen、Clang-LLVM)
  • Visual Studio 2017(包含Clang with Microsoft CodeGen、Clang-LLVM)
  • Visual Studio 2019(包含Clang-LLVM)
  • Visual Studio 2022

2.3. 支持的编译工具

编译工具 支持文件
Visual Studio NuGet 或者 VC-LTL helper for Visual Studio.props
CMake VC-LTL helper for cmake.cmake
NMake、CL VC-LTL helper for nmake.cmd/VC-LTL helper for nmake.ps1
QMake VC-LTL helper for qmake.pri
Rust crate

2.4. 支持的操作系统

操作系统 x86 x64 arm arm64
Windows XP、Windows Server 2003 - -
Windows Vista、Windows Server 2008 - -
Windows 7、Windows Server 2008 R2 - -
Windows 8、Windows Server 2012、Windows RT -
Windows 8.1、Windows Server 2012 R2、Windows RT 8.1 -
Windows 10、Windows Server 2016、Windows Server 2019
Windows 11

温馨提示:如果您需要编译Windows XP兼容的程序(5.1.2600.0/5.2.3790.0),那么您还需要使用YY-Thunks库。

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

3. 使用方法

下面我们将进入主题,我们给大家准备了丰富的VC-LTL示例供大家参考,也欢迎加入我们的QQ群(633710173)。

3.1. 在Visual Studio中使用VC-LTL

3.1.1. 引用VC-LTL

3.1.1.1. 通过NuGet引用(推荐)

在 项目右键,选择“管理 NuGet 程序包”,然后搜索 VC-LTL 并选择适合您的版本,最后点击安装即可。

InstallByNuGet

3.1.1.2. 通过注册表引用

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

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

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

AddShared

3.1.2. 配置工程属性

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

ConfigurationProject

建议使用/MT编译代码。如需支持XP,请右键项目 - 属性 - NuGet程序包设置 - VC-LTL - 目标CRT版本 -msvcrt 5.1.2600.0,除此之外建议您安装YY-Thunks。

3.2. 在CMake中使用VC-LTL

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

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

3.2.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.2.2. 调整配置工程

建议使用/MT编译代码。如需支持XP,请修改VC-LTL helper for cmake.cmake启用 set(WindowsTargetPlatformMinVersion "5.1.2600.0"),除此之外建议您安装YY-Thunks。

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

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

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

3.3.1. 运行VC-LTL辅助脚本

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

CMD 示例:

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

powershell 示例:

$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

3.3.2. 配置工程属性

建议使用/MT编译代码。如需支持XP,请修改VC-LTL helper for nmake.cmd启用 set WindowsTargetPlatformMinVersion=5.1.2600.0,除此之外建议您安装YY-Thunks。

3.4. 重新编译

现在会引用msvcrt.dll或者ucrtbase.dll,体积小了很多。如果你编译不通过,可以先参考 4. 常见问题。如果还是不通过可以反馈,共同改进VC-LTL。

使用VC-LTL 5.0编译时推荐采用/MT编译,依赖的静态库不需要重新编译。

AppBuildByVC-LTL

4. 常见问题

4.1. 未共享到msvcrt.dll/ucrtbase.dll

问题原因

未正确引用VC-LTL。建议看看链接日志,是否链接了VC-LTL的lib。

解决方案

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

2:确保以下设置正确:

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

5. 已知问题

  • Bug 22, VC-LTL的Debug模式不支持堆调试功能也无法使用ASAN
    • 如果您需要使用这些功能,可以针对Debug配置关闭VC-LTL。
  • Bug 60, msvcrt模式下locale相关函数(如setlocale、std::locale)无法指定为区域为 .utf8
    • 如果需求如此必须使用,建议使用VC-LTL的UCRT模式(使用后将依赖ucrtbase.dll),如果不想依赖DLL就直接静态链接微软原版CRT吧。

附:第三方依赖项许可