.NET Native Exports (DNNE) 安装与配置指南

.NET Native Exports (DNNE) 安装与配置指南

DNNE Prototype native exports for a .NET Assembly. 项目地址: https://gitcode.com/gh_mirrors/dn/DNNE

1. 项目基础介绍

.NET Native Exports (DNNE) 是一个开源项目，它旨在为 .NET 程序集提供本地代码导出的能力，使得 .NET 方法可以被本地代码直接调用。该项目的主要编程语言是 C#，用于编写 .NET 程序集，同时使用 C 语言特性进行本地代码的声明和调用。

2. 关键技术和框架

• .NET Core/.NET 5/6: DNNE 支持多种版本的 .NET Core 和 .NET 5/6，提供与这些框架的兼容性。
• C# 和 C 语言互操作: 通过特殊的属性和代码生成技术，DNNE 实现了 C# 代码和 C 代码之间的互操作。
• MSBuild: 使用 MSBuild 进行构建，通过 MSBuild 属性和任务来配置和生成本地代码。

3. 安装和配置

准备工作

在开始安装 DNNE 之前，您需要确保已经安装以下环境和工具：

• .NET SDK: 安装与 DNNE 兼容版本的 .NET SDK。您可以从 官方网站 下载并安装。
• Visual Studio: 如果您打算在 Visual Studio 中使用 DNNE，建议安装 Visual Studio 2019 或更高版本，并确保安装了 C# 和 .NET Core/5/6 的开发工具。
• C 编译器: 根据您的操作系统，您可能需要安装 C 编译器，例如在 Windows 上是 Visual Studio 的 C++ 工具集，在 macOS 上是 Clang，在 Linux 上是 GCC 或 Clang。

安装步骤

1. 克隆仓库
   使用 Git 命令克隆 DNNE 项目仓库到本地：

   git clone https://github.com/AaronRobinsonMSFT/DNNE.git
   

2. 安装 DNNE NuGet 包
   打开 DNNE 克隆后的目录，在项目目录下运行以下命令来构建 DNNE NuPkg：

   dotnet build create_package.proj
   

   构建完成后，使用 NuGet 包管理器将 DNNE NuPkg 添加到您的 .NET 项目中，或者在您的 .csproj 文件中手动添加以下代码：

   <ItemGroup>
     <PackageReference Include="DNNE" Version="2.*" />
   </ItemGroup>
   

   如果是本地构建的 NuPkg，请确保更新 nuget.config 文件，以指向本地 DNNE NuPkg 的路径。

3. 配置项目
   在包含要导出方法的 .NET 项目中，设置以下 MSBuild 属性：

   <PropertyGroup>
     <EnableDynamicLoading>true</EnableDynamicLoading>
   </PropertyGroup>
   

   这将生成一个 .runtimeconfig.json 文件，它是激活运行时调用导出方法所必需的。

4. 定义导出方法
   在您的 .NET 类中，使用 UnmanagedCallersOnlyAttribute 标记您希望导出的静态公共方法。

5. 构建项目
   构建您的 .NET 项目，构建完成后，您将得到一个带有 .NE 后缀的本地二进制文件，该文件包含了您导出的方法。

通过以上步骤，您应该能够成功安装和配置 DNNE，开始使用它来从本地代码调用 .NET 方法了。

DNNE Prototype native exports for a .NET Assembly. 项目地址: https://gitcode.com/gh_mirrors/dn/DNNE