Building a Release

H1.6

Note: This is a work in progress. Most of the release instructions need to be revisited and adapted from the 1.4 instructions.

Tools Installation

• Install Visual Studio support for Installer Projects from here (works with 2019 also):

https://marketplace.visualstudio.com/items?itemName=VisualStudioClient.MicrosoftVisualStudio2017InstallerProjects

• Follow the instructions here to enable command line building of the installer (works with 2019 also):

the Microsoft Visual Studio 2017 Installer Projects extension now includes a command line helper tool for making the registry setting much easier to apply Microsoft Visual Studio 2017 Installer Projects Example paths of the tool (based on the version of Visual Studio installed)

Professional Edition: C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild\DisableOutOfProcBuild.exe

Community Edition: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild\DisableOutOfProcBuild.exe

From the README

This simple tool is meant to help users set the registry key needed to get around this error that can appear when building installer projects using command line builds: ERROR: An error occurred while validating. HRESULT = '8000000A' The tool is meant for Visual Studio 2017+ and sets this reg key for a particular installed Visual Studio instance for the current user. So if you're setting this on a build agent make sure to use the user account that the build will use.

Run "DisableOutOfProcBuild.exe help" for usage details.

from https://stackoverflow.com/questions/8648428/an-error-occurred-while-validating-hresult-8000000a/45580775#45580775

Building

In the Helios repo root, run build 1.6.BUILD.REVISION where BUILD is your build number and REVISION is your revision number.

Logs

Build logs are emitted as binary logs in these files:

• clean.binlog (From cleaning process)
• prebuild.binlog (From BuildMeFirst.sln build)
• build.binlog (From building of all assemblies)
• [no log] (From building of installers)

Binary log files have full detail in a compact format. See https://msbuildlog.com/