Release notes from hMSBuild

2.5

2025-10-25T00:41:24Z

🧱 gnt~hMSBuild | gnt*hMSBuild | Self updating: hMSBuild -GetNuTool ~hMSBuild/2.5

📑 What's new in 2.5 ...

FIXED: Possible infinite self-call recursion due to built-in GetNuTool 1.9+ and hMSBuild invoking itself.
Affected all versions with built-in GetNuTool 1.9 (hMSBuild 2.4 and 2.4.1)
FIXED: Calling built-in GetNuTool using keys with empty ""
e.g. proxycfg="" etc.
NEW: Improved security via env protected properties (GetNuTool 1.10+) when using remote vswhere.
(without a key -no-vswhere)
More about: https://github.com/3F/GetNuTool?tab=readme-ov-file#tmodes-and-commands
Or command: hMSBuild -GetNuTool ~/p:use=documentation
NEW: hMSBuild.bat edition now fully supports LF and uses this by default instead of CRLF.
LF/CRLF of course affects the checksums, hMSBuild -GetNuTool +hMSBuild/2.5
* LF (actual): hMSBuild.bat.sha1
* CRLF (possible): hMSBuild.bat.crlf.sha1
It means .gitattributes control for CRLF in hMSBuild.bat is not necessary anymore in cases when core.autocrlf=input etc.
See related: #2
However, this will not affect users who used the full edition hMSBuild.full.bat
(related #11) which is still not protected due to incorrect shiftings in cmd processor when switching to LF.
NEW: Full hMSBuild edition access:

gnt ~hMSBuild /p:use=full

hMSBuild -GetNuTool ~hMSBuild /p:use=full

NEW: API. +:eva {in:unevaluated} {out:evaluated} {in:option}

:: evaluate argument
:eva {in:unevaluated} {out:evaluated} {in:option}
    ::  &(1) - Input via a variable. Use ` to apply " quotes inside "..." if [3]==1.
    :: *&(2) - Evaluated output via a variable.
    ::   [3] - Option to enable support for extra quotes. Values: 1 == ` as "
    :: !!0

NEW: API. +:inita {in:vname} {in:arguments} {out:index}

:: initialize arguments
:inita {in:vname} {in:arguments} {out:index}
    ::   (1) - Input variable name.
    ::  &(2) - Input arguments via a variable.
    :: *&(3) - Returns the reached index (maximum) via a variable.
    :: !!0

NEW: +.pkg.install.bat v1 support in hMSBuild nuget packages.

gnt ~hMSBuild

gnt *hMSBuild/2.5

Syntax and relevant documentation:
* hMSBuild -GetNuTool -help
* hMSBuild -GetNuTool ~/p:use=documentation
Or visit https://github.com/3F/GetNuTool

NEW: Self updating support: hMSBuild -GetNuTool ~hMSBuild/2.5
NEW: Added validate.hMSBuild.bat helper to validate core itself.
NEW: Added srv.create.bat to prepare local server access.
NEW: Official nuget package, hMSBuild:
https://www.nuget.org/packages/hMSBuild/
CHANGED: Default remote vswhere is 3.1.7
CHANGED: Updated built-in GetNuTool 1.10.
Anniversary (10 years) update GetNuTool 1.10 //github.com/3F
adds new modes (install, run, touch, get, grab, pack); custom scripts;
improves security; and became even more compact for .bat edition (now 7.87 KB); and ...
https://github.com/3F/GetNuTool/releases/tag/1.10
NOTE: Self validation via command:

hMSBuild -GetNuTool ~& svc.gnt -sha1-cmp hMSBuild.bat sha1 -package-as-path

2.4.1

2024-02-12T21:09:27Z

hMSBuild 2.4.1 🩹 ESCT/L/E hotfixes

FIXED: Key handling when = sign;
Errors like: ..."" was unexpected at this time.

2.4

2024-02-08T18:58:22Z

hMSBuild 2.4 - .bat scripts with full Package Manager inside for searching and wrapping MSBuild tools

📑 What's new in 2.4 ...

FIXED: -GetNuTool is corrupted.
FIXED: Fixed delayed return code as !ERRORLEVEL! when -GetNuTool key.
NEW: -no-less-4 key to not include versions less than 4.0 (Windows XP+)
NEW: -no-less-15 key to not include versions less than 15.0 (install-API/2017+)
NEW: ~c {name} Alias to p:Configuration={name}
NEW: ~p {name} Alias to p:Platform={name}
NEW: ~x Alias to m:NUMBER_OF_PROCESSORS-1 v:m
NEW: -vc key. Adds to -priority VC++ toolset.
NEW: -cs key. Adds to -priority C# / VB Roslyn compilers.
CHANGED: Redirected warn messages into stderr stream.
CHANGED: -vsw-priority renamed as -priority.
The old key still is available for backward compatibility with 2.x;
But marked as obsolete and not recommended to use anymore.
CHANGED: -vsw-version renamed as -vwshere.
The old key still is available for backward compatibility with 2.x;
But marked as obsolete and not recommended to use anymore.
CHANGED: Updated GetNuTool 1.9 embeddable package manager inside .bat
https://github.com/3F/GetNuTool/releases/tag/1.9
NOTE: hMSBuild releases are now accompanied by a .sha1 file in the official distribution;
At the same time, commits from which releases are published are signed with the committer's verified signature (GPG).
```
  Make sure you are using official, unmodified, safe versions.
  https://github.com/3F/hMSBuild/releases/latest
```

v2.3

2020-01-29T14:36:24Z

Public release of the hMSBuild 2.3

* NEW: Implemented `-vsw-as "args..."`
Reassigns default commands to vswhere if used.

For example:
```
hMSBuild -only-path -vsw-as "-products Microsoft.VisualStudio.Product.BuildTools"
```
Related Issues: #12, #14, #8,

* CHANGED: VS2017+. Using the most modern instance by default.
You can also specify `-vsw-priority` and `-force` keys to use only what is needed.
Related Issues: #14, #8.

* CHANGED: Updated wswhere to 2.8.4 by default.

* CHANGED: Updated GetNuTool 1.8
https://github.com/3F/GetNuTool/releases/tag/1.8

Most important fix for hMSBuild:
"The remote server returned an error: (407) Proxy Authentication Required."
Related issue: 3F/DllExport#133

* NOTE: An compiled.full version now will be distributed together with official hMSBuild releases.
https://twitter.com/GitHub3F/status/1218224792970715136
(zip packages) https://github.com/3F/hMSBuild/releases

v2.2

2019-07-20T16:39:17Z

Public release of the hMSBuild 2.2

* FIXED: Fixed searching from MS BuildTools products. Issue #12 (Thanks @odalet).

* CHANGED: [VS2017+] hMSBuild will search now in ANY available products. PR #13 (Thanks @odalet).

* NOTE: In addition to changes above, please use `-vsw-priority` and `-force` keys to use only what is needed.
Issues: #8, #14.

CI-build-41

2019-07-19T18:56:56Z

🎲 Nightly build of c195efd ➾ Worker image: Visual Studio 2015; Console: ci.appveyor.com/.../build-41

❕ Only for tests ❕ 🗨 Commit message:

Merge pull request #13 from odalet/master

Issue #12 / -products *

v2.1

2019-05-27T17:12:43Z

Public release of the hMSBuild 2.1

* NEW: Support for VS2019 msbuild (Thanks @gerhardol)

* CHANGED: Removed possible last extra slash `\` from path, ie. ~ `..\Bin\\MSBuild.exe`
When x32 for searching from Visual Studio with `-notamd64` key.
Part of PR #11

* CHANGED: Default remote vswhere is 2.6.7.
https://github.com/microsoft/vswhere/releases/tag/2.6.7

CI-build-40: Public release of the hMSBuild 2.1

2019-05-27T17:07:49Z

NEW: Support for VS2019 msbuild (Thanks @gerhardol)
CHANGED: Removed possible last extra slash \ from path, ie. ~ ..\Bin\\MSBuild.exe
When x32 for searching from Visual Studio with -notamd64 key.
Part of PR #11
CHANGED: Default remote vswhere is 2.6.7.
https://github.com/microsoft/vswhere/releases/tag/2.6.7

CI-build-39

2019-05-27T14:21:25Z

🎲 Nightly build of d3c2970 ➾ Worker image: Visual Studio 2015; Console: ci.appveyor.com/.../build-39

❕ Only for tests ❕ 🗨 Commit message:

Merge pull request #11 from gerhardol/bugfix/fix-10-vs2019

Support for VS2019 msbuild (Thanks @gerhardol)

CI-build-38

2019-04-26T17:18:55Z

🎲 Nightly build of c74ff05 ➾ Worker image: Visual Studio 2015; Console: ci.appveyor.com/.../build-38

❕ Only for tests ❕ 🗨 Commit message:

Updated License headers

$(APPVEYOR_REPO_COMMIT_MESSAGE_EXTENDED)