Release workflow

Creating workflow to handle any (pre)release. Triggered by pushing a tag starting with the letter 'v'. Also creating a separate powershell script to extract version information from the tag.

- Renaming some standard repository text files for consistency and inclusion with the released artifacts.
- VS Installer projects only build with the devenv command, so call that specifically for this purpose.
- Updating some file references in the Setup project
- Call special utility that allows us to run devenv on Setup projects (disable or enable out of process building?)
- Try to fix errors building Setup project

Author: gbakeman

.github/workflows/build-release.yaml

@@ -0,0 +1,62 @@
+# Build solution in Release mode and submit a GitHub release.
+
+name: build-release
+
+on:
+  push:
+    tags: "v*"
+
+env:
+  # The desired name of the no-install archive to be uploaded along side the installer.
+  ARCHIVE_NAME: "winnut-client"
+  VS_PATH: "C:/Program Files/Microsoft Visual Studio/2022/Enterprise"
+
+jobs:
+  build-release:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      # Provide VER and SEMVER env vars.
+      - name: Extract version from tag
+        run: ./.github/workflows/get-ver.ps1 ${{ github.ref }}
+      - name: Build solution in Release configuration
+        uses: ./.github/actions/build-solution
+        with:
+          build-mode: "Release"
+          version: "${{ env.VER }}"
+      - name: Prepare no install archive
+        run: |
+          $arc = Compress-Archive -PassThru -Path "WinNUT_V2\WinNUT-Client\bin\Release" -DestinationPath "${{ env.ARCHIVE_NAME }}-v${{ env.SEMVER }}.zip"
+          echo "ARCHIVE_NAME=$arc" >> $env:GITHUB_ENV
+      # https://stackoverflow.com/questions/8648428/an-error-occurred-while-validating-hresult-8000000a
+      - name: Fix 'out of process' build error
+        working-directory: ${{ env.VS_PATH }}
+        run: Start-Process -Wait -NoNewWindow "${{ env.VS_PATH }}\Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild\DisableOutOfProcBuild.exe"
+      # Since MSBuild won't build the Setup project, we need to call devenv directly.
+      - name: Build Setup Project
+        run: Start-Process -Wait -NoNewWindow "${{ env.VS_PATH }}\common7\ide\devenv.com" -ArgumentList "WinNUT_V2\WinNUT_V2.sln /Build Release /Project Setup\Setup.vdproj"
+      - name: Create prerelease
+        uses: softprops/action-gh-release@v1
+        with:
+          draft: true
+          fail_on_unmatched_files: true
+          generate_release_notes: true
+          files: |
+            WinNUT_V2/Setup/Release/WinNUT-Setup.msi
+            ${{ env.ARCHIVE_NAME }}
+            LICENSE.txt
+            README.md
+            CHANGELOG.md
+      # - name: Create prerelease
+      #   uses: "marvinpinto/action-automatic-releases@v1.2.1"
+      #   with:
+      #     repo_token: "${{ secrets.GITHUB_TOKEN }}"
+      #     draft: true   # Release as draft until I'm more confident
+      #     prerelease: true
+      #     files: |
+      #       WinNUT_V2\Setup\Release\WinNUT-Setup.msi
+      #       ${{ env.ARCHIVE_NAME }}.zip
+      #       LICENSE.txt
+      #       README.md
+      #       CHANGELOG.md

.github/workflows/get-ver.ps1

@@ -0,0 +1,18 @@
+# Verify valid semver, and provide it along with an AssemblyVersion-compatible string as env vars.
+
+# Set to the value provided by github.ref
+param([string]$ghRef)
+
+$semVerRegex = "(?<major>0|[1-9]\d*)\.(?<minor>0|[1-9]\d*)\.(?<patch>0|[1-9]\d*)(?:-(?<prerelease>(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+(?<buildmetadata>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$"
+
+if (!($ghRef -match $semVerRegex)) {
+    Write-Host "Could not find valid semver within ref. string. Given: $ghRef"
+    Exit 1
+}
+
+$verRes = "VER={0}.{1}.{2}" -f $matches.major, $matches.minor, $matches.patch
+$semVerRes = "SEMVER=" + $ghRef.Substring(10)
+
+echo $verRes >> $env:GITHUB_ENV
+echo $semVerRes >> $env:GITHUB_ENV
+Write-Host "Result: $verRes, $semVerRes"