封面
本文主要讲解了在 Windows 环境下如何使用 ndk-build 构建工具来进行 NDK 开发,以及 ndk-build 构建工具在 Android Stuido 中的快捷工具配置.
在上一篇文章 《Android NDK 开发(一) 使用 CMake 构建工具进行 NDK 开发》 中,我们学习了如何使用 CMake 构建工具来进行 NDK 开发,但是一些老项目还是使用的 ndk-build 构建工具进行开发的,今天我们就来学习一下如何使用 ndk-build 构建工具.
1. 环境搭建
在 SDK Tools 中安装 NDK 开发环境(File > Settings > Appearance & Behavior > System Settings > Android SDK > SDK Tools):
安装 NDK 开发环境
新建一个普通的 Android 项目,在 main 目录下新建 jni 目录,在此目录下编写原生代码:
新建 jni 目录
在 main 目录下新建 jniLibs 目录,此目录为 Android Stuido 加载 so 文件的默认目录,看下项目结构:
项目结构
2. 快捷键配置
打开 File > Settings > Tools > External Tools 选项,点击[+] 按钮添加生成 jni 头文件以及 ndk-build 命令的快捷工具:
生成头文件
生成头文件
Name:javah-jni 工具名称
Program:$JDKPath$/bin/javah javah 所在的路径,$JDKPath$ 代表在环境变量中配置的 JDK 路径.
Parameters:-jni -encoding UTF-8 -d $ModuleFileDir$\src\main\jni $FileClass$ 命令参数:
-jni 代表生成 JNI 样式的标头文件,文件名为当前包名 + 类名($FileClass$)
-encoding 代表编码格式为 UTF-8
-d 代表指定头文件的输出路径为 jni 目录($ModuleFileDir$\src\main\jni )
Working directory:$ModuleFileDir$\src\main\java 工作目录,$ModuleFileDir$ 为当前 module 的路径.
javah用法:
javah [options] <classes>
其中, [options] 包括:
-o <file> 输出文件 (只能使用 -d 或 -o 之一)
-d <dir> 输出目录
-v -verbose 启用详细输出
-h --help -? 输出此消息
-version 输出版本信息
-jni 生成 JNI 样式的标头文件 (默认值)
-force 始终写入输出文件
-classpath <path> 从中加载类的路径
-cp <path> 从中加载类的路径
-bootclasspath <path> 从中加载引导类的路径
<classes> 是使用其全限定名称指定的
(例如, java.lang.Object).
NDK 构建
NDK 构建
ndk-build 的配置和 javah-jni 类似,其中 C:\Tools\NDK\android-ndk-r14b\ndk-build.cmd 为 ndk-build 构建工具的路径,需要按照实际 NDK 安装路径进行修改.
如何调用
右击项目选择 External Tools:
使用快捷工具
3.NDK 开发
准备工作都做完了,下面进入正题,看下 MainActivity:
public class MainActivity extends AppCompatActivity {
// 加载native-lib,不加lib前缀
static {
System.loadLibrary("native-lib");
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 将获取的字符串显示在TextView上
TextView tv = findViewById(R.id.sample_text);
tv.setText(stringFromJNI());
}
/**
* native-lib中的原生方法
*/
public native String stringFromJNI();
}
首先加载 native-lib 库,然后调用其中的 stringFromJNI 方法,将其返回的字符串显示在 TextView 上,此时还没有 native-lib 库,别急,继续往下看:
对着 MainActivity 的类名右击鼠标,选择 External Tools > javah-jni,控制台执行完命令后,会在 jni 目录生成一个头文件:
生成头文件
看下生成的头文件:
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_yl_ndkdemo_MainActivity */
#ifndef _Included_com_yl_ndkdemo_MainActivity
#define _Included_com_yl_ndkdemo_MainActivity
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: com_yl_ndkdemo_MainActivity
* Method: stringFromJNI
* Signature: ()Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_yl_ndkdemo_MainActivity_stringFromJNI
(JNIEnv *, jobject);
#ifdef __cplusplus
}
#endif
#endif
可以看到第一行注释写到:这是自动生成的,不要去修改它.好,不改就不改,Go on:
在 jni 目录中新建 cpp 类 native-lib.cpp:
#include "com_yl_ndkdemo_MainActivity.h"
JNIEXPORT jstring JNICALL Java_com_yl_ndkdemo_MainActivity_stringFromJNI
(JNIEnv *env, jobject) {
return env->NewStringUTF("Hello from C++");
}
引用上文中生成的头文件,返回一个字符串给 Java 层,方法名是通过 Java_包名类名方法名 的方式命名的.
接着在 jni 目录下创建 Android.mk 和 Application.mk 配置文件,分别来看看:
Android.mk
# 当前路径
LOCAL_PATH := $(call my-dir)
# 清除LOCAL_XXX变量
include $(CLEAR_VARS)
# 原生库名称
LOCAL_MODULE := native-lib
# 原生代码文件
LOCAL_SRC_FILES =: native-lib.cpp
# 编译动态库
include $(BUILD_SHARED_LIBRARY)
在 app 的 build.gradle 文件中关联 Android.mk:
android {
...
externalNativeBuild {
ndkBuild {
path 'src/main/jni/Android.mk'
}
}
}
相当于执行了[Link C++ Project with Gradle] :
在 Gradle 配置中关联 C++ 项目
Application.mk
# 原生库名称
APP_MODULES := native-lib
# 指定机器指令集
APP_ABI := armeabi armeabi-v7a arm64-v8a x86 x86_64 mips mips64
到这里基本的开发流程就已经完成了,运行程序看下效果:
运行效果
分析一下 APK 文件,可以看到 so 文件已经打包进去了:
分析 APK 文件
4. 编译 so 文件
对着 jni 目录右击鼠标,选择 External Tools > ndk-build,会在 main 目录下生成 libs 和 obj 目录,编译出的 so 文件就在 libs 目录下:
编译 so 文件
将 so 文件拷贝到 jniLibs 目录下就可以正常使用了,也可以在 app 的 build.gradle 文件中设置 so 文件的路径.
注意:编译出的 so 文件就相当于 java 中的 jar 包,上文中的 jni 就相当于 library,两者不要重复使用.
5. 遇到的问题
在 ndk-build 的过程中遇到了下面这行警告,但是没有影响编译 so 文件,没有找到好的解决方法,有知道的同学可以留言告诉我,多谢!
Android NDK: WARNING: Unsupported source file extensions in jni/Android.mk for module native-lib
5. 写在最后
源码已经上传到 GitHub 上了,欢迎 Fork,觉得还不错就 Start 一下吧!
GitHub 传送门
来源: http://www.jianshu.com/p/45fdcb2e7a89