DNNE 项目使用与配置指南

DNNE 项目使用与配置指南

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

1. 项目的目录结构及介绍

DNNE 项目是一个.NET managed assembly 的原型，用于暴露原生 exports。项目的目录结构如下：

• DNNE.sln：项目的解决方案文件，用于在 Visual Studio 中加载项目。
• .github/：包含 GitHub Actions 工作流程的目录。
• src/：源代码目录，包含 C# 代码和项目文件。
• test/：测试代码目录，用于存放单元测试。
• sample/：示例项目目录，包含一个用于演示如何使用 DNNE 的 C# 项目。
• LICENSE：项目的许可证文件，DNNE 使用 MIT 许可证。
• readme.md：项目的自述文件，包含项目的基本信息和说明。

2. 项目的启动文件介绍

项目的启动主要是通过 Visual Studio 打开 DNNE.sln 解决方案文件，然后构建和运行项目。以下是主要文件和功能介绍：

• DNNE.csproj：DNNE 项目的项目文件，定义了项目的编译设置和引用。
• Exports.cs：包含标记为 UnmanagedCallersOnlyAttribute 的静态方法，这些方法将暴露为原生 exports。

示例代码：

[UnmanagedCallersOnly(EntryPoint = "FancyName")]
public static int MyExport(int a)
{
    return a;
}

这里，MyExport 方法将被暴露为一个原生函数，可以被其他原生应用程序调用。

3. 项目的配置文件介绍

DNNE 项目使用 MSBuild 属性来进行配置，这些属性可以在 .csproj 文件中设置。以下是一些常用的配置属性：

• DnneWindowsExportsDef：指定一个 .def 文件，用于定义原生 exports 的名称和其它属性。
• DnneAdditionalIncludeDirectories：指定额外的包含目录，用于搜索头文件。
• DNNE.C99DeclCode：在生成的 C 头文件中提供 C 代码定义。
• DNNE.C99Type：定义原生类型映射，用于在 export 定义中使用。

在 DNNE.props 文件中，可以找到这些属性的详细配置。以下是一个配置示例：

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

这段 XML 代码可以被添加到 C# 项目的 .csproj 文件中，用于添加 DNNE NuGet 包的引用。

请按照以上指南进行项目的配置和使用，以确保能够正确地编译和运行 DNNE 项目。

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