本入门教程使用的操作系统为ubuntu18.04
开发环境准备
在AS中新建一个项目,打开项目的File–>Settings–>Android SDK–>SDK Tool,下载安装CMake、LLDB、NDK。
创建一个支持C/C++的Android项目
打开项目的File–>New–>New Object…
创建过程一直Next下去,直到最后一步
项目创建成功后,项目自动创建了src/main/cpp目录和一个native-lib.cpp源文件,并在app/目录里生成CMakeLists.txt文件:
并且在Module:app的gradle里配置好了相关信息,如下图所示:
android {
compileSdkVersion 28
defaultConfig {
applicationId "com.wong.testjni"
minSdkVersion 19
targetSdkVersion 28
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
externalNativeBuild {
cmake {
cppFlags "-std=c++11" //配置C++标准
}
}
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
// 配置CMakeLists.txt路径
externalNativeBuild {
cmake {
path "CMakeLists.txt" // 设置所要编写的c源码位置,以及编译后so文件的名字
}
}
}
dependencies {
......
}
CMakeLists.txt文件的内容如下:
#设置CMake的最低版本构建本机所需库
cmake_minimum_required(VERSION 3.4.1)
# 创建并命名库,将其设置为静态的
# 或共享,并提供其源代码的相对路径。
# 你可以定义多个library库,并使用CMake来构建。
# Gradle会自动将包共享库关联到你的apk程序。
add_library( #设置so文件名称
native-lib
# 设置这个so文件为共享
SHARED
# 设置 c文件源码位置
src/main/cpp/native-lib.cpp )
# 搜索指定预先构建的库和存储路径变量。因为CMake包括系统库搜索路径中默认情况下,只需要指定想添加公共NDK库的名称,在CMake验证库之前存在完成构建
find_library( # 设置path变量的名称
log-lib
# Specifies the name of the NDK library that
# 在CMake定位前指定的NDK库名称
log )
# 指定库CMake应该链接到目标库中,可以链接多个库,比如定义库,构建脚本,预先构建的第三方库或者系统库
target_link_libraries( # 制定目标库
native-lib
# 目标库到日志库的链接 包含在NDK
# included in the NDK.
${log-lib} )
创建一个方法测试一下NDK环境
- 在MainActivity.java中增加一个native方法
public native String sayHelloJNI();
你会发现sayHelloJNI( )方法是红色的。但是,按Alt+Enter快捷键后,系统会自动在之前.cpp文件中创建一个sayHelloJNI( )的C++代码,如下所示:
extern "C"
JNIEXPORT jstring JNICALL
Java_com_wong_testjni_MainActivity_sayHelloJNI(JNIEnv *env, jobject instance) {
// TODO
return env->NewStringUTF("Hello android ,welcome to JNI world...");
}
可以看到,sayHelloJNI()方法在C++代码的方法名是所在的类的完整包名加上方法名组成的。
- 使用native方法,要先将so库引入,引入的方法,只须在要使用native方法的类里加入如下代码:
static {
System.loadLibrary("native-lib");
}
注:native-lib是在CMakeLists.txt文件里指定的。
- 在MainActivity.java中调用sayHelloJNI()方法:
public class MainActivity extends AppCompatActivity {
static {
System.loadLibrary("native-lib");
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
TextView tv = (TextView) findViewById(R.id.sample_text);
tv.setText(sayHelloJNI());
}
private native String sayHelloJNI();
}
至此,如果tv可以显示出"Hello android ,welcome to JNI world…",则说明NDK环境配置成功了。
其实在AS 3.0进行NDK开发已经很方便的了。只需要创建支持C/C++开发的项目就可以完成NDK
的环境搭建了。
定义一个包含native方法的类
package com.wong.testjni;
public class TestJNI {
public static native int init(Object obj);
public static native int deInit(int index);
}
-
在AS的Terminal中通过命令行的指令生成.h文件:
-
生成的.h文件在app/src/main/java下,将.h文件移到app/src/main/cpp目录下。
-
在app/src/main/cpp中新建一个.cpp的C/C++源文件,该文件中的方法名对应生成的.h文件中声明的
方法名,java层通过调用该文件中的方法达到调用C/C++中方法的目的,如.cpp源文件是TestJNI.cpp,如下所示:
#include <jni.h>
#include <string>
extern "C"
JNIEXPORT jint JNICALL
Java_com_wong_testjni_TestJNI_init(JNIEnv *env, jclass type, jobject cb) {
return 10;
}
extern "C"
JNIEXPORT jint JNICALL
Java_com_wong_testjni_TestJNI_deInit(JNIEnv *env, jclass type, jint index) {
return index;
}
- 在CMakeLists.txt文件里设置 TestJNI.cpp文件源码位置
cmake_minimum_required(VERSION 3.4.1)
add_library( # # 设置so文件名称.Sets the name of the library.
native-lib
# Sets the library as a shared library.
SHARED
# Provides a relative path to your source file(s).
src/main/cpp/TestJNI.cpp #设置 TestJNI.cpp文件源码位置
src/main/cpp/native-lib.cpp )
find_library( # Sets the name of the path variable.
log-lib
log )
target_link_libraries( # Specifies the target library.
native-lib
${log-lib} )
- 在MainActivity调用
public class MainActivity extends AppCompatActivity {
static {
System.loadLibrary("native-lib");
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
TextView tv = (TextView) findViewById(R.id.sample_text);
tv.setText(TestJNI.deInit(18)+"");
}
}
谢谢观赏!