如何在多平台64位环境下将原生资源纳入NuGet包

刚好做过类似的跨平台NuGet包，给你一套完整的解决方案，完美解决原生资源并行分发、开发构建流程整合的问题：

首先把原生资源按平台分类存放，方便后续配置和维护：

MyDotNetLibrary/
├── MyDotNetLibrary.csproj       # .NET Standard 2.0 类库项目
├── NativeAssets/
│   ├── win-x64/
│   │   ├── my-native.exe
│   │   └── my-native.dll
│   ├── linux-x64/
│   │   └── libmy-native.so
│   └── osx-x64/
│       └── libmy-native.dylib
└── [你的类库代码文件]

这是核心步骤，要让原生资源在开发调试时自动复制到输出目录，同时打包进NuGet时按平台路径存放：

在你的MyDotNetLibrary.csproj里添加以下配置：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
    <!-- 可选：如果需要指定NuGet包的其他元数据 -->
    <PackageId>YourPackageId</PackageId>
    <Version>1.0.0</Version>
  </PropertyGroup>

  <ItemGroup>
    <!-- 按平台分组配置原生资源 -->
    <None Include="NativeAssets/win-x64/**" 
          CopyToOutputDirectory="PreserveNewest" 
          Pack="true" 
          PackagePath="runtimes/win-x64/native/" />
    
    <None Include="NativeAssets/linux-x64/**" 
          CopyToOutputDirectory="PreserveNewest" 
          Pack="true" 
          PackagePath="runtimes/linux-x64/native/" />
    
    <None Include="NativeAssets/osx-x64/**" 
          CopyToOutputDirectory="PreserveNewest" 
          Pack="true" 
          PackagePath="runtimes/osx-x64/native/" />
  </ItemGroup>

</Project>

配置说明： #

• CopyToOutputDirectory="PreserveNewest"：开发调试时，会把对应平台的原生文件自动复制到项目输出目录，确保调试时能找到资源。
• Pack="true"：标记这些文件需要被打包进NuGet包。
• PackagePath="runtimes/<platform>/native/"：严格遵循NuGet的运行时资源规范，这样安装包时，NuGet会自动根据目标平台把原生文件复制到项目输出目录的对应路径下，和.NET类库并行存在。

• 本地调试：当你在Windows上调试时，win-x64下的原生文件会被复制到输出目录的runtimes/win-x64/native文件夹；切换到Linux/macOS环境调试时，对应平台的文件会自动同步。
• 指定目标平台构建：如果需要针对特定平台测试，可以用命令行指定RuntimeIdentifier：

  # Windows平台构建
  dotnet build -r win-x64
  # Linux平台构建
  dotnet build -r linux-x64
  # macOS平台构建
  dotnet build -r osx-x64
  

因为原生文件存放在runtimes/<platform>/native目录下，你需要在类库中动态获取当前平台的资源路径，示例代码：

using System;
using System.IO;
using System.Reflection;
using System.Runtime.InteropServices;

namespace MyDotNetLibrary
{
    public static class NativeResourceLocator
    {
        public static string GetNativeFilePath(string nativeFileName)
        {
            // 获取当前类库所在目录
            var assemblyDirectory = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location) 
                                   ?? throw new InvalidOperationException("无法获取程序集路径");

            // 根据当前平台和架构确定原生资源目录
            var runtimeDir = RuntimeInformation.ProcessArchitecture switch
            {
                Architecture.X64 when RuntimeInformation.IsOSPlatform(OSPlatform.Windows) => "win-x64",
                Architecture.X64 when RuntimeInformation.IsOSPlatform(OSPlatform.Linux) => "linux-x64",
                Architecture.X64 when RuntimeInformation.IsOSPlatform(OSPlatform.OSX) => "osx-x64",
                _ => throw new PlatformNotSupportedException("仅支持64位Windows/Linux/macOS平台")
            };

            // 拼接完整的原生文件路径
            var nativeFilePath = Path.Combine(assemblyDirectory, "runtimes", runtimeDir, "native", nativeFileName);

            if (!File.Exists(nativeFilePath))
            {
                throw new FileNotFoundException("未找到指定的原生资源文件", nativeFilePath);
            }

            return nativeFilePath;
        }
    }
}

• 执行打包命令：

  dotnet pack -c Release
  

• 验证NuGet包：可以用NuGet包浏览器打开生成的.nupkg文件，检查runtimes目录下是否包含各平台的native文件夹，且里面有对应的原生文件。

• 原生文件未复制到输出目录：检查csproj中Include的路径是否正确，确保文件存在，CopyToOutputDirectory设置为PreserveNewest或Always。
• NuGet安装后原生文件缺失：确认PackagePath严格遵循runtimes/<platform>/native/格式，NuGet只有识别到这个路径才会自动分发原生资源。
• 跨平台测试异常：在Linux/macOS环境测试时，确保原生文件有可执行权限（Linux下可以用chmod +x libmy-native.so）。

内容的提问来源于stack exchange，提问作者Veksi