Info, 更新CMake下使用nuget方式引用VC-LTL的帮助

Author: mingkuang-Chuyu

Readme.md

@@ -134,11 +134,52 @@ Copy `VC-LTL helper for Visual Studio.props` to your project, then open the Prop
 In addition, it is recommended that you install YY-Thunks.
 
 ### 3.2. Using VC-LTL in CMake
+#### 3.2.1. Reference via NuGet (recommend)
+##### 3.2.1.1. Create `Directory.Build.props` in source directory
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <ItemGroup Condition="'$(MSBuildProjectExtension)' == '.vcxproj'">
+    <ProjectCapability Include="PackageReferences" />
+  </ItemGroup>
+  <PropertyGroup Condition="'$(MSBuildProjectExtension)' == '.vcxproj'">
+    <NuGetTargetMoniker Condition="'$(NuGetTargetMoniker)' == ''">native,Version=v0.0</NuGetTargetMoniker>
+    <RuntimeIdentifiers Condition="'$(RuntimeIdentifiers)' == ''">win;win-x86;win-x64;win-arm;win-arm64</RuntimeIdentifiers>
+
+    <!--Turn on Windows XP support, and you can choose according to your situation.-->
+    <WindowsTargetPlatformMinVersion>5.1.2600</WindowsTargetPlatformMinVersion>
+  </PropertyGroup>
+  <ItemGroup Condition="'$(MSBuildProjectExtension)' == '.vcxproj'">
+    <PackageReference Include="VC-LTL">
+      <!--VC-LTL Version-->
+      <Version>5.1.1</Version>
+    </PackageReference>      
+  </ItemGroup>
+  <!--从兼容性考虑，继续向上搜索 Directory.Build.props-->
+  <PropertyGroup>
+    <DirectoryBuildPropsPath>$([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))</DirectoryBuildPropsPath>
+  </PropertyGroup>
+  <Import Project="$(DirectoryBuildPropsPath)" Condition="'$(DirectoryBuildPropsPath)' != ''"/>
+</Project>
+```
+##### 3.2.1.2. Start Build
+```
+# The Gen parameter must be use `Visual Studio`, as Visual Studio only supports nuget.
+# Assuming that the output dir is `.build\x86-Release`, you can modify it as needed.
+cmake -G "Visual Studio 17 2022" -A Win32 -DCMAKE_CONFIGURATION_TYPES:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=.\build\x86-Release .
+
+# Note the `-- -r` at the end, which is the command to restore the nuget package.
+cmake --build .\build\x86-Release --config Release -- -r
+
+cmake --install .\build\x86-Release --config Release
+```
+
+#### 3.2.2. Manual
 If you download and unzip [VC-LTL Binary](https://github.com/Chuyu-Team/VC-LTL5/releases/latest) to `D:\Src\VC-LTL`, please double-click `D:\Src\VC-LTL\Install.cmd`.
 
 > The script will save the information in the registry `HKCU\Code\VC-LTL`.
 
-#### 3.2.1. Add VC-LTL Module File
+#### 3.2.2.1. Add VC-LTL Module File
 
 Copy `VC-LTL helper for cmake.cmake` to your project. Then add `include("VC-LTL helper for cmake.cmake")` to `CMakeLists.txt`.
 
@@ -152,7 +193,7 @@ include("VC-LTL helper for cmake.cmake")
 add_subdirectory(src)
 ```
 
-#### 3.2.2. Modify The Configuration
+#### 3.2.2.2. Modify The Configuration
 
 > It's recommended to use `/MT` to compile the project when using VC-LTL.
 For XP support, please modify `VC-LTL helper for cmake.cmake` to enable `set(WindowsTargetPlatformMinVersion "5.1.2600.0")`.

Readme.osc.md

@@ -125,12 +125,52 @@ VC-LTL 5.0开始，ABI与微软原版`兼容`，您可以直接使用现有的
 > 建议使用`/MT`编译代码。如需支持XP，请右键项目 - 属性 - NuGet程序包设置 - VC-LTL - 目标CRT版本 －`msvcrt 5.1.2600.0`，除此之外建议您安装YY-Thunks。
 
 ### 3.2. 在CMake中使用VC-LTL
+#### 3.2.1. 通过NuGet引用（推荐）
+##### 3.2.1.1. 在代码根目录创建`Directory.Build.props`
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <ItemGroup Condition="'$(MSBuildProjectExtension)' == '.vcxproj'">
+    <ProjectCapability Include="PackageReferences" />
+  </ItemGroup>
+  <PropertyGroup Condition="'$(MSBuildProjectExtension)' == '.vcxproj'">
+    <NuGetTargetMoniker Condition="'$(NuGetTargetMoniker)' == ''">native,Version=v0.0</NuGetTargetMoniker>
+    <RuntimeIdentifiers Condition="'$(RuntimeIdentifiers)' == ''">win;win-x86;win-x64;win-arm;win-arm64</RuntimeIdentifiers>
+
+    <!--将项目最小支持到Windows XP，可根据自己的情况设置-->
+    <WindowsTargetPlatformMinVersion>5.1.2600</WindowsTargetPlatformMinVersion>
+  </PropertyGroup>
+  <ItemGroup Condition="'$(MSBuildProjectExtension)' == '.vcxproj'">
+    <PackageReference Include="VC-LTL">
+      <!--根据自己的情况选择VC-LTL版本-->
+      <Version>5.1.1</Version>
+    </PackageReference>      
+  </ItemGroup>
+  <!--从兼容性考虑，继续向上搜索 Directory.Build.props-->
+  <PropertyGroup>
+    <DirectoryBuildPropsPath>$([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))</DirectoryBuildPropsPath>
+  </PropertyGroup>
+  <Import Project="$(DirectoryBuildPropsPath)" Condition="'$(DirectoryBuildPropsPath)' != ''"/>
+</Project>
+```
+##### 3.2.1.2. 启动编译过程
+```
+# Gen必须选择Visual Studio系列，因为Visual Studio才支持nuget。
+# 假设输出目录为build\x86-Release，自己可根据情况修改。
+cmake -G "Visual Studio 17 2022" -A Win32 -DCMAKE_CONFIGURATION_TYPES:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=.\build\x86-Release .
+
+# 注意尾部的 `-- -r`，该命令是还原nuget包，此时会自动下载VC-LTL，并且配置到工程。
+cmake --build .\build\x86-Release --config Release -- -r
+
+cmake --install .\build\x86-Release --config Release
+```
 
+#### 3.2.2. 手工配置
 假如，你将[VC-LTL Binary](https://github.com/Chuyu-Team/VC-LTL5/releases/latest)下载并解压至`D:\Src\VC-LTL`（具体位置无任何要求），双击`D:\Src\VC-LTL\Install.cmd`即可。
 
 > 脚本会在`HKCU\Code\VC-LTL`创建注册表。
 
-#### 3.2.1. 添加VC-LTL配置文件
+#### 3.2.2.1. 添加VC-LTL配置文件
 
 将模块文件`VC-LTL helper for cmake.cmake`复制到你的工程目录（顶层CMakeLists.txt同级目录）。然后在`CMakeLists.txt`中添加一行 `include("VC-LTL helper for cmake.cmake")` 即可。
 
@@ -144,7 +184,7 @@ include("VC-LTL helper for cmake.cmake")
 add_subdirectory(src)
 ```
 
-#### 3.2.2. 调整配置工程
+#### 3.2.2.2. 调整配置工程
 
 > 建议使用`/MT`编译代码。如需支持XP，请修改`VC-LTL helper for cmake.cmake`启用 `set(WindowsTargetPlatformMinVersion "5.1.2600.0")`，除此之外建议您安装YY-Thunks。