android NDK开发小记

一、开发环境搭建

     这里说的环境搭建主要是已经完成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代码中写的字符串。