从零开始使用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创建的.

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

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

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

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

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

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

3.然后创建GetString类
[java] view plain copy
  1. public class GetString {  
  2.     public static native String getStr();  
  3.     public native String getString();  
  4.     public native int add(int a, int b);  
  5. }  


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

4.打开cmd命令行,进入项目的<项目地址>/bin/classes/下.输入javah -jni <包名>.类名

这里使用了javah命令,这个命令是jdk里的,jre里是没有的.

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

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

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

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

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

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

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

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

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

点击Add按钮

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

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

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

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

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

5.创建一个NDK Builder构造器.

右键项目->properties->builders->New.选择Program.然后弹出一个对话框.这里需要配置一下.

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

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

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

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

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

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

选择项目里的jni文件夹.

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

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

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

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

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

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

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

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

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

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

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

[java] view plain copy
  1. public class MainActivity extends Activity {  
  2.   
  3.     @Override  
  4.     protected void onCreate(Bundle savedInstanceState) {  
  5.         super.onCreate(savedInstanceState);  
  6.         setContentView(R.layout.activity_main);  
  7.         TextView tv = (TextView) findViewById(R.id.tv);  
  8.         String str = GetString.getStr();  
  9.         str += "\n" + new GetString().getString();  
  10.         str += "\n" + new GetString().add(53);  
  11.         tv.setText(str);  
  12.     }  
  13.   
  14. }  
从零开始使用Eclipse搭建NDK项目


运行会报错,提示:

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

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

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


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

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


  • 参考链接:

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

提示:Type 'JNICALL' could not be resolved 点击:http://blog.****.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
 
从零开始使用Eclipse搭建NDK项目
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   
从零开始使用Eclipse搭建NDK项目

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类型签名的描述
    
用来表示要取得的属性/方法的类型  

 

从零开始使用Eclipse搭建NDK项目
类型           相应的签名  
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类型签名···)返回值类型签名  
从零开始使用Eclipse搭建NDK项目


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

 

 
例子:
方法签名
void f1()                         ()V
int f2(intlong)                 (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
 
 

 图解签名:

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

 

 
使用javap命令来产生签名
     javap -s -p [full class Name]
     -s 表示输出签名信息
     -p 同-private,输出包括private访问权限的成员信息
   
 例子:
从零开始使用Eclipse搭建NDK项目
 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  
}   
从零开始使用Eclipse搭建NDK项目
 
 

TestNative完整代码:

 
从零开始使用Eclipse搭建NDK项目
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();  
    }  
}
从零开始使用Eclipse搭建NDK项目
 
 

C/C++代码

 

 
从零开始使用Eclipse搭建NDK项目
#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  
 }  
从零开始使用Eclipse搭建NDK项目
 

本文地址,转载请注明出处:

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

 

参考资料:

 

 
jni.h 头文件:

 

相关例子:

 

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

 

 
JNI 文档:

 

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

 

 
Linux下JNI的使用:比较基础

 

 
如何在Android下使用JNI:讲解比较详细,但是代码里有些错误,空格没处理好
这篇文章有些地方不清楚的参考下这篇文章
 
Android Jni代码示例讲解

 

JNI callMethod参考文档

 

其他推荐学习网站

 

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

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

 

JNI 的多线程

 http://blog.****.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.****.net/yjkwf/article/details/7006260 

JNI全攻略之二――JNI基础 

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

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

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

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

http://blog.****.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