之前在进行cocos2dx开发时,已经详细介绍了如何将win32的c++代码移植到Android平台,当再次回顾时,发现一些基础的东西理解并不是很彻底,今天使用Android NDK提供的一个例子做一个简单的移植。在进行该demo前,请确认你已经配置了Android开发环境和安装了最新的Android NDK。
1.创建Android项目
创建一个Android项目 , 包名是com.example.hellojni,创建一个Activity作为程序进入的Acitivity,命名为HelloJni。
2.创建 C 文件
创建一个C文件,放一个函数,该函数的作用是获取当前cpu架构并以字符串的形式返回。请注意该函数的格式: Java_包名的下划线连接_Java文件名_java函数名。
#include <string.h> #include <jni.h> jstring Java_com_example_hellojni_HelloJni_stringFromJNI( JNIEnv* env, jobject thiz ) { #if defined(__arm__) #if defined(__ARM_ARCH_7A__) #if defined(__ARM_NEON__) #define ABI "armeabi-v7a/NEON" #else #define ABI "armeabi-v7a" #endif #else #define ABI "armeabi" #endif #elif defined(__i386__) #define ABI "x86" #elif defined(__mips__) #define ABI "mips" #else #define ABI "unknown" #endif return (*env)->NewStringUTF(env, "Hello from JNI ! Compiled with ABI " ABI "."); }
3.配置JNI
在该Android项目的根目录(即AndroidManifest.xml文件所在目录)下创建一个文件夹,命名为jni(注意,文件名不能写错哦)
在jni目录下,创建Android.mk和Application.mk两个文件,同时将C文件也放进jni文件夹下面来。如下:
这里的nick文件夹,可以先忽略不看,这是为后面的打包多个so准备的。
a.配置Android.mk文件
Android.mk文件实际上一个很小的NDK构建脚本,它的语法在: NDK安装目录/docs/ANDROID-MK.html,下文代码也对一些基本属性添加了注释。
#返回当前文件在系统中的路径,mk文件开始时必须定义该变量 LOCAL_PATH := $(call my-dir) #CLEAR_VARS 变量由构建系统提供,因为有大量的全局变量,在本次构建前,清除上一次的 include $(CLEAR_VARS) #LOCAL_MODULE 实际是项目名,用于区分各个项目,名字必须是唯一的而且不包含空格,最终的so库,命名也会是 lib项目名.so LOCAL_MODULE := hello-jni #要编译的c or cpp文件,注意不需要在这里列举头文件或者include的文件,构建系统会自动帮你依赖这些文件 LOCAL_SRC_FILES := hello-jni.c #构建系统提供的变量 include $(BUILD_SHARED_LIBRARY)
b.配置Application.mk文件
Application.mk文件实际上是对应用程序本身描述的文件,它定义了应用程序需要的功能模块的列表、针对不同cpu架构打包不同的so]、要构建release或者debug包等。
APP_ABI := XXX,这里的XXX就是指不同的平台,可以选填的有x86,armeabi,armeabi-v7a,mips,all,值得一提的是,选择all,则会构建出所有平台的so,如果不填该项,默认构建为armeabi的。同时,作者也做过一个实验,构建armeabi平台的so是可以运行在intel x86架构cpu平台的,但是构建x86平台的so则不能在armeabi平台上运行的,这样看来,应该是intel针对armeabi做了兼容,但是如果想要so 以最小的能耗运行在intel x86平台,还是要指定构建的so为x86平台。
4.打包so以及如何打包多个so
在当前Android项目的根目录下,运行 NDK安装路径/ndk-build,则开始打包so。
另外,如果运行 NDK安装路径/ndk-build clean,会clean当前所有的so;
运行 NDK安装路径/ndk-build -B V=1,则强制重新打包,
如果想要打包多个so,则可以在Android.mk定义多个modules,或者写多个Android.mk,每个Android.mk定义一个modules,我这里在jni目录下又创建了一个nick文件夹,用于放置新的C文件。
此时,只需要改动jni目录下的Android.mk,再次对nick文件夹的C代码打包即可。jni下的Android.mk文件:
#返回当前文件在系统中的路径,mk文件开始时必须定义该变量 LOCAL_PATH := $(call my-dir) #CLEAR_VARS 变量由构建系统提供,因为有大量的全局变量,在本次构建前,清除上一次的 include $(CLEAR_VARS) #LOCAL_MODULE 实际是项目名,用于区分各个项目,名字必须是唯一的而且不包含空格,最终的so库,命名也会是 lib项目名.so LOCAL_MODULE := hello-jni #要编译的c or cpp文件,注意不需要在这里列举头文件或者include的文件,构建系统会自动帮你依赖这些文件 LOCAL_SRC_FILES := hello-jni.c #构建系统提供的变量 include $(BUILD_SHARED_LIBRARY) #对nick文件夹下的代码打包so include $(CLEAR_VARS) LOCAL_MODULE := hello-jni-mine LOCAL_SRC_FILES := nick/hello-jni.c include $(BUILD_SHARED_LIBRARY)是的,你没看错,重新加上LOCAL_MODULE和LOCAL_SRC_FILES变量重新配置一下即可。
5.jni调用
在Activity中,我们使用static 关键词将加载so放在函数体中,以保证直接先加载so.
static { System.loadLibrary("hello-jni"); }要注意的是,System.loadLibrary()中填写的并不是完整的so名,而是去掉前缀lib和后缀.so的,也就是Android.mk中的LOCAL_MODULE变量。
java层的函数要用native关键词声明这次调用native层的函数,如果该java函数是public native String XXXX(),那么在这里就是调用C代码中的Java_com_example_hellojni_HelloJni_stringFromJNI()函数。
以上就是Android平台打包so和调用的一个最基本的demo,其实整个流程还是比较简单的,有一些规定的命名是不能随便修改的,如果jni文件夹名,Android.mk,Application.mk文件名,被java层调用的C函数命名等,这些都是有规则的。
两分钟学会Android平台NDK编程(无须Eclipse和cygwin,可使用命令行打包多个so),布布扣,bubuko.com