JNI开发笔记(三)--JNI工程的框架分析

JNI工程的框架分析

引
1. JNI工程的组成部分
2. 各个部分之间的关系

引

JNI开发笔记(一)–Android Studio安装与环境搭建
JNI开发笔记(二)–创建JNI基础工程并运行

1. JNI工程的组成部分

Android Studio 4.0以后的版本可以直接建立JNI的基础工程并且可以直接运行，这个在JNI开发笔记(二)中已经实现，这篇文章就重点讲述一下JNI工程的组成部分以及各个部分之间的关系。

如下图所示，Android Studio自带的JNI模板工程中最重要的三个文件是红框中的部分：MainActivity, CMakeLists.txt, native-lib.cpp。

下面来讲一下这三个文件都是负责干什么的：

MainActivity
该文件是.java文件，是JNI工程的主函数文件，相当于C/C++中的main文件，相关语句的注释已经标注在代码中。

public class MainActivity extends AppCompatActivity {// Used to load the 'native-lib' library on application startup.// 这里是用来导入我们native-lib, 这样才可以调用我们native-lib.cpp中的函数static {System.loadLibrary("native-lib");}@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);// Example of a call to a native method// 在手机上显示一块文本的区域，区域显示的内容是"Hello from C++"TextView tv = findViewById(R.id.sample_text);tv.setText(stringFromJNI());}/*** A native method that is implemented by the 'native-lib' native library,* which is packaged with this application.*/// 这里声明了一个native方法，这个方法在我们的native-lib.cpp中定义的，该方法的效果就是输出一个字符串"Hello from C++"public native String stringFromJNI();
}

CMakeLists.txt
CMakeLists.txt编译c或者c++代码的时候的一个脚本文件，它的作用是将.c/.cpp和.h文件编译到我们的JNI工程中，这样我们就可以在JNI里面调用相应的函数。在这个文件里，官方的基础例程已经完成了绝大所数操作，我们只需要修改我们的so库的名字，添加我们自己的.c/.cpp和.h文件就可以了。相关的注释已经标注在代码中，为了看着明显，我使用了//而不是#。

# For more information about using CMake with Android Studio, read the
# documentation: https://d.android.com/studio/projects/add-native-code.html# Sets the minimum version of CMake required to build the native library.cmake_minimum_required(VERSION 3.10.2)# Declares and names the project.project("test")# Creates and names a library, sets it as either STATIC
# or SHARED, and provides the relative paths to its source code.
# You can define multiple libraries, and CMake builds them for you.
# Gradle automatically packages shared libraries with your APK.// 这里是对JNI库的添加
add_library( # Sets the name of the library.// 这里我们可以更改JNI库的名字，比如可以改成 JniTest-lib 等native-lib# Sets the library as a shared library.// 在SHARED后面我们需要添加我们自己的.c/.h文件，这样才可以把源文件编译进去SHARED# Provides a relative path to your source file(s).// 这里添加的是native-lib.cpp，建议不要更改native-lib.cpp )# Searches for a specified prebuilt library and stores the path as a
# variable. Because CMake includes system libraries in the search path by
# default, you only need to specify the name of the public NDK library
# you want to add. CMake verifies that the library exists before
# completing its build.find_library( # Sets the name of the path variable.log-lib# Specifies the name of the NDK library that# you want CMake to locate.log )# Specifies libraries CMake should link to your target library. You
# can link multiple libraries, such as libraries you define in this
# build script, prebuilt third-party libraries, or system libraries.target_link_libraries( # Specifies the target library.// 如果之前更改了名字，我们需要在这里同步一下，比如改成JniTest-libnative-lib# Links the target library to the log library# included in the NDK.${log-lib} )

native-lib.cpp
native-lib.cpp这个文件是我们需要主要修改的文件。这个文件的作用就是将C/C++中的函数接口封装到Java中来，Android Studio自带的JNI工程中， native-lib.cpp中的函数stringFromJNI()是直接实现的，并没有体现出这个文件的真正作用。当我们有大量的C/C++文件时，我们需要将接口在这个文件中做一个封装，变成Java可以识别的样子，这样Java就可以识别到这个封装好的接口，并通过它来调用C/C++中的函数。

#include <jni.h>
#include <string>extern "C" JNIEXPORT jstring JNICALL
Java_com_jni_test_MainActivity_stringFromJNI(JNIEnv* env,jobject /* this */) {std::string hello = "Hello from C++";return env->NewStringUTF(hello.c_str());
}

2. 各个部分之间的关系

JNI工程最主要的三个文件MainActivity, CMakeLists.txt, native-lib.cpp之间的关系如下图所示，CMakeLists和native-lib两个文件和生成的so库紧密相关，而MainActivity只是通过调用二者生成的so库来使用。换句话说，如果我们要生成so库给java用，只需要编写CMakeLists和native-lib两个文件即可，我们在MainActivity中实现的一般是调用这个so库来做测试的功能。下一篇JNI开发笔记(四)会通过一个简单的JNI实例来进一步凸显这个关系。