AndroidStudio使用NDK配置方法
配置Gradle生成so
在AndroidStudio2.1及以前我是通过下面的方式配置NDK的,不知道是从哪个版本开始的,我第一次在AS上使用NDK的时候用的就是AndroidStudio2.1了。
首先在gradle.properties里面添加 android.useDeprecatedNDK = true
android{}下的defaultconfig{}代码块中添加ndk{}
ndk{
moduleName = "xxx"
//abiFilters("armeabi", "armeabi-v7a"..)
//ldLibs = ["log"]
//cFlags
//stl(ie:gnustl_shared,stlport_static..)
}
默认在src/main/jni目录下面找c/c++文件编译,也可以在android{}下添加sourceSet{}
sourceSet{
main{
jni.srcDirs=['src/main/cpp']
}
}
就能将指定目录下的c/c++文件编译成指定的模块名.so。
编译多个模块
上面这种方式通过gradle无法编译成多个模块,编译多个模块还是要自己写Android.mk文件实现,通过手动执行ndk-build编译成的*.so文件默认在src/main/libs下面。
打包APK时,默认是寻找so的目录是/build/intermediates/ndk和/build/intermediates/jniLibs,前者是使用源码由Gradle编译成的so所处的位置,后者一般是一些第三方的so或者自己手动使用ndk编译生成的so文件所生成的,这个位置在src/main/jniLibs。
因此手动编译好so文件后,将其复制到jniLibs下面,或者在此放置第三方so,或者在build.gradle文件里面的android下面添加jniLib.srcDir定义了Gradle在哪里寻找生成的so库文件
sourceSets{
main{
jniLib.srcDirs=['src/main/libs'] // jniLib.srcDirs定义了Gradle在哪里寻找生成的so库文件
}
}
上面就是使用ndk-build通过自己定义Android.mk生成so的方式,但是分析apk文件(build->Analyze APK)发现打包进去来了两个so,下面libnative-lib.so是我在Android.mk中设置的模块名。上面这个其实是Gradle构建的,Gradle构建so的时候默认模块名字就是app,并且默认的编译c/c++的路径是src/main/jni,要修改这两个默认设置就需要像上面配置Gradle构建so的方式修改。
为了在我们自己构建so的时候禁用Gradle需要做的是配置jni.srcDirs设置成一个空的数组,这样就可以禁用通过Gradle来编译本地c/c++代码。
sourceSets{
main{
jni.srcDirs=[] // jni.srcDirs禁用通过Gradle来编译本地c/c++代码
}
}
再看apk结构,由Gradle构建的so就不见了。
关联Android.mk到Gradle
AndroidStudio2.2以后的另一种使用Android.mk的方式,可以不用ndk-build手动构建。
不需要手动使用ndk-build编译,只需要将其关联到Gradle上,Gradle 会将 ndk-build作为一个依赖运行,然后将so打包到 apk 中,编译好的so在目录/build/intermediates/ndkBuild下面。
鼠标右键要链接的本地库所在的模块,选择Link C++ Project with Gradle,在弹出的对话框中选择Build System为ndk-build,再指定Amdroid.mk的路径点击ok即可
这样就不用在命令行中手动执行ndk-build编译了,Gradle就会自动的构建写好的Android.mk。
上面的操作实际是也可以直接在该模块的build.gradle中的android下面添加
android {
...
defaultConfig {...}
buildTypes {...}
// add manually
externalNativeBuild {
ndkBuild {
path "Android.mk"
// arguments "-DCMAKE_VERBOSE_MAKEFILE=TRUE"
// Sets optional flags for the C compiler.
// cFlags "-D_EXAMPLE_C_FLAG1", "-D_EXAMPLE_C_FLAG2"
// Sets a flag to enable format macro constants for the C++ compiler.
// cppFlags "-D__STDC_FORMAT_MACROS"
}
}
}
使用cmake
AndroidStudio2.2以后还推出了使用cmake脚本来构建so,方式为在模块根目录下创建CMakeLists.txt
# Sets the minimum version of CMake required to build your native library.
# This ensures that a certain set of CMake features is available to
# your build.
cmake_minimum_required(VERSION 3.4.1)
# Specifies a library name, specifies whether the library is STATIC or
# SHARED, and provides relative paths to the source code. You can
# define multiple libraries by adding multiple add.library() commands,
# and CMake builds them for you. When you build your app, Gradle
# automatically packages shared libraries with your APK.
add_library( # Specifies 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/jni/native-lib.c )
然后和上面关联ndk-build脚本的方式类似,在弹出的对话框中选择Build System为cmake,再指定CMakeLists.txt的位置。这样操作类似与直接在该模块的build.gradle中的android下面添加
android {
...
defaultConfig {...}
buildTypes {...}
// add manually
externalNativeBuild {
cmake {
path "CMakeLists.txt"
}
}
}
脚本语法