Unity3D Android NDK编译C/C++结合Unity实现本地数据共享

最新推荐文章于 2025-05-07 17:18:10 发布

伟业

最新推荐文章于 2025-05-07 17:18:10 发布

阅读量1.5k

点赞数

分类专栏： Unity3D

Unity3D 专栏收录该内容

154 篇文章

订阅专栏

本文介绍如何利用Android NDK结合Unity3D实现本地数据共享。通过C/C++代码作为中间层，实现Java与C#之间的高效数据交互。文中详细讲解了从创建JNI文件、编译.so库到在Java及Unity中调用的具体步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

原创文章如需转载请注明：转载自雨松MOMO程序研究院本文链接地址:Unity3D研究院之Android NDK编译C/C++结合Unity实现本地数据共享（二十八）

开始本篇文章之前我先为大家简单的介绍一下Android NDK编程的原理，我们知道Android开发使用JAVA语言来编程它的运行效率要比C/C++低很多，为了让JAVA语言可以调用 C/C++ 这时候NDK就出现了，使用DNK可以很方便的实现 JAVA 与 C/C++之间的互相调用。NDK的工作原理是使用谷歌提供的NDK工具将C/C++的代码编译成 .so文件，最后使用JAVA代码与.so文件之间相互调用。下面我先说一下在Unity中结合Android NDK实现本地数据的共享的原理，如下图所示，Unity工程加入NDK后工程大致可分为三个部分 Android（JAVA）、 C/C++（.so）、Unity（C＃）它们之间是可以相互调用的，在之前的文章中我向大家介绍了 Android与Unity之间相互调用的原理，Unity3D研究院之打开Activity与调用JAVA代码传递参数（十八）。这种方式只能相互传递String字符串，少量数据传递时可以使用这种方式。如果是大量数据这样就有点限制了，其实我们可以把C/C++的代码做为一个中转站，实现两边的数据引用与共享。

首先在官网中下载NDK最新的安装包，安装包分为三个版本这里我下载使用的是MAC OS版本，最新版本已经到了R8。

下载地址：http://developer.android.com/sdk/ndk/index.html

OK，我们在Eclipse中创建一个Android工程，在res与src平级文件夹目录下创建一个jni的文件夹。接着在文件夹中创建两个代码文件，分别是C与C++还有一个配置文件Android.mk。

c.c代码一共分为两个方法，先说说方法Java_com_xys_UnityTestActivity_TestAddInt 这个方法是漏给Java代码调用的，jint表示此方法的返回值为整形，数据类型还可以是jlong 、jfloat、jdouble、 jobject、jboolean、jbyte、jchar、jshort，搞程序的一看就应该明白了吧？我就不一一解释了。方法名中java开头是标准用法，com_xys表示当前程序的包名，UnityTestActivity表示当前类，TestAddInt表示方法名，在Android中就是调用这个方法的，这个方法实现了一个简单的整形相加的操作。在说说第二个方法int addInt()，这个方法是留给Unity中C#语言调用的，它的结构与上面不一样不能在Java代码中调用，同样它也就是实现整形相加的操作。

先是C的文件 c.c

 
   01#include <string.h> 
 
   02#include <jni.h> 
 
   03  
 
   04//Android中java代码调用此方法 
 
   05jint 
 
   06Java_com_xys_UnityTestActivity_TestAddInt( JNIEnv* env, jobject thiz ,jint a,jint b) 
 
   07{ 
 
   08    return addInt(a,b); 
 
   09} 
 
   10  
 
   11//Unity中C#代码调用此方法 
 
   12int  addInt(int a, int b)  
 
   13{ 
 
   14    return a + b; 
 
   15}

在看看C++文件，它和C文件的调用原理差不多，不过值得注意的是C++中一定要把需要调用的方法写在extern “C”{ } 中，否则无法调用。

cplus.cpp

 
   01#include <string.h> 
 
   02#include <jni.h> 
 
   03  
 
   04//声明一个类 
 
   05class   MyClass 
 
   06{ 
 
   07    public: 
 
   08    static float add(float a, float  b) 
 
   09    {  
 
   10        return a + b; 
 
   11    }  
 
   12  
 
   13}; 
 
   14  
 
   15//外部调用的方法需要写在这里 
 
   16extern  "C"
 
   17{ 
 
   18  
 
   19    jfloat 
 
   20    Java_com_xys_UnityTestActivity_TestAddFloat( JNIEnv* env, jobject thiz ,jfloat a,jfloat b) 
 
   21    {  
 
   22        return MyClass::add(a,b); 
 
   23    }  
 
   24  
 
   25    float addFloat(float a,float  b) 
 
   26    {  
 
   27        return MyClass::add(a,b); 
 
   28    }  
 
   29  
 
   30}

再看看第三个配置文件，文件中比较重要的两个变量 LOCAL_MODULE表示生成出的.so的名称 LOCAL_SRC_FILES 表示需要编译的文件，如果是多个C/C++文件中间需要使用 \ 隔开。

Android.mk

 
   01LOCAL_PATH := $(call my-dir) 
 
   02  
 
   03include $(CLEAR_VARS) 
 
   04  
 
   05LOCAL_MODULE    := xuanyusong  
 
   06LOCAL_SRC_FILES := \ 
 
   07c.c \ 
 
   08cplus.cpp 
 
   09  
 
   10include $(BUILD_SHARED_LIBRARY)

OK ，此时C/C++代码的准备工作就做完了，下面我们学习如何把c.c 与 cplus.cpp 一个C文件与一个C++文件一同打包进.so文件中。首先打开终端，cd到刚刚创建的jni目录下，然后执行一开始下载的DNK开发包中的ndk-build命令，你可以直接在android-ndk-r8中找到ndk-build然后拖拽到终端中即可，如果代码没有错误如图所示表示.so文件编译成功。

再看看当前Android工程的目录结构，libs -> armeabi -> libxuanyusong.so 就是刚刚编译生成的.so文件，xuanyusong.so前面的lib是系统默认添加的，大家不必惊慌。

下面我们编写Java代码，学习如何在java代码中调用C/C++，代码比较简单在OnCreat()方法中分别调用C与C++的方法，并且弹出一个Toast显示在界面中。

UnityTestActivity.java

 
   01package  com.xys; 
 
   02  
 
   03import  android.os.Bundle; 
 
   04import  android.widget.Toast; 
 
   05  
 
   06import  com.unity3d.player.UnityPlayerActivity; 
 
   07  
 
   08public  class UnityTestActivity extends UnityPlayerActivity 
 
   09{ 
 
   10  
 
   11    @Override
 
   12    public void onCreate(Bundle savedInstanceState) 
 
   13    {  
 
   14        super.onCreate(savedInstanceState); 
 
   15  
 
   16        //在这里调用.so中的两个方法，并且显示在屏幕中 
 
   17        Toast.makeText(getApplicationContext(), "整形  = " + TestAddInt(1,2)+" 浮点型 = " + TestAddFloat(1.5f, 1.1f), 
 
   18                 Toast.LENGTH_LONG).show(); 
 
   19  
 
   20    }    
 
   21  
 
   22    //声明c.c中的TestAddInt方法 
 
   23    public native  int  TestAddInt(int  a, int b);    
 
   24  
 
   25    //声明cplus.cpp中的TestAddFloat方法 
 
   26    public native  float TestAddFloat(float a, float  b);   
 
   27  
 
   28    static
 
   29    {  
 
   30        //加载.so文件 
 
   31        System.loadLibrary("xuanyusong"); 
 
   32    }    
 
   33  
 
   34}

好的，我们终于把Android的工程建立完毕。接着我们需要把工程拷贝至Unity的Android插件中，插件的制作还有谁不会？？不会的朋友请看之前的文章，这里就不赘述。如下图所示，Android插件已经制作完毕放在Unity中。目录结构如下所示。

编写test.cs脚本，实现通过C＃脚本直接访问libxuanyusong.so文件，直接把test.cs挂在摄像机上。使用[DllImport ("xuanyusong")]来引入.so 的方法，这里注意的是一定要把.so文件名的lib 与后缀.so去掉，最后将数据通过GUI显示在屏幕中。

test.cs

 
   01using  UnityEngine; 
 
   02using  System.Collections; 
 
   03using  System.Runtime.InteropServices; 
 
   04public  class test : MonoBehaviour { 
 
   05  
 
   06    int i = 0 ; 
 
   07    float f = 0.0f; 
 
   08  
 
   09    //引用C 、C++中的方法 
 
   10    [DllImport ("xuanyusong")] 
 
   11    private static extern int addInt(int a,int  b); 
 
   12    [DllImport ("xuanyusong")] 
 
   13    private static extern float addFloat(float a,float  b);   
 
   14  
 
   15    void Start () 
 
   16    {  
 
   17        //调用方法中相加函数 
 
   18        i = addInt (1,2); 
 
   19        f = addFloat (1.0f,2.2f); 
 
   20  
 
   21    }  
 
   22  
 
   23    void OnGUI() 
 
   24    {  
 
   25  
 
   26        //将相加后的信息显示在屏幕中 
 
   27        if(i !=0) 
 
   28        GUILayout.Label(" use  c  =" +  i ); 
 
   29  
 
   30        if(f !=0.0f) 
 
   31        GUILayout.Label(" use  cplus  =" +  f ); 
 
   32    }  
 
   33}