从零开始使用Eclipse搭建NDK项目

事前准备:

下载Android-ndk-r10e-windows-x86_64.exe  

官网地址:http://developer.android.com/ndk/downloads/index.html.

百度网盘:http://pan.baidu.com/s/1jHmYkzc

下载完成后把文件移动到工作目录,注意路径中不要带有中文和空格. 

双击exe文件会执行解压,但是解压是默认解压到文件所在目录,所以在解压前移动到工作目录是很有必要的,因为解压出来的文件大概3G左右,这大概需要十分钟.如果发现目录错了,但是你想移动到本盘内其他位置,直接移动就行,但是如果跨盘的话,不要尝试复制过去,因为这里有无数的小文件,速度会非常慢,不如把400M的exe文件移动过去再执行一次解压来的方便.

配置NDK地址:

windows->preferences->android->NDK,选择NDK目录.

开始搭建:

1.首先,创建一个Android项目.一路next下去.这里我是基于4.0创建的.



2.右键点击项目->Android Tools -> Add Native Support.





    此时工程目录下会多出一些文件夹:jni,obj.jni文件夹是存放natvie代码的,obj是存放生成的库文件之类的.



3.然后创建GetString类

[java] view
plain copy

public class GetString {  

    public static native String getStr();  

    public native String getString();  

    public native int add(int a, int b);  

}  

4.打开cmd命令行,进入项目的<项目地址>/bin/classes/下.输入javah -jni <包名>.类名
这里使用了javah命令,这个命令是jdk里的,jre里是没有的.

如:<项目目录>\bin\classes>javah -jni com.zzk.hellojni.GetString



该命令的作用是对GetString类生成.h头文件.成功后会在\bin\classes\下生成一个.h文件.



把这个文件复制到工程jni文件下.



此时会报错,提示Type 'JNIEnv' could not be resolved,是因为项目没有include 运行环境.



右键项目->properties->C/C++general->Paths and Symbols

点击Add按钮



勾选Add to all languages.点击File system,选择之前准备好的NDK目录下的\platforms\android-14\arch-arm\usr\include目录.注意NDK路径地址不能有汉字和空格!!!否则会报错.platforms最好选和项目sdk一致的版本.arch开头的三个目录应该是和cpu构架相关的,android绝大数的设备都是arm构架的.





点击OK,点击Apply,会提示是否重构项目,点击确定.此时项目不再报错.

5.创建一个NDK Builder构造器.
右键项目->properties->builders->New.选择Program.然后弹出一个对话框.这里需要配置一下.

Main标签:Location选择NDK的根目录.Working Directory选择工程目录.



Refresh标签:勾选Refresh resources upon completion.看图吧.



Build Options标题:勾选框框内的.然后点击Specify Resources



选择项目里的jni文件夹.



点击finish,此时这里就多了一个NDK_Builder



点击ok,会执行构建操作,此时如果出现下列信息就表示成功了.



6.然后把之前的.h文件里的三个未实现的方法复制到.cpp内,然后实现方法.#include 头文件不要忘掉.



然后点击project->build project.等待构建成功后obj文件夹下会多出一些文件.



libHelloJNI.so 就是最后生成的动态库.

7.最后在MainActivity中调用GetString类的方法.显示到界面上.

[java] view
plain copy

public class MainActivity extends Activity {  

  

    @Override  

    protected void onCreate(Bundle savedInstanceState) {  

        super.onCreate(savedInstanceState);  

        setContentView(R.layout.activity_main);  

        TextView tv = (TextView) findViewById(R.id.tv);  

        String str = GetString.getStr();  

        str += "\n" + new GetString().getString();  

        str += "\n" + new GetString().add(5, 3);  

        tv.setText(str);  

    }  

  

}  



运行会报错,提示:



这是因为代码中没有加载动态库.回到GetString类中,添加方法.



现在运行项目,可以看到界面上已经成功显示了三个native方法返回的值.



参考链接:

极客学院NDK开发实例程序:http://www.jikexueyuan.com/course/80_3.html?ss=2    点击这里注册领取极客学院30天的VIP

提示:Type 'JNICALL' could not be resolved 点击:http://blog.csdn.net/fei0724/article/details/8645690

参考链接:http://www.cnblogs.com/yejiurui/p/3476565.html

1. JNIEnv对象 

 

  对于本地函数

   JNIEXPORT void JNICALL Java_video1_TestNative_sayHello(JNIEnv * env, jobject obj)

   {  

      cout<<"Hello Native Test !"<<endl;  

   }  

   

      JNIEnv类型代表Java环境。通过这个JNIEnv*指针，就可以对Java端的代码进行操作。如，创建Java类得对象，调用Java对象的方法，获取Java对象的属性等。

     JNIEnv的指针会被JNI传送到本地方法的实现函数中来对Java端的代码进行操作

 

     

     JNIEnv类中的函数：

     NewObject/NewString/New<TYPE>Array  ：new新对象

     Get/Set<TYPE>Field：获取属性

     Get/SetStatic<TYPE>Field ：获取静态属性

     Call<TYPE>Method/CallStatic<TYPE>Method：调用方法

     

2. Java数据类型与C/C++数据类型的对应关系

 

可以参考 jni.h 文件：http://home.pacifier.com/~mmead/jni/cs510ajp/jni.h

 

Java类型      别名　　           C++本地类型　　        字节(bit)  
boolean      jboolean            unsigned char　　    8, unsigned  
byte         jbyte               signed char　　　　
  8  
char         jchar               unsigned short　　
  16, unsigned  
short        jshort              short　　　
           16  
int          jint                long　　　　
          32  
long         jlong               __int64　　　　     64  
float        jfloat              float　　　
       32  
double       jdouble             double　　　
          64  
void         void        　　　　      
                n/a　　 

Object        _jobject            *jobject    

 

 

3. 获取jclass

 

    为了能够在C/C++使用Java类，jni.h头文件中专门定义了jclass类型来表示Java中的Class类

    jclass的取得：

    JNIEnv类中有如下几个简单的函数可以取得jclass

    jclass FindClass(const char* clsName)  根据类名来查找一个类，完整类名。

    jclass GetObjectClass(jobject obj)   根据一个对象，获取该对象的类

    jclass GetSuperClass(jclass obj)     获取一个类的父类

    

    FindClass 会在classpath系统环境变量下寻找类，需要传入完整的类名，注意包与包之间是用"/"而不是"."来分割

如：jclass cls_string= env->FindClass("java/lang/String");

 

获取jclass又什么用，比如你要调用类的静态方法，静态属性就需要通过这个方法来获取一个类。

 

 

4. 本地代码访问Java类中的属性与方法 

 

 

有了类和对象之后，如何才能访问java中的对象的属性和方法呢，这就需要用到以下这些方法了。

 JNI在jni.h头文件中定义了jfieldID，jmethodID类表示Java端的属性和方法

如何获取属性： 在访问或设置Java属性的时候，首先就要现在本地代码中取得代表Java属性的jfieldID，然后才能在本地代码中进行Java属性操作。

如何调用java的方法：调用Java端的方法时，需要取得代表方法的jmethodID才能进行Java方法调用

 

JNIEnv获取相应的fieldID和jmethodID的方法：

    GetFieldID/GetMethodID

    GetStaticFieldID/GetStaticMethodID

    GetMethodID也可以取得构造函数的jmethodID。创建Java对象时调用指定的构造函数。

    如：env->GetMethodID(data_Clazz,"method_name","()V")

    (*jniEnv)->GetMethodID(jniEnv, Clazz,"<init>", "()V"); 

    这个比较特殊，这个是默认构造函数的方法，一般用这个来初始化对象，但是再实际过程中，为了快速生成一个实例，一般通过工厂方法类创建jobject

    

    jni.h 对GetMethodID的定义：

    jmethodID (JNICALL *GetMethodID)

      (JNIEnv *env, jclass clazz, const char *name, const char *sig);

      

    这就引入了一个新的问题，什么是sig，我们后面再说，举个例子说明

    前提说明： JAVA类 TestProvider ,该类有2个方法分别为String
getTime( ) , void saysayHello( String str)

    

jclass TestProvider;

jobject mTestProvider;

jmethodID getTime;

jmethodID sayHello;

 

C 中映射类   

TestProvider = (*jniEnv)->FindClass(jniEnv,"com/duicky/TestProvider");

C中新建对象    

      //默认构造函数，不传参数
       jmethodID construction_id = (*jniEnv)->GetMethodID(jniEnv, TestProvider,"<init>", "()V");

       //通过NewObject来创建对象
       jobject mTestProvider = (*jniEnv)->NewObject(jniEnv, TestProvider,construction_id);

C 中映射方法 

       静态：

getTime = (*jniEnv)->GetStaticMethodID(jniEnv, TestProvider, "getTime","()Ljava/lang/String;");

       非静态：

sayHello = (*jniEnv)->GetMethodID(jniEnv, TestProvider, "sayHello","(Ljava/lang/String;)V");

C 中调用 Java的 方法

       静态：

(*jniEnv)->CallStaticObjectMethod(jniEnv, TestProvider, getTime);

       非静态：

(*jniEnv)->CallVoidMethod(jniEnv, mTestProvider, sayHello,jstrMSG);

 

注意 GetXXXMethodID  和 CallXXXMethod
。

第一个XXX 表示的是映射方法的类型，如： 静态 跟非静态

第二个 XXX 表示 调用方法的返回值 ，如：Void,Object,等等。（调用静态方法的时候Call后面要加Static）

    

  5. sign签名

    对于 jmethodID GetMethodID(jclass clazz, const char *name, const char *sign)

    clazz代表该属性所在的类，name表示方法名称，sign是签名

    那什么是签名，签名是对函数参数和返回值的描述，对同一个函数，在java中允许重载，这个时候就需要这个sign来进行区分了。

    以下是java类型签名的描述

    

用来表示要取得的属性/方法的类型  

 

类型           相应的签名  
boolean        Z  
byte           B  
char           C  
short          S  
int            I  
long           J  
float          F  
double         D  
void           V  
object         L用/分隔包的完整类名：   Ljava/lang/String; 
Array          [签名          [I      [Ljava/lang/Object;  
Method         (参数1类型签名 参数2类型签名···)返回值类型签名  

 

特别注意：Object后面一定有分号（；）结束的,多个对象参数中间也用分号(;)来分隔

 

 

例子：

方法签名

void f1()                         ()V
int f2(int, long)
                (IJ)I
boolean f3(int[])                 ([I)B
double f4(String, int)
           (Ljava/lang/String;I)D
void f5(int, String [], char)    (I[Ljava/lang/String;C)V

 

 

 图解签名：


 

 

 

使用javap命令来产生签名

     javap -s -p [full class Name]

     -s 表示输出签名信息

     -p 同-private,输出包括private访问权限的成员信息

   

 例子：

 C:\E\java\workspaces\myeclipseblue\JNITest\bin>javap -s -private video1.TestNative  

Compiled from "TestNative.java"  
public class video1.TestNative extends java.lang.Object{  
public java.lang.String name;  

  Signature: Ljava/lang/String;  
public video1.TestNative();  

  Signature: ()V  
public int signTest(int, java.util.Date, int[]);  

  Signature: (ILjava/util/Date;[I)I  
public native void sayHello();  

  Signature: ()V  
public static void main(java.lang.String[]);  

  Signature: ([Ljava/lang/String;)V  

}   

 

 

TestNative完整代码：

 

package video1;  
import java.util.Date;  
public class TestNative {  

    public String name="Test";  

    public int number =100;  

    public int signTest(int i,Date date,int[] arr){  

        System.out.println("Sign Test");  

        return 0;  

    }  

    //native关键字修饰的方法，其内容是C/C++编写的，java中不必为它编写具体的实现  
    public native void sayHello();  

    public static void main(String[] args) {  

        System.loadLibrary("NativeCode");  

        TestNative tn = new TestNative();  

        tn.sayHello();  

    }  

}

 

 

C/C++代码

 

 

#include "video1_TestNative.h"  

#include <iostream>  
using namespace std;  

JNIEXPORT void JNICALL Java_video1_TestNative_sayHello(JNIEnv * env, jobject obj){  

    cout<<"Hello Native Test !"<<endl;  

    //因为test不是静态函数，所以传进来的就是调用这个函数的对象  

    //否则就传入一个jclass对象表示native()方法所在的类  
    jclass native_clazz = env->GetObjectClass(obj);  

  

    //得到jfieldID  
    jfieldID fieldID_prop = env->GetFieldID(native_clazz,"name","Ljava/lang/String;");  

    jfieldID fieldID_num = env->GetFieldID(native_clazz,"number","I");  

  

    //得到jmethodID  
    jmethodID methodID_func=env->GetMethodID(native_clazz,"signTest","(ILjava/util/Date;[I)I");  

    //调用signTest方法  
    env->CallIntMethod(obj,methodID_func,1L,NULL,NULL);  

  

    //得到name属性  
    jobject name = env->GetObjectField(obj,fieldID_name);  

    //得到number属性  
    jint number= env->GetIntField(obj,fieldID_num);   

  

    cout<<number<<endl;//100  

    //修改number属性的值  
    env->SetIntField(obj,fieldID_num,18880L);    

    number= env->GetIntField(obj,fieldID_num);    

    cout<<number<<endl;//18880  
 }  

 

本文地址，转载请注明出处：

http://www.cnblogs.com/likwo/archive/2012/05/21/2512400.html 

 

参考资料：

http://zzqrj.iteye.com/blog/1285262

 

 

jni.h 头文件：

http://home.pacifier.com/~mmead/jni/cs510ajp/jni.h

 

相关例子：

 

http://www.pacifier.com/~mmead/jni/cs510ajp/index.html

Programmming in C/C++ with the Java Native Interface (3 个练习)

http://www.pacifier.com/~mmead/jni/cs510ajp/exercises/index.html

 

 

JNI 文档：

http://files.cnblogs.com/luxiaofeng54/JNI_Docs.rar

 

 

基于 Android NDK 的学习之旅----- C调用Java

http://www.cnblogs.com/luxiaofeng54/archive/2011/08/17/2142000.html

 

 

Linux下JNI的使用：比较基础

http://www.cnblogs.com/bastard/archive/2012/05/17/2506877.html

 

 

如何在Android下使用JNI：讲解比较详细，但是代码里有些错误，空格没处理好

http://blog.csdn.net/xnwyd/article/details/7086384

这篇文章有些地方不清楚的参考下这篇文章

 

Android Jni代码示例讲解

http://developer.51cto.com/art/201001/181355.htm

 

JNI callMethod参考文档

 

其他推荐学习网站

 

JNI的提高，Java类型和C(C++)类型转换源代码

http://blog.csdn.net/ostrichmyself/article/details/4557851 

 

JNI 的多线程

 http://blog.csdn.net/popop123/article/details/1511180 

 

Android NDK 开发 

 

 

使用 Java Native Interface 的最佳实践：描述了JNI性能和缓存的一些东西

 

 https://www.ibm.com/developerworks/cn/java/j-jni/

 

JNI 攻略系列

JNI全攻略之一－－建立一个简单的JNI程序 

http://blog.csdn.net/yjkwf/article/details/7006260 

JNI全攻略之二――JNI基础 

http://blog.csdn.net/yjkwf/article/details/7006261 

 JNI全攻略之三－－JNI头文件分析

 http://blog.csdn.net/yjkwf/article/details/7006264

 JNI攻略之四――JNI操作数组

http://blog.csdn.net/yjkwf/article/details/7006266 

 

http://disanji.net/2011/01/26/android-jni-programming-2/ 

 

 JNI Examples for Android

http://android.wooyd.org/JNIExample/files/JNIExample.pdf 

 

JNI pthread 多线程使用

http://www.cnblogs.com/lknlfy/archive/2012/03/16/2400786.html