Android Studio NDK开发（二）：Welcome to JNI

前言

现在我们从零开始NDK开发，本篇博客将介绍如何创建一个native方法，并在Activity中调用。如果大家对于NDK开发的配置不了解的话，可以查看：
Android Studio NDK开发（一）：NDK开发准备工作（CMake方式）

Welcome to JNI

1.新建c文件

这里我们不使用Android Studio默认创建的C/C++文件native-lib.cpp，鼠标点击cpp文件夹(如果没有可在main文件夹下新建)，右击new -> C/C++ Source File，输入文件名zhangpan(可自定义)，type我选的是.c，点击ok，然后就可以看见cpp文件夹下生成了zhangpan.c文件，此时该文件顶部是有提示文字的，提醒你去配置CMakeLists。

2.配置CMakeLists.txt

在CMakeList（如果没有可在app下新建）中添加：

add_library( # Sets the name of the library.
             zhangpan

             # Sets the library as a shared library.
             SHARED

             # Provides a relative path to your source file(s).
             src/main/cpp/zhangpan.c)

target_link_libraries( # Specifies the target library.
                       zhangpan

                       # Links the target library to the log library
                       # included in the NDK.
                       ${log-lib} )

点击Snyc Now，以上就将添加了自己写的库，并将自己的库与NDK中的库进行连接。

3.配置build.gradle

如果新建工程的时候，已经勾选了include C/C++ support，这里就已经生成了，可跳过。如果没有，可在app下的build.gradle如下添加。
在android下defaultConfig下添加：

externalNativeBuild {
            cmake {
                //默认是cppFlags ""
                //如果要修改Customize C++ support部分，可在这里加入
                cppFlags ""
            }
        }

再在android下添加：

externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
        }
    }

4.native方法的声明

我在MainActity中声明了一个native方法（可自定义）

public native String getStringFromJNI();

这里我做的就是Java中调用C的函数，从而返回一个字符串，并展示在界面中。
光标定位在getStringFromJNI中，Alt + Enter选中第一个，创建native函数。

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

JNIEXPORT jstring JNICALL
Java_com_zhangpan_myjnicmake_MainActivity_getStringFromJNI(
    JNIEnv *env,
    jobject jobj) {
    //JNIEnv 结构体指针
    //env二级指针(对应c，在C++是一个结构体的一级指针)，由于需要用到JNIEnv变量，而JNIEnv是结构体指针，需要一个变量来表示JNIEnv，所以这个变量就是二级指针，而C++中有this关键字的，直接可以表示
    //每个native函数，都至少有两个参数(JNIEnv*，jclass或者jobject)
    //1.当native方法为静态方法时，jclass代表native方法所属类的class对象(MainActivity.class)
    //2.当native方法为非静态方法时，jobject代表native方法所属类的对象
    return (*env)->NewStringUTF(env, "Welcome to JNI");
}

注意：
（以下所述，方法代表Java中的方法，函数代表C/C++中的函数）
1.添加头文件jni.h（用于关联Java和C/C++）和stdlib.h
2.JNIEXPORT jstring JNICALL中jstring是函数的返回值，其余两个可不用管，类似于Java中的关键字作用。
3.点击参数中的JNIEnv进入jni.h中，可以看出JNIEnv是一个结构体指针，因此env就是一个二级指针，记住这里是C的代码，如果是C++，这里的env只是一个结构体的一级指针。有人可能会问，为什么在C和C++中会不一样呢，这是因为C++中已经有了this关键字了，而C中是不存在的，而这里又需要用到JNIEnv的变量，所以为了表示它，在C中就有了env这个二级指针。其实C++中虽然传入了this关键字，但是其函数内部还是调用了C的代码，也就是说C++在C的基础上还封装了一层。
4.每个native函数都至少有两个参数JNIEnv*，jclass或者jobject。
5.当native方法为静态方法时，jclass代表native方法所属类的class对象(MainActivity.class)；
当native方法为非静态方法时，jobject代表native方法所属类的对象。

5.MainActivity

添加静态代码块，加载自己写的库，调用并展示在TextView中。

/**
     * A native method that is implemented by the 'native-lib' native library,
     * which is packaged with this application.
     */
    public native String getStringFromJNI();
    
    // Used to load the 'native-lib' library on application startup.
    static {
        System.loadLibrary("zhangpan");
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        TextView tv = (TextView) findViewById(R.id.sample_text);
        tv.setText(getStringFromJNI());
    }

点击运行

1.png

展望

Welcome to JNI已经完成，也知道了Java是如何调用C/C++中的函数的，但是我们是不是存在疑问，比如jstring到底是什么，C/C++怎样访问Java中的属性和方法呢？请看接下来的博客。