Android：JNI调用C++自定义类的详细方法

一般情况下，我们都是用 JNI 调用 C++ 的某个方法的代码，包括直接使用 android studio 生成的代码也是如此。但有时我们需要新建、或者得到的是 C++ 的一个自定义类，在调用时就不能像调用 C++ 方法那样了，查阅了一部分其他人的博客，写的都比较笼统、模糊，对没接触过这块知识的人来说很不友好，故参考了几篇较好的博客，以下介绍具体使用方法。

1.创建JNI工程 

为了方便，可以让系统帮我们自动生成一个 CMakeLists.txt 文件，以及加载本地库的代码。在创建 android 工程时，勾选页面下方的 “include C++ support” 选项，后面的按照默认的选项一直点击 next 就可以。 

我们此次使用 C++ 类的目的是使用 C++ 对象的一些方法，为了简化，我们拟创建一个 Person 对象，并调用它的设置、获取年龄的方法。

2.创建java类

新建一个 java 类，名称为 JniPerson，并编写我们需要的功能，我们需要将此类与 C++ 代码产生联系，我们可以通过传递对象的地址来实现。也就是说，如果我们可以在 java 中持有一个 C++ 对象，首先要设法调用该对象的构造函数，开辟一块内存，产生一个对象，然后再把这个对象存在的地址记录到 java 对象里面，这样下次就可以通过这个地址来找到 C++ 的对象了。 此处我们用一个 long 型数值作为指针。 然后我们要有一个函数来创建本地对象并且返回它的地址，代码如下：

public class JniPerson {
    //保存c++类的地址
    long nativePerson;
    //构造函数
    public JniPerson(){
        nativePerson = createNativeObject();
    }
    public void setAge(int age){
        setAge(nativePerson,age);
        return;
    }
    public int getAge(){
        return getAge(nativePerson);
    }
    /**本地方法：创建c++对象并返回地址*/
    private native long createNativeObject();
    private native void setAge(long addr,int age);
    private native int getAge(long addr);
}

 

下面的 native 方法在刚刚创建时，是标红的，先不理会，我们在下一步解决。上方的public方法为java类自身的方法，其函数体调用了下方定义的native方法。

3. 添加C++类

对于系统自动生成的那个在 cpp 文件夹下的 native-lib.cpp 文件，先不理会。我们可以将自己的 C++ 类导入到这个 cpp 文件夹下。当然也可以自己创建，这里，我们新建一个 C++ 类，在 cpp 文件夹上点鼠标右键，选择 new->C++ class，在弹出的对话框中输入自定义 C++ 类的名称，此处我们填写 Person，点击OK，系统会帮我们创建 Person.cpp 文件和 Person.h 文件，修改 Person.h 文件为以下内容：

#ifndef CPPJNITEST_PERSON_H
#define CPPJNITEST_PERSON_H

class Person {
private:
    int age;
public:
    Person();
    int getAge();
    void setAge(int age);
};

#endif //CPPJNITEST_PERSON_H

 

接着我们修改 Person.cpp 为以下内容：

#include "Person.h"
#include <jni.h>

extern "C"
JNIEXPORT jlong JNICALL
Java_com_example_lcq_cppjnitest_JniPerson_createNativeObject(JNIEnv *env, jobject obj) {
    jlong result;
    result =(jlong) new Person();
    return result;
}

extern "C"
JNIEXPORT void JNICALL
Java_com_example_lcq_cppjnitest_JniPerson_setAge(JNIEnv *env, jobject obj, jlong addr, jint age) {
    //对象指针调用方法
    ((Person*)addr)->setAge(age);
}

extern "C"
JNIEXPORT jint JNICALL
Java_com_example_lcq_cppjnitest_JniPerson_getAge(JNIEnv *env, jobject obj, jlong addr) {
    return ((Person*)addr)->getAge();
}


int Person::getAge() {
    return this->age;
}

void Person::setAge(int age) {
    this->age = age;
}

Person::Person() {

}

 

这样，我们一方面实现了 Person.h 中的方法，另一方面实现了在上一个步骤中标红的为实现的 native 代码。对于代码中那串长长的函数名，有个简便的生成方法：可以在之前创建的 JniPerson 类中，将鼠标定位在标红的 JNI 方法后，按 Alt+Enter，会提示创建 JNI 方法，这样就直接可以生成那一串长长的函数名，再将这串函数名复制过来用就行（有时会在函数名后加一些额外的字符，将额外字符删除即可）。

 - createNativeObject 函数用于创建对象，并将所创对象的地址返回，便于与 java 建立联系。

 - setAge、getAge方法中，参数 addr 即为 createNativeObject 返回的 long 类型的地址，可以通过 java 将这个地址传进 C++ 中，利用 (Person*)addr，将 addr 强制转换为指向当初创建的对象的指针，然后就可以调用该对象的”自带“方法了。

 - 最下面的几个方法，则是实现了 Person.h 中申明的方法。

4.修改CMakelists.txt文件

由于系统已经帮我们创建了这个文件，所以省去了我们很多事情，直接在add_library那儿，把我们自定义的Person.cpp添加进去就可以了，原来的native-lib.cpp，可以删掉。

5.函数调用

在MainActivity中，我们创建java对象JniPerson，并调用它的方法，它的方法再去调用C++类的方法。

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        JniPerson mJniPerson = new JniPerson();
        mJniPerson.setAge(68);
        String mAge =  mJniPerson.getAge() + "";

        TextView tv = (TextView) findViewById(R.id.sample_text);
        tv.setText(mAge);
    }

这样，整个调用过程就结束了。

---

源码下载地址：

https://download.csdn.net/download/chaoqiangscu/10715696 （最低只能设置1分，麻烦有积分的就用这个下载吧，没有积分的可以用下面的另一个链接。谢谢！）

https://github.com/chaoqiangscu/CppJNITest