Upgrade project to .NET 9 (#213)

This commit upgrades the project and all dependencies to .NET 9.

The following changes were made:
- Updated TargetFramework to net9.0 in Directory.Build.props and all .csproj files.
- Updated .NET SDK version to 9.0.x in GitHub Actions and Azure Pipelines.
- Updated NuGet package dependencies to their latest versions compatible with .NET 9.
- Fixed build errors related to package updates.

The project builds successfully after these changes.

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>

Author: pekkah

.github/workflows/docs.yml

@@ -10,58 +10,51 @@ on:
   pull_request:
     branches: [master]
 
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
 env:
   DOTNET_SKIP_FIRST_TIME_EXPERIENCE: 1
   DOTNET_CLI_TELEMETRY_OPTOUT: 1
 
 jobs:
   build:
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4.2.2
         with:
           fetch-depth: 0
 
       - name: Setup .NET
-        uses: actions/setup-dotnet@v1
+        uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: |
-            3.1.x
-            6.0.x
+          dotnet-version: '9.0.x'
 
       - name: Build docs
         shell: pwsh
         run: |
           ./build-docs.ps1 -Output ./artifacts/gh-pages -CurrentBranch $Env:GITHUB_REF_NAME
       
-      - name: Publish build artifacts
-        uses: actions/upload-artifact@v2
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3.0.1
         with:
-          name: Docs
-          path: |
-            ./artifacts/gh-pages
+          path: ./artifacts/gh-pages
 
   deploy:
     runs-on: ubuntu-latest
     needs: build
     concurrency: ci-${{ github.ref }}
+    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+    permissions:
+      pages: write      # to deploy to Pages
+      id-token: write   # to verify AIDC token
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     steps:
-      - uses: actions/checkout@v2
-        with:
-          fetch-depth: 0
-
-      - uses: actions/download-artifact@v2
-        with:
-          name: Docs
-          path: docs
-      
-      - run: ls -la ./docs
-
-      - name: Deploy 🚀
-        uses: JamesIves/github-pages-deploy-action@v4.2.3
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4.0.5
         if: github.ref_name == 'master' || startsWith(github.ref, 'refs/tags/')
-        with:
-          branch: gh-pages
-          folder: ./docs
-          commit-message: ${{github.ref_name}}
-          clean: true

.github/workflows/dotnet.yml

@@ -18,26 +18,26 @@ env:
 
 jobs:
   build:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4.2.2
         with:
           fetch-depth: 0
 
       - name: Setup .NET
-        uses: actions/setup-dotnet@v1
+        uses: actions/setup-dotnet@v4
         with:
           dotnet-version: |
-            6.0.x
+            9.0.x
 
       - name: Build packages
         shell: pwsh
         run: |
           ./build.ps1 -Output ./artifacts -CurrentBranch $Env:GITHUB_REF_NAME
 
       - name: Publish build artifacts
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v4.6.2
         with:
           name: Packages
           path: |

.github/workflows/on-tag-do-release.yml

@@ -6,19 +6,13 @@ on:
 jobs:
   release:
     runs-on: ubuntu-latest
+    permissions:
+      contents: write # IMPORTANT: mandatory for ncipollo/release-action to create releases
     steps:
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v1
-        with:
-          dotnet-version: 6.0.x
+      - name: Checkout code
+        uses: actions/checkout@v4.2.2
 
-      - name: Run
-        run: |
-          dotnet tool install --global GitReleaseManager.Tool
-          tag="${GITHUB_REF:10}"
-          owner="${GITHUB_REPOSITORY%/*}"
-          repo="${GITHUB_REPOSITORY#*/}"
-          dotnet-gitreleasemanager create -m ${tag} --token ${{secrets.GITHUB_TOKEN}} -o ${owner} -r ${repo}
-          dotnet-gitreleasemanager close -m ${tag} --token ${{secrets.GITHUB_TOKEN}} -o ${owner} -r ${repo}
-          dotnet-gitreleasemanager publish -t ${tag} --token ${{secrets.GITHUB_TOKEN}} -o ${owner} -r ${repo}
-        shell: bash
+      - name: Create Release
+        uses: ncipollo/release-action@v1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}

Directory.Build.props

@@ -7,7 +7,7 @@
     <PackageTags>tanka documentation docs tool generator roslyn markdown</PackageTags>
     <Authors>Pekka Heikura</Authors>
 
-	<TargetFramework>net6.0</TargetFramework>
+	<TargetFramework>net9.0</TargetFramework>
     <Nullable>enable</Nullable>
     <Language>latest</Language>
   </PropertyGroup>

azure-pipelines.yml

@@ -16,11 +16,16 @@ function EnsureLastExitCode($message){
 $Location = Get-Location
 "Location: $Location"
 
-if ((Test-Path $output) -eq $True) {
+if ((Test-Path $Output) -eq $True) {
     "Clean: $Output"
     Remove-Item -Recurse -Force $Output
 }
 
+# Ensure output directory exists
+if (-not (Test-Path $Output)) {
+    New-Item -ItemType Directory -Path $Output | Out-Null
+}
+
 # Git Information
 "----------------------------------------"
 if ($CurrentBranch -eq '') {
@@ -67,8 +72,13 @@ $Basepath = "/tanka-docs-gen/"
 "Output: $DocsOutput"
 "BasePath: $Basepath"
 
-dotnet run --project ./src/DocsTool -- build --output $DocsOutput --base $Basepath
-EnsureLastExitCode("dotnet tanka-docs failed")
+"Publishing DocsTool..."
+dotnet publish ./src/DocsTool --runtime win-x64 --output ./temp/DocsTool --no-self-contained
+EnsureLastExitCode("dotnet publish DocsTool failed")
+
+"Running published DocsTool..."
+dotnet ./temp/DocsTool/Tanka.DocsGen.dll build --output $DocsOutput --base $Basepath
+EnsureLastExitCode("DocsTool execution failed")
 
 "----------------------------------------"
 "DONE"