Add .NET 9 support, remove .NET 6

.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>
 ```
 

docs/scenarios/js-dotnet-dynamic.md

@@ -11,7 +11,7 @@ For examples of this scenario, see one of these directories in the repo:
    ```xml
    <Project Sdk="Microsoft.NET.Sdk">
      <PropertyGroup>
-       <TargetFramework>net6.0</TargetFramework>
+       <TargetFramework>net8.0</TargetFramework>
        <OutDir>bin</OutDir>
        <NodeApiAssemblyJSModuleType>commonjs</NodeApiAssemblyJSModuleType>// [!code highlight]
      </PropertyGroup>
@@ -72,16 +72,16 @@ For examples of this scenario, see one of these directories in the repo:
    A `.js` suffix is required when using ES modules, optional with CommonJS.
     ::: code-group
     ```JavaScript [ES (TS or JS)]
-    import dotnet from 'node-api-dotnet/net6.0.js';
+    import dotnet from 'node-api-dotnet/net8.0.js';
     ```
     ```TypeScript [CommonJS (TS)]
-    import * as dotnet from 'node-api-dotnet/net6.0';
+    import * as dotnet from 'node-api-dotnet/net8.0';
     ```
     ```JavaScript [CommonJS (JS)]
-    const dotnet = require('node-api-dotnet/net6.0');
+    const dotnet = require('node-api-dotnet/net8.0');
     ```
     :::
-   Currently the supported target frameworks are `net472`, `net6.0`, and `net8.0`.
+   Currently the supported target frameworks are `net472`, `net8.0`, and `net9.0`.
 
 4. Load one or more .NET packages using the generated `.js` files:
     ::: code-group

docs/scenarios/js-dotnet-module.md

@@ -3,11 +3,11 @@
 For a minimal example of this scenario, see
 [/examples/dotnet-module/](https://github.com/microsoft/node-api-dotnet/blob/main/examples/dotnet-module/).
 
-1. Create a .NET Class library project that targets .NET 6 or later. (.NET 8 for AOT.)
+1. Create a .NET Class library project that targets .NET 8 or later.
     ```shell
     mkdir ExampleModule
     cd ExampleModule
-    dotnet new classlib --framework net6.0
+    dotnet new classlib --framework net8.0
     ```
 
 2. Add a reference to the `Microsoft.JavaScript.NodeApi` and
@@ -20,8 +20,8 @@ For a minimal example of this scenario, see
     Afterward you should have the two references in your project file:
     ```xml
     <ItemGroup>
-      <PackageReference Include="Microsoft.JavaScript.NodeApi" Version="0.7.*-*" />
-      <PackageReference Include="Microsoft.JavaScript.NodeApi.Generator" Version="0.7.*-*" />
+      <PackageReference Include="Microsoft.JavaScript.NodeApi" Version="0.9.*-*" />
+      <PackageReference Include="Microsoft.JavaScript.NodeApi.Generator" Version="0.9.*-*" />
     </ItemGroup>
     ```
 
@@ -86,7 +86,7 @@ For a minimal example of this scenario, see
     const dotnet = require('node-api-dotnet/net8.0');
     ```
     :::
-   Currently the supported target frameworks are `net472`, `net6.0`, and `net8.0`.
+   Currently the supported target frameworks are `net472`, `net8.0`, and `net9.0`.
 
 7. Load your .NET module assembly from its path using the `dotnet.require()` function:
     ```JavaScript

docs/tools/build-dotnet-api-docs.js

@@ -6,7 +6,7 @@ const fs = require('node:fs');
 const path = require('node:path');
 
 const assemblyNamePrefix = 'Microsoft.JavaScript.';
-const docsTargetFramework = 'net6.0';
+const docsTargetFramework = 'net8.0';
 const docsConfiguration = 'Release';
 const ridPlatform =
   process.platform === 'win32' ? 'win' :

examples/semantic-kernel/semantic-kernel.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net6.0</TargetFramework>
+    <TargetFramework>net8.0</TargetFramework>
     <RestorePackagesPath>$(MSBuildThisFileDirectory)/pkg</RestorePackagesPath>
     <OutDir>bin</OutDir>
   </PropertyGroup>

examples/wpf/WpfExample.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net6.0-windows</TargetFramework>
+    <TargetFramework>net8.0-windows</TargetFramework>
     <RestorePackagesPath>$(MSBuildThisFileDirectory)/pkg</RestorePackagesPath>
     <OutDir>bin</OutDir>
     <UseWPF>true</UseWPF>

global.json

@@ -1,6 +1,6 @@
 {
   "sdk": {
-    "version": "8.0.100",
+    "version": "9.0.100",
     "allowPrerelease": true,
     "rollForward": "latestFeature"
   }

src/NodeApi.DotNetHost/DebugHelper.cs

@@ -5,6 +5,8 @@
 using System.Diagnostics;
 using System.Threading;
 
+#pragma warning disable IDE0130 // Namespace does not match folder structure
+
 namespace Microsoft.JavaScript.NodeApi;
 
 // Only checking the environment variable for debugging.