build(ci): 🚀 add release workflow and GitVersion configuration

Author: esnya

.github/release.yml

@@ -0,0 +1,24 @@
+changelog:
+  exclude:
+    labels:
+      - ignore-release
+  categories:
+    - title: Breaking Changes
+      labels:
+        - breaking
+    - title: Features
+      labels:
+        - feature
+        - enhancement
+    - title: Bug Fixes
+      labels:
+        - bug
+        - fix
+    - title: Maintenance
+      labels:
+        - chore
+        - dependencies
+        - docs
+    - title: Other Changes
+      labels:
+        - '*'

.github/workflows/ci.yml

@@ -22,6 +22,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - name: Verify Steam credentials
         shell: bash
@@ -42,6 +44,11 @@ jobs:
           steam-user: ${{ secrets.STEAMUSER }}
           steam-password: ${{ secrets.STEAMPASS }}
 
+      - name: Setup .NET SDK
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 9.0.x
+
       - name: Cache NuGet packages
         uses: actions/cache@v4
         with:
@@ -73,3 +80,46 @@ jobs:
         run: |
           dotnet test ReferenceReplacement.sln --configuration Release --no-build \
             -p:ResoniteAssembliesDir="${{ steps.resonite.outputs.resonite-path }}"
+
+      - name: Prepare release assets
+        if: startsWith(github.ref, 'refs/tags/v')
+        shell: bash
+        run: |
+          set -euo pipefail
+          artifacts_dir=release-artifacts
+          mkdir -p "$artifacts_dir"
+          cp src/ReferenceReplacement/bin/Release/net9.0/ReferenceReplacement.dll "$artifacts_dir/ReferenceReplacement.dll"
+          if [ -f src/ReferenceReplacement/bin/Release/net9.0/ReferenceReplacement.pdb ]; then
+            cp src/ReferenceReplacement/bin/Release/net9.0/ReferenceReplacement.pdb "$artifacts_dir/ReferenceReplacement.pdb"
+          fi
+
+      - name: Upload release artifacts
+        if: startsWith(github.ref, 'refs/tags/v')
+        uses: actions/upload-artifact@v4
+        with:
+          name: reference-replacement
+          path: release-artifacts
+          if-no-files-found: error
+
+  release:
+    runs-on: ubuntu-latest
+    needs: build
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: reference-replacement
+          path: release-artifacts
+
+      - name: Publish GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: Reference Replacement ${{ github.ref_name }}
+          generate_release_notes: true
+          files: |
+            release-artifacts/ReferenceReplacement.dll
+            release-artifacts/ReferenceReplacement.pdb

GitVersion.yml

@@ -0,0 +1,36 @@
+mode: Mainline
+branches:
+  master:
+    regex: ^master$
+    tag: ''
+    increment: patch
+    prevent-increment-of-merged-branch-version: true
+  feature:
+    regex: ^(feature|feat|bugfix)/
+    increment: patch
+  pull-request:
+    regex: ^(pull|pr)/
+    tag: pr
+    increment: patch
+  hotfix:
+    regex: ^hotfix/
+    increment: patch
+  release:
+    regex: ^release/
+    increment: minor
+  develop:
+    regex: ^develop$
+    increment: minor
+ignore:
+  sha: []
+tag-prefix: v
+continuous-delivery-fallback-tag: ci
+legacy-semver-padding: 3
+build-metadata-padding: 5
+commits-since-version-source-padding: 4
+assembly-versioning-scheme: MajorMinorPatch
+assembly-file-versioning-format: '{Major}.{Minor}.{Patch}.0'
+assembly-informational-format: '{FullSemVer}+{ShortSha}'
+major-version-bump-message: '\+semver:\s?(breaking|major)'
+minor-version-bump-message: '\+semver:\s?(feature|minor)'
+patch-version-bump-message: '\+semver:\s?(fix|patch)'

src/ReferenceReplacement/ReferenceReplacement.csproj

@@ -7,8 +7,6 @@
     <LangVersion>12.0</LangVersion>
     <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
     <CopyToMods Condition="'$(CopyToMods)'==''">false</CopyToMods>
-    <AssemblyVersion>0.1.0.0</AssemblyVersion>
-    <FileVersion>0.1.0.0</FileVersion>
   </PropertyGroup>
 
   <PropertyGroup>
@@ -52,6 +50,10 @@
     </AssemblyAttribute>
   </ItemGroup>
 
+  <ItemGroup>
+    <PackageReference Include="GitVersion.MsBuild" Version="5.12.0" PrivateAssets="all" />
+  </ItemGroup>
+
   <Target Name="PostBuild" AfterTargets="PostBuildEvent" Condition="'$(CopyToMods)'=='true'">
     <PropertyGroup>
       <_ResoniteModsDir>$(ResolvedResoniteAssembliesDir)/rml_mods</_ResoniteModsDir>