NDK开发的两种方式
- ndk-build 形式:Android Studio 2.2之前的模式,通过.mk后缀文件里面的内容编译C,C++代码
- CMake 形式: CLion C/C++编辑器; AS2.2之后整合了CLion代码, AS就支持了CMake形式的NDK开发
一,ndk-build方式
创建Android工程
这个就不用说了
创建含有Native方法的类
如:
里面有一个Native方法,然后你没有编写C或C++源码时,方法会爆红
创建jni接口
如果需要头文件,这里有两种方式创建
- 先编译模块或工程,生成字节码,然后在字节码文件(如下图)所在包执行javah
- 完全自己手动建头文件,不过这样要知道里面的声明规则
这里我讲第一种方式,因为方便快捷
比如命令:javah com.newtrekwang.myndkprac.NdkJniUtils 后面的格式就是包名加类名,执行后会生成一个头文件 这个头文件会根据类里定义的Native方法生成方法模板,我的这个就是这样子,里面有个对应的getString方法,头文件里面都是声明,有点像Java里的接口
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_newtrekwang_myndkprac_NdkJniUtils */
#ifndef _Included_com_newtrekwang_myndkprac_NdkJniUtils
#define _Included_com_newtrekwang_myndkprac_NdkJniUtils
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: com_newtrekwang_myndkprac_NdkJniUtils
* Method: getString
* Signature: ()Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_newtrekwang_myndkprac_NdkJniUtils_getString
(JNIEnv *, jclass);
#ifdef __cplusplus
}
#endif
#endif
编写C/C++源码
在main文件夹下创建jni文件夹,然后创建Android.mk,test.c文件,也把上面的头文件放进去,我的test.c源码如下,主要是实现头文件里面声明的函数,记得导入你需要的头文件
#include <jni.h>
#include "com_newtrekwang_myndkprac_NdkJniUtils.h"
#include <stdio.h>
#include <android/log.h>
#include <sys/system_properties.h>
#define TAG "NDK_NATIVE"
JNIEXPORT jstring JNICALL Java_com_newtrekwang_myndkprac_NdkJniUtils_getString
(JNIEnv *env, jclass obj){
return (*env)->NewStringUTF(env,"hello NDK");
};
可以看到里面实现了getString函数,我这里最后返回了“hello NDK”
然后Android.mk里面内容如下:
# Android.mk 文件必须首先定义 LOCAL_PATH 变量,此变量表示源文件在开发树中的位置。
# 在这里,构建系统提供的宏函数 my-dir 将返回当前目录(包含 Android.mk 文件本身的目录)的路径。
LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE:= MyNative
LOCAL_SRC_FILES:= test.c
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)
LOCAL_LDLIBS+= -llog
include $(BUILD_SHARED_LIBRARY)
LOCAL_MODULE是生成链接库文件的名字
LOCAL_SEC_FILES指定源码文件
其它的可以查查,一般是默认
gradle配置NDK
首先android块里添加一个externalNativeBuild块
externalNativeBuild{
ndkBuild{
// 指定构建脚本路径
path "src/main/jni/Android.mk"
}
}
然后在android块的defaultConfig块里添加ndk块
ndk{
//设置库(so)文件名称
moduleName "MyNative"
//声明启用Android日志, 在c/c++的源文件中使用的#include <android/log.h> 日志将得到输出
// ldLibs "log"//实现__android_log_print
ldLibs "log", "android", "EGL", "GLESv1_CM"
// 声明创建指定cpu架构的so库, 不声明的话, 默认(gradle 1.5.0)会生成4中架构 多一种mips架构
abiFilters "armeabi", "armeabi-v7a", "x86"
}
编译并运行
这里在一个界面显示来自C代码返回的hello ndk字符串
public class MainActivity extends AppCompatActivity {
TextView textView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
textView= (TextView) findViewById(R.id.tv);
textView.setText(NdkJniUtils.getString());
}
}
结果
编译过后,我们可以在模块的build.intermediates.ndkBuild里找到编译出的so库文件,这个是debug模式下,release模式我还没试
二,使用Cmake
创建工程
这里如果勾选include C++ support,然后一路next下去,IDEA会在工程目录下自动创建一些文件和配置
和普通工程有什么不同
不同的地方就在于图中三个红框地方,cpp肯定是放C,c++源码的,build.gradle里肯定有关于ndk配置的脚本,CMakeList.txt就和第一种方式的Android.mk功能一样,配置C,c++编译的
build.gradle具体
android {
compileSdkVersion 25
buildToolsVersion "25.0.3"
defaultConfig {
applicationId "com.newtrekwang.ndktest"
minSdkVersion 18
targetSdkVersion 25
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
externalNativeBuild {
cmake {
cppFlags ""
}
}
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
externalNativeBuild {
cmake {
path "CMakeLists.txt"
}
}
}
可以看到android块里多了两个externalNativeBuild块,为毛有两个?我试过把下面那个和上面那个合在一起,但是不行,估计是作用域的限制,一些配置必须在某些块里才起作用,现在很明显下面那个externalNativeBuild是指定Cmake脚本文件路径的,这里我总结了下,可能指定文件位置这些配置,都需要放这个位置才可以,上面那个Cmake的cppFlag我也不知道是啥,可以查吧,反正是Cmake的
CMakeList.txt具体
# 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.4.1)
# 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.
add_library( # 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/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.
native-lib
# Links the target library to the log library
# included in the NDK.
${log-lib} )
里面有三个Cmake脚本函数
- cmake_minimum_required (VERSION 版本号):指定cmake编译最低版本,如VERSION 2.8
- add_library(生成库目标名 生成库类型(STATIC|SHARED) 库原文件列表):项目添加(或生成)库文件,可以为静态库或动态库;
- find_library可以添加NDK里面现成的API库,比如这里的log
- 使用 target_link_libraries() 命令,将预构建库与你本地库相关联
具体Cmake配置可以参考这位大哥的文章 在 Android Studio 2.2 中愉快地使用 C/C++