一、开发环境搭建
这里说的环境搭建主要是已经完成android开发环境的基础上做的,主要有:NDK下载,下载安装cygwin,NDK环境变量配置,eclipse CDT插件的安装 ,这些在网络上都有详细的图文说明。注意的地方是cygwin最好选择离线安装(本人从网络安装花了N久的时间最后还报错,最后还得离线安装完成)。NDK环境变量配置主要是home\<你的用户名>\. .bash_profile。打开这个文件在最后添加NDK环境变量路径,如:
NDK_ROOT=/cygdrive/e/NDK/android-ndk-r7b
export NDK_ROOT
二、NDK开发,第一个程序
第一个程序当然是从Hello World写起,主要分下面几步:
1、创建一个Android工程,在java代码中声明native方法,
package com.joy.hellondk;
import android.app.Activity;
import android.os.Bundle;
public class HelloNDKActivity extends Activity {
public native String helloFromC();
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
}
}
如这里定义的了一个helloFromC()的native方法,这个方法在对应C中的方法。对应的C代码我们可以通过javah来生成一个.h的文件。具体步骤:通过cmd跳转到工程目录的bin/classes目录下,执行javah com.joy.hellondk.HelloNDKActivity (包名+类名)
E:\eclipseWork\HelloNDK\bin\classes>javah com.joy.hellondk.HelloNDKActivity
执行后在E:\eclipseWork\HelloNDK\bin\classes目录下回生成com_joy_hellondk_HelloNDKActivity.h 的C文件,该文件名字是对应java的包名和类名,打开这个文件我们可以看到内部的代码
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_joy_hellondk_HelloNDKActivity */
#ifndef _Included_com_joy_hellondk_HelloNDKActivity
#define _Included_com_joy_hellondk_HelloNDKActivity
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: com_joy_hellondk_HelloNDKActivity
* Method: helloFromC
* Signature: ()Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_joy_hellondk_HelloNDKActivity_helloFromC
(JNIEnv *, jobject);
#ifdef __cplusplus
}
#endif
#endif
这段代码中JNIEXPORT jstring JNICALL Java_com_joy_hellondk_HelloNDKActivity_helloFromC (JNIEnv *, jobject); 就是我们在java中定义的native对应的C代码接口,jstring是返回值,这种类型是jni.h定义的(jni.h是在我们下载的ndk开发包中platforms目录下,如我的在:android-ndk-r7b\platforms\android-8\arch-arm\usr\include目录);方法名Java_com_joy_hellondk_HelloNDKActivity_helloFromC定义是Java开头+包名+类名+方法名,参数JNIEnv *, jobject这两个是必须的量。
2、创建jni目录,编写C的代码,方法名字要对应
在步骤1建的Android工程上建立名为jni的目录,并把上面javah生成的com_joy_hellondk_HelloNDKActivity.h文件拷贝到jni目录下,同时在jni目录下建立C文件来实现,这里命名为Hello.c,在C中代码如下
#include<stdio.h>
#include"com_joy_hellondk_HelloNDKActivity.h"
JNIEXPORT jstring JNICALL Java_com_joy_hellondk_HelloNDKActivity_helloFromC
(JNIEnv* env, jobject obj) {
// return (*(*env)).NewStringUTF(env, "Hello from C");
return (*env)->NewStringUTF(env, "Hello from C -->");
}
头文件包含com_joy_hellondk_HelloNDKActivity.h并对声明的方法Java_com_joy_hellondk_HelloNDKActivity_helloFromC,返回的参数jstring类型通过NewStringUTF方法产生,NewStringUTF方法的定义可以查看jni.h。
3、编写Android.mk文件
这个是NDK编译生成动态库所需要的。其写法在ndk目录下docs下的ANDROID-MK.html有示例介绍,如我这里是android-ndk-r7b\docs打开ANDROID-MK.html可以看到里面写的
---------- cut here ------------------
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := hello-jni
LOCAL_SRC_FILES := hello-jni.c
include $(BUILD_SHARED_LIBRARY)
---------- cut here ------------------
这里cut here中间的内容既是基本的要素LOCAL_PATH表示当前工作目录;LOCAL_MODULE表示生成的动态库名字;LOCAL_SRC_FILES表示编译的C文件。我们这里把这两个值改下为:LOCAL_MODULE := Hello
LOCAL_SRC_FILES := Hello.c
4、NDK编译生成动态库
打开cygwin并跳转到Android的工作目录,并编译
编译后,在android工程下会生成一个.so的动态库文件,动态库的命名前缀lib和后缀.so是自动加上的,中间名字是我们在Android.mk中LOCAL_MODULE指定的,如图
5、java代码load动态库,调用native方法
在我们调用C代码的java代码中将生成的动态库加载进来,并在需要的地方调用native方法,即C代码。通过static块加载的动态库名与Android.mk中定义的LOCAL_MODULE名字是一致的。
public class HelloNDKActivity extends Activity {
static {
// 不需要加前缀lib和后缀.so
System.loadLibrary("Hello");
}
public native String helloFromC();
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
}
//为了测试方便,用一个按钮点击来查看效果
public void click(View view) {
Toast.makeText(this, helloFromC(), 1).show();
}
}
把项目部署到模拟器,点击按钮查看,效果如下:toast中显示的字符串即我们在C代码中写的字符串。