2026年4月最新：.NET Native AOTを活用したNode.jsアドオンの構築とC#による開発の効率化

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- 2026年時点の最新ターゲットフレームワーク -->
    <TargetFramework>net10.0</TargetFramework>
    <!-- Native AOTを有効化 -->
    <PublishAot>true</PublishAot>
    <!-- N-APIとの相互運用にポインタ操作が必要なため許可 -->
    <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
  </PropertyGroup>
</Project>

using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;

public static unsafe partial class RegistryAddon
{
    // Node.jsがロード時に呼び出す関数
    [UnmanagedCallersOnly(
        EntryPoint = "napi_register_module_v1",
        CallConvs = [typeof(CallConvCdecl)])]
    public static nint Init(nint env, nint exports)
    {
        // P/Invokeリゾルバーの初期化
        Initialize();

        // C#のメソッドをJavaScriptの関数として登録
        RegisterFunction(
            env,
            exports,
            "readStringValue"u8, // UTF-8文字列リテラル
            &ReadStringValue);

        return exports;
    }
}

private static void Initialize()
{
    // "node"という名前のインポートをホストプロセスにリダイレクトする設定
    NativeLibrary.SetDllImportResolver(
        System.Reflection.Assembly.GetExecutingAssembly(),
        ResolveDllImport);

    static nint ResolveDllImport(
        string libraryName,
        System.Reflection.Assembly assembly,
        DllImportSearchPath? searchPath)
    {
        if (libraryName is not "node")
            return 0;

        // メインプログラム（node.exeなど）のハンドルを返す
        return NativeLibrary.GetMainProgramHandle();
    }
}

private static partial class NativeMethods
{
    // 文字列生成のためのN-API
    [LibraryImport("node", EntryPoint = "napi_create_string_utf8")]
    internal static partial Status CreateStringUtf8(
        nint env, ReadOnlySpan<byte> str, nuint length, out nint result);

    // JavaScript関数の登録
    [LibraryImport("node", EntryPoint = "napi_create_function")]
    internal static unsafe partial Status CreateFunction(
        nint env, ReadOnlySpan<byte> utf8name, nuint length,
        delegate* unmanaged[Cdecl]<nint, nint, nint> cb,
        nint data, out nint result);

    // JavaScriptからの引数取得
    [LibraryImport("node", EntryPoint = "napi_get_cb_info")]
    internal static unsafe partial Status GetCallbackInfo(
        nint env, nint cbinfo, ref nuint argc,
        Span<nint> argv, nint* thisArg, nint* data);
}

private static unsafe string? GetStringArg(nint env, nint cbinfo, int index)
{
    nuint argc = (nuint)(index + 1);
    Span<nint> argv = stackalloc nint[index + 1];
    NativeMethods.GetCallbackInfo(env, cbinfo, ref argc, argv, null, null);

    if ((int)argc <= index) return null;

    // UTF-8としての長さを取得
    NativeMethods.GetValueStringUtf8(env, argv[index], null, 0, out nuint len);

    int bufLen = (int)len + 1;
    byte[]? rented = null;
    // 小さな文字列はスタック、大きな文字列はプールを使用
    Span<byte> buf = bufLen <= 512
        ? stackalloc byte[bufLen]
        : (rented = ArrayPool<byte>.Shared.Rent(bufLen));

    try
    {
        fixed (byte* pBuf = buf)
            NativeMethods.GetValueStringUtf8(env, argv[index], pBuf, len + 1, out _);

        return Encoding.UTF8.GetString(buf[..(int)len]);
    }
    finally
    {
        if (rented is not null) ArrayPool<byte>.Shared.Return(rented);
    }
}

[UnmanagedCallersOnly(CallConvs = [typeof(CallConvCdecl)])]
private static nint ReadStringValue(nint env, nint info)
{
    try
    {
        var keyPath = GetStringArg(env, info, 0);
        var valueName = GetStringArg(env, info, 1);

        if (keyPath is null || valueName is null)
        {
            ThrowError(env, "引数が不足しています。");
            return 0;
        }

        // 標準の.NET APIを使用
        using var key = Registry.CurrentUser.OpenSubKey(keyPath, writable: false);
        var result = key?.GetValue(valueName) as string;

        return result != null ? CreateString(env, result) : GetUndefined(env);
    }
    catch (Exception ex)
    {
        // アンマネージドコード内での例外はプロセスをクラッシュさせるため
        // 必ずキャッチしてJavaScript側のエラーとして報告する
        ThrowError(env, $"レジストリ読み取り失敗: {ex.Message}");
        return 0;
    }
}

// アドオンの型定義
interface RegistryAddon {
    readStringValue(keyPath: string, valueName: string): string | undefined;
}

// ネイティブモジュールのロード
const registry = require('./RegistryAddon.node') as RegistryAddon;

// C#で書かれた関数を実行
const installLocation = registry.readStringValue(
    'SOFTWARE\\dotnet\\Setup\\InstalledVersions\\x64\\sdk', 
    'InstallLocation'
);