这篇文章来说说ndk的使用方法,其实主要是关于ndk的一些编译选项的研究和翻译(其实人家google的文档已经说的很清楚了)。偶选用的测试环境是 slackware 12.0 + android 1.5 r1 for linux + jdk 1.6.0_12,ndk选用的是android 1.5 ndk r1这个版本的(直接解压就行,免安装的)。
1、从ndk安装说起
ndk安装的时候需要运行一 个~/android-ndk-1.5_r1/build/目录下面的一个叫做host-setup.sh的脚本。大略读了一下这个脚本,发现这个主要是 用来生成out/host/host/config.mk文件的。主要用于指定用户操作系统的判断以及支持的编译器类型(设置makefile中的 cc,ar,ld之类的变量)
ndk的目录介绍。
2、ndk的目录结构分析
进入android-ndk-1.5_r1目录,看到如下目录结构:
GNUmakefile: 标准的makefile格式的文件,用于引用build/core/main.mk的编译脚本。
README.TXT:基本的说明,没啥大用,真正有用的文档都在docs目录下面。
apps/:存放带有jni接口的android工程目录(工程里面有利用native关键字定义的java函数)
build/:存放着几乎所有的ndk编译相关的脚本以及必要的静态链接库。
docs/:存放这ndk的所有“官方”文档,每一篇文档对于jni编写者来说这里面的任何一点点资料都是无价的。
out/:存放一些中间的临时文件,例如jni的.c/.cpp文件编译过程中产生的.o文件等。
sources/:存放jni文件的.c/.cpp的源代码文件。
3、基本的使用方法
(1)创建一个android工程
进入apps目录,运行如下命令:
android create project --target 2 --package com.TWM --activity NDKTest --path ./NDKTest/project
通 过命令行创建一个叫做NDKTest的activity,注意这里的--path需要设置为./XXXXX/project这个目录,这个XXXXX目录 主要是为了ndk的make区分不同项目和工程使用的。编写Application.mk文件的时候,一定要把Application.mk写到这个 XXXXX目录下面。
$NDK/apps/<myapp>/Application.mk
另外,编译jni库的时候使用的命令也是如此:
make APP=<your app name>
这里的<your app name>实际上也是这个XXXXX目录。
(2)为工程添加一个jni的java调用接口
进入app/NDKTest/project/src/com/TWM/NdkTest目录,建立一个新的java文件(例如:NDKJni.java),然后把代码写成类似下面这个样子:
package com.TWM.NdkTest ;
public class NDKJni {
public native int MyFunc(int a, int b) ;
static {
System.loadLibrary("NDKjni") ;
}
}
这里的MyFunc由于是使用native修饰,因此,这个MyFunc函数是一个调用jni的函数。
(3)为java工程编写Application.mk文件
该文件主要放在app/NDKTest目录下,用于告知ndk的编译脚本,当前的程序需要哪个jni模块。
看上去应该是这个样子的:
APP_PROJECT_PATH := $(call my-dir)/project ---> 当前目录下的project目录包含了jni模块的java接口
APP_MODULES := NDKTest --->当前模块的名字叫做NDKTest
(4)弄清楚java程序的包层次
以当前的这个project为例,就是上面代码中的package com.TWM.NdkTest,定义的类名为NDKJni。因此,根据这个包的层次,可以根据jni文件的函数命名规则定义函数:
JNIEXPORT jint JNICALL Java_com_TWM_NdkTest_NDKJni_MyFunc(JNIEnv * env, jobject thiz, jint a, jint b) ;
当然,手工根据包层次定义jni函数还是很痛苦的,可以借助于javah工具:
mkdir -p apps/NDKTest/project/jni
cd apps/NDKTest/project/jni
javah -classpath "../bin/classes" com.TWM.NdkTest.NDKJni
然后就会自动生成一个叫做com_TWM_NdkTest_NDKJni.h的文件,里面的内容基本上跟手工生成的差不多:
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_TWM_NdkTest_NDKJni */
#ifndef _Included_com_TWM_NdkTest_NDKJni
#define _Included_com_TWM_NdkTest_NDKJni
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: com_TWM_NdkTest_NDKJni
* Method: MyFunc
* Signature: (II)I
*/
JNIEXPORT jint JNICALL Java_com_TWM_NdkTest_NDKJni_MyFunc
(JNIEnv *, jobject, jint, jint);
#ifdef __cplusplus
}
#endif
#endif
好了,有了这个函数的定义,就可以准备去编写jni了。
(5)进入source目录
建立目录ndktest,然后在里面放置两个文件,一个是随便命名例如a.c,另外一个是一个叫做Android.mk的编译脚本文件。
里面的内容如下:
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := NDKTest --->这里是指定jni模块的名字,生成的so库应该叫做libNDKTest.so,这个名字一定要与Application.mk文件中的APP_MODULES相同。
LOCAL_SRC_FILES := a.c
include $(BUILD_SHARED_LIBRARY) --->这里是告诉编译脚本生成的库是共享库(本身NDK是可以生成动态库和静态库的)。
然后在a.c里面写入的内容如下:
JNIEXPORT jint JNICALL
Java_com_TWM_NdkTest_NDKJni_MyFunc(JNIEnv * env, jobject thiz, jint a, jint b)
{
return a+b ;
}
(6)开始编译jni模块
首先进入android-ndk-1.5_r1目录,然后运行如下命令:
make APP=NDKTest [回车]
这个时候就会看到它开始编译并且在apps/NDKTest/projects/目录下建立了libs/armeabi/目录,并且把生成的libNDKTest.so拷贝到该目录下。
看到这里或许有人会问,它的编译参数怎么没有,我怎么调试阿?!其实很简单,只要多加一个编译参数即可。
make APP=NDKTest V=1 [回车]
你就会看到如下的输出(偶的测试程序里面把上面说的a.c改成NDKTest.c了,所以看到的内容略有不同):
wayne@wayne:~/android-ndk-1.5_r1$ make APP=NDKTest V=1
Android NDK: Building for application 'NDKTest'
Compile thumb : NDKTest <= sources/ndktest/NDKTest.c
build/prebuilt/linux-x86/arm-eabi-4.2.1/bin/arm-eabi-gcc -Ibuild/platforms/android-1.5/arch-arm/usr/include -march=armv5te -mtune=xscale -msoft-float -fpic -mthumb-interwork -ffunction-sections -funwind-tables -fstack-protector -fno-short-enums -D__ARM_ARCH_5__ -D__ARM_ARCH_5T__ -D__ARM_ARCH_5E__ -D__ARM_ARCH_5TE__ -Isources/ndktest -DANDROID -O2 -DNDEBUG -g -c -MMD -MP -MF out/apps/NDKTest/android-1.5-arm/objs/NDKTest/NDKTest.o.d.tmp sources/ndktest/NDKTest.c -o out/apps/NDKTest/android-1.5-arm/objs/NDKTest/NDKTest.o
build/core/mkdeps.sh out/apps/NDKTest/android-1.5-arm/objs/NDKTest/NDKTest.o out/apps/NDKTest/android-1.5-arm/objs/NDKTest/NDKTest.o.d.tmp out/apps/NDKTest/android-1.5-arm/objs/NDKTest/NDKTest.o.d
SharedLibrary : libNDKTest.so
build/prebuilt/linux-x86/arm-eabi-4.2.1/bin/arm-eabi-gcc -nostdlib -Wl,-soname,libNDKTest.so -Wl,-shared,-Bsymbolic out/apps/NDKTest/android-1.5-arm/objs/NDKTest/NDKTest.o -Wl,--whole-archive -Wl,--no-whole-archive build/platforms/android-1.5/arch-arm/usr/lib/libc.so build/platforms/android-1.5/arch-arm/usr/lib/libstdc++.so build/platforms/android-1.5/arch-arm/usr/lib/libm.so -Wl,--no-undefined -Wl,-rpath-link=build/platforms/android-1.5/arch-arm/usr/lib /home/wayne/android-ndk-1.5_r1/build/prebuilt/linux-x86/arm-eabi-4.2.1/bin/../lib/gcc/arm-eabi/4.2.1/interwork/libgcc.a -o out/apps/NDKTest/android-1.5-arm/libNDKTest.so
Install : libNDKTest.so => apps/NDKTest/project/libs/armeabi
mkdir -p apps/NDKTest/project/libs/armeabi
install -p out/apps/NDKTest/android-1.5-arm/libNDKTest.so apps/NDKTest/project/libs/armeabi/libNDKTest.so
build/prebuilt/linux-x86/arm-eabi-4.2.1/bin/arm-eabi-strip --strip-debug apps/NDKTest/project/libs/armeabi/libNDKTest.so
(7)开始编译android本地java程序
进入apps/NDKTest/project目录,然后运行ant debug来生成调试版本的apk包,注意,此时,apk包里面会自动把刚刚生成的libNDKTest.so打包进去的。这一点可以通过把apk文件用unzip命令解包来验证,在此不再赘述。
这就是android-ndk编译jni程序的全过程,确实要比偶在上一篇文章中描述的方法来得简单许多,总结一下:
(a)在apps目录里面创建带有native关键字声明的java项目。(注意,目录需要多打一层,用来放Application.mk文件)
(b)在sources目录里面创建真正的jni模块目录,里面一定要包含一个叫做Android.mk的文件。
(c)在apps里面的Application.mk与sources目录里面的Android.mk在MODULE的名字上一定要“遥相呼应”。
(d)编译的方法是,进入android-ndk-1.5_r1目录,运行make APP=<your app name> V=1生成jni库;其实不止如此,make APP=<your app name> clean也可以清除掉。
但愿这篇文章能够对各位致力于android开发和移植的朋友们有所帮助。