Add .NET 9 support, remove .NET 6 (#422)

Author: jasongin

.ado/publish.yml

@@ -11,7 +11,7 @@ trigger: none
 parameters:
   # Matrix with target build platforms.
   # x86 versions are not supported by Native AOT.
-  # Use net8.0 as the latest stable version.
+  # Use net9.0 as the latest stable version.
 - name: buildMatrix
   type: object
   default:
@@ -64,41 +64,41 @@ parameters:
         os: windows
       TargetRuntime: win-x64
       DotNetVersion: net472
-    - Name: win_x64_net60
+    - Name: win_x64_net80
       Pool:
         name: Azure-Pipelines-1ESPT-ExDShared
         vmImage: windows-latest
         os: windows
       TargetRuntime: win-x64
-      DotNetVersion: net6.0
-    - Name: win_x64_net80
+      DotNetVersion: net8.0
+    - Name: win_x64_net90
       Pool:
         name: Azure-Pipelines-1ESPT-ExDShared
         vmImage: windows-latest
         os: windows
       TargetRuntime: win-x64
-      DotNetVersion: net8.0
-    - Name: osx_x64_net80
+      DotNetVersion: net9.0
+    - Name: osx_x64_net90
       Pool:
         name: Azure Pipelines
         vmImage: macos-14
         os: macOS
       TargetRuntime: osx-x64
-      DotNetVersion: net8.0
-    - Name: osx_arm64_net80
+      DotNetVersion: net9.0
+    - Name: osx_arm64_net90
       Pool:
         name: Azure Pipelines
         vmImage: macos-14-arm64
         os: macOS
       TargetRuntime: osx-arm64
-      DotNetVersion: net8.0
-    - Name: linux_x64_net80
+      DotNetVersion: net9.0
+    - Name: linux_x64_net90
       Pool:
         name: Azure-Pipelines-1ESPT-ExDShared
         image: ubuntu-latest
         os: linux
       TargetRuntime: linux-x64
-      DotNetVersion: net8.0
+      DotNetVersion: net9.0
 
 resources:
   repositories:
@@ -141,7 +141,7 @@ extends:
               cancelTimeoutInMinutes: 45 # to allow more time to collect CodeQL debug info.
 
               variables:
-                DotNetMoniker: net8.0
+                DotNetMoniker: net9.0
                 ${{ if and( variables.DisableOsxArm64CodeQL, eq( MatrixEntry.TargetRuntime, 'osx-arm64' )) }}:
                   ONEES_ENFORCED_CODEQL_ENABLED: false
 
@@ -233,12 +233,12 @@ extends:
                 - checkout: self
                   displayName: Shallow git fetch
 
-                - ${{ if eq( MatrixEntry.DotNetVersion, 'net6.0' ) }}:
+                - ${{ if eq( MatrixEntry.DotNetVersion, 'net8.0' ) }}:
                   - task: UseDotNet@2
-                    displayName: Install .Net 6.0.x
+                    displayName: Install .Net 8.0.x
                     inputs:
                       packageType: sdk
-                      version: 6.0.x
+                      version: 8.0.x
 
                 - task: UseDotNet@2
                   displayName: Install .NET SDK using global.json

.github/workflows/build.yml

@@ -12,18 +12,18 @@ jobs:
     strategy:
       matrix:
         os: [ windows-latest, macos-latest, ubuntu-latest ]
-        dotnet-version: [ net472, net6.0, net8.0]
-        node-version: [ 18.x, 20.x ]
+        dotnet-version: [ net472, net8.0, net9.0]
+        node-version: [ 18.x, 22.x ]
         configuration: [ Release ]
         exclude:
-          # Exclude Node 18.x on .NET < 8, to thin the matrix.
-          - dotnet-version: net6.0
+          # Exclude Node 18.x on .NET < 9, to thin the matrix.
+          - dotnet-version: net8.0
             node-version: 18.x
           - dotnet-version: net472
             node-version: 18.x
           # Exclude .NET 4.x on non-Windows OS.
           - os: macos-latest
-            dotnet-version: net472 
+            dotnet-version: net472
           - os: ubuntu-latest
             dotnet-version: net472
 
@@ -36,20 +36,15 @@ jobs:
       with:
         fetch-depth: 0 # Deep clone is required for versioning on git commit height
 
-    - name: Link libdl.so # Required by .NET 6
-      if: matrix.os == 'ubuntu-latest'
-      run: sudo ln -s /lib/x86_64-linux-gnu/libdl.so.2 /lib/x86_64-linux-gnu/libdl.so
-
-    - name: Setup .NET 6
+    - name: Setup .NET 8
       uses: actions/setup-dotnet@v4
       with:
-        dotnet-version: 6.0.x
+        dotnet-version: 8.0.x
 
-    # The .NET 8 SDK is required even when the build matrix targets other .NET versions.
-    - name: Setup .NET 8
+    - name: Setup .NET 9
       uses: actions/setup-dotnet@v4
       with:
-        dotnet-version: 8.0.x
+        dotnet-version: 9.0.x
 
     - name: Setup Node.js ${{ matrix.node-version }}
       uses: actions/setup-node@v4
@@ -67,7 +62,7 @@ jobs:
     #      limit-access-to-actor: true
 
     - name: Upload build artifacts
-      if: matrix.dotnet-version == 'net8.0' && matrix.node-version == '20.x'
+      if: matrix.dotnet-version == 'net9.0' && matrix.node-version == '22.x'
       uses: actions/upload-artifact@v4
       with:
         name: ${{ matrix.os }}-${{ matrix.configuration }}-packages
@@ -87,8 +82,7 @@ jobs:
       continue-on-error: true
 
     - name: Upload test logs
-      # upload-artifact@v4 breaks the test reporter: https://github.com/dorny/test-reporter/issues/343
-      uses: actions/upload-artifact@v3
+      uses: actions/upload-artifact@v4
       with:
         name: test-logs-${{ matrix.os }}-${{matrix.dotnet-version}}-node${{matrix.node-version}}-${{matrix.configuration}}
         path: |

.github/workflows/codeql.yml

@@ -47,16 +47,16 @@ jobs:
         # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
         # queries: security-extended,security-and-quality
 
-    - name: Setup .NET 8
+    - name: Setup .NET 9
       if: matrix.language == 'csharp'
       uses: actions/setup-dotnet@v4
       with:
-        dotnet-version: 8.0.x
+        dotnet-version: 9.0.x
 
     - name: Build C#
       if: matrix.language == 'csharp'
-      run: dotnet build -f:net8.0 -p:Configuration=Debug -p:NBGV_GitEngine=Disabled
-        # Just build the .NET 8 target framework; other targets would be redundant for CodeQL.
+      run: dotnet build -f:net9.0 -p:Configuration=Debug -p:NBGV_GitEngine=Disabled
+        # Just build the .NET 9 target framework; other targets would be redundant for CodeQL.
         # Disable git-versioning to prevent the shallow clone from causing build errors.
 
     - name: Perform CodeQL Analysis

.github/workflows/docs.yml

@@ -36,13 +36,13 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 22
           cache: npm
           cache-dependency-path: './docs/package-lock.json'
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: 8.0.x
+          dotnet-version: 9.0.x
       - name: Setup Pages
         uses: actions/configure-pages@v4
 

.github/workflows/test-report.yml

@@ -18,18 +18,18 @@ jobs:
     strategy:
       matrix: # This must be kept in sync with the PR build matrix.
         os: [ windows-latest, macos-latest, ubuntu-latest ]
-        dotnet-version: [ net472, net6.0, net8.0]
-        node-version: [ 18.x, 20.x ]
+        dotnet-version: [ net472, net8.0, net9.0]
+        node-version: [ 18.x, 22.x ]
         configuration: [ Release ]
         exclude:
-          # Exclude Node 18.x on .NET < 8, to thin the matrix.
-          - dotnet-version: net6.0
+          # Exclude Node 18.x on .NET < 9, to thin the matrix.
+          - dotnet-version: net8.0
             node-version: 18.x
           - dotnet-version: net472
             node-version: 18.x
           # Exclude .NET 4.x on non-Windows OS.
           - os: macos-latest
-            dotnet-version: net472 
+            dotnet-version: net472
           - os: ubuntu-latest
             dotnet-version: net472
 

.vscode/tasks.json

@@ -46,7 +46,7 @@
                 "-c",
                 "Release",
                 "-f",
-                "net8.0",
+                "net9.0",
                 "--",
                 "--filter",
                 "*.NonAot.*"
@@ -68,7 +68,7 @@
               "-c",
               "Release",
               "-f",
-              "net8.0",
+              "net9.0",
               "--",
               "--filter",
               "*.Aot.*"

Directory.Build.props

@@ -1,8 +1,8 @@
 <Project>
   <PropertyGroup>
-    <TargetFrameworks Condition=" '$(TargetFrameworks)' == '' and ! $([MSBuild]::IsOsPlatform('Windows')) ">net8.0;net6.0;netstandard2.0</TargetFrameworks>
-    <TargetFrameworks Condition=" '$(TargetFrameworks)' == '' and $([MSBuild]::IsOsPlatform('Windows')) ">net8.0;net6.0;netstandard2.0;net472</TargetFrameworks>
-    <TargetFrameworks Condition=" '$(PublishAot)' == 'true' ">net8.0</TargetFrameworks>
+    <TargetFrameworks Condition=" '$(TargetFrameworks)' == '' and ! $([MSBuild]::IsOsPlatform('Windows')) ">net9.0;net8.0;netstandard2.0</TargetFrameworks>
+    <TargetFrameworks Condition=" '$(TargetFrameworks)' == '' and $([MSBuild]::IsOsPlatform('Windows')) ">net9.0;net8.0;netstandard2.0;net472</TargetFrameworks>
+    <TargetFrameworks Condition=" '$(PublishAot)' == 'true' ">net9.0</TargetFrameworks>
     <LangVersion>12</LangVersion>
     <Nullable>enable</Nullable>
     <Configuration Condition="'$(Configuration)'==''">Debug</Configuration>

bench/Directory.Build.props

@@ -2,8 +2,8 @@
   <!-- The main purpose of this file is to prevent use of the root Directory.Build.props file,
   because Benchmark.NET does not like the build output paths to be redirected. -->
   <PropertyGroup>
-    <TargetFrameworks Condition=" '$(TargetFrameworks)' == '' and ! $([MSBuild]::IsOsPlatform('Windows')) ">net8.0;net6.0</TargetFrameworks>
-    <TargetFrameworks Condition=" '$(TargetFrameworks)' == '' and $([MSBuild]::IsOsPlatform('Windows')) ">net8.0;net6.0;net472</TargetFrameworks>
+    <TargetFrameworks Condition=" '$(TargetFrameworks)' == '' and ! $([MSBuild]::IsOsPlatform('Windows')) ">net9.0;net8.0</TargetFrameworks>
+    <TargetFrameworks Condition=" '$(TargetFrameworks)' == '' and $([MSBuild]::IsOsPlatform('Windows')) ">net9.0;net8.0;net472</TargetFrameworks>
     <LangVersion>12</LangVersion>
     <Nullable>enable</Nullable>
     <PackRelease>false</PackRelease>

bench/README.md

@@ -9,21 +9,21 @@ though the "Dynamic" benchmarks are CLR-only.
 
 ### Run all benchmarks
 ```
-dotnet run -c Release -f net8.0 --filter *
+dotnet run -c Release -f net9.0 --filter *
 ```
 
 ### Run only CLR or only AOT benchmarks
 ```
-dotnet run -c Release -f net8.0 --filter *clr.*
-dotnet run -c Release -f net8.0 --filter *aot.*
+dotnet run -c Release -f net9.0 --filter *clr.*
+dotnet run -c Release -f net9.0 --filter *aot.*
 ```
 
 ### Run a specific benchmark
 ```
-dotnet run -c Release -f net8.0 --filter *clr.CallDotnetFunction
+dotnet run -c Release -f net9.0 --filter *clr.CallDotnetFunction
 ```
 
 ### List benchmarks
 ```
-dotnet run -c Release -f net8.0 --list flat
+dotnet run -c Release -f net9.0 --list flat
 ```

docs/features/type-definitions.md

@@ -20,7 +20,7 @@ The easiest way to generate type definitions is to leverage the provided MSBuild
 the `Microsoft.JavaScript.NodeApi.Generator` NuGet package:
 ```xml
 <ItemGroup>
-  <PackageReference Include="Microsoft.JavaScript.NodeApi.Generator" Version="0.7.*-*" />
+  <PackageReference Include="Microsoft.JavaScript.NodeApi.Generator" Version="0.9.*-*" />
 </ItemGroup>
 ```