这篇文章来说说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/jnicd apps/NDKTest/project/jnijavah -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 __cplusplusextern "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.cinclude $(BUILD_SHARED_LIBRARY) --->这里是告诉编译脚本生成的库是共享库(本身NDK是可以生成动态库和静态库的)。然后在a.c里面写入的内容如下:JNIEXPORT jint JNICALLJava_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=1Android NDK: Building for application 'NDKTest'Compile thumb : NDKTest <= sources/ndktest/NDKTest.cbuild/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.obuild/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.dSharedLibrary : libNDKTest.sobuild/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.soInstall : libNDKTest.so => apps/NDKTest/project/libs/armeabimkdir -p apps/NDKTest/project/libs/armeabiinstall -p out/apps/NDKTest/android-1.5-arm/libNDKTest.so apps/NDKTest/project/libs/armeabi/libNDKTest.sobuild/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开发和移植的朋友们有所帮助。