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代码中写的字符串。


版权声明:本文为zmpcwl原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接和本声明。