适用于 Android 的原生 (C++) 插件

Unity 支持用 C/C ++ 编写并封装在共享库 (.so) 或静态库 (.a) 中的 Android 原生插件。使用 IL2CPP 脚本后端时，可以使用 C/C++ 源文件作为插件，Unity 会将这些文件与 IL2CPP 生成的文件一起编译。这包括扩展名为 .c、.cc、.cpp 和 .h 的所有 C/C++ 源文件。

Scripting backend compatibility.

The following table shows which scripting backends support the different types of native plug-ins.

Scripting backend	Shared library	Static library	C/C++ source files
IL2CPP	是	是	是
Mono	是	否	否

Building and using a native plug-in

要构建适用于 Android 的 C++ 插件，请使用 Android NDK 并熟悉构建共享库所需的步骤。静态库也是如此。

如果使用 C++ 来实现该插件，必须确保使用 C 链接来声明方法以免发生名称错用问题。默认情况下，只有插件中具有 .c 文件扩展名的 C 源文件才具有 C 链接（不是 C++）。

extern "C" {
  float Foopluginmethod ();
}

构建库后，将输出的 .so 文件复制到 Unity 项目中。在 Inspector 中，将 .so 文件标记为与 Android 兼容，并在下拉框中设置所需的 CPU 架构：

要从 C# 脚本调用原生插件中的方法，请使用以下代码：

[DllImport ("pluginName")]
private static extern float Foopluginmethod();

请注意，pluginName 不应包含文件名的前缀（“lib”）和扩展名（“.so”）。建议使用额外的 C# 代码层包装所有的原生插件方法调用。此代码将检查 Application.platform 并仅当应用程序在实际设备上运行时才调用本机方法；在 Editor 中运行时，将从 C# 代码返回虚拟值。请使用平台定义来控制依赖于平台的代码编译。

在使用 C/C++ 源文件作为插件时，可以用相同的方式从 C# 调用这些文件，不同之处是插件名称使用 __Internal，例如：

[DllImport ("__Internal")]
private static extern float Foopluginmethod();

原生 (C++) 插件示例

AndroidNativePlugin.unitypackage zip 文件包含一个分发为 Unity 包的原生代码插件的简单示例。

该示例演示如何从 Unity 应用程序调用 C++ 代码。该包中包含的一个场景显示了由原生插件计算的两个值之和。要编译该插件，必须安装 Android NDK。

要安装该示例，请执行以下操作：

1.下载 zip 文件。 2.解压缩 AndroidNativePlugin.unitypackage 文件。 3.打开 Unity Editor。 4.创建一个新的项目。 5.在新项目中，单击 Assets > Import Package > Custom Package。 6.在 Import Package 文件对话框中，导航到解压缩文件的位置，然后选择该文件。

---

• 2018–12–21 页面已修订
• 2018–03–10 页面已发布
• 5.5 版中的更新功能
• 在 2018.2 版本中添加了使用 C++ 源文件和静态库作为 Android 插件的支持 NewIn20182