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

最新推荐文章于 2024-09-04 16:02:07 发布

过期的码农

最新推荐文章于 2024-09-04 16:02:07 发布

阅读量586

点赞数

分类专栏： android

android 专栏收录该内容

3 篇文章

订阅专栏

事前准备:

下载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.youkuaiyun.com/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 　　　 3 2
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);

注意 Get XXX MethodID  和 Call XXX Method 。

第一个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.youkuaiyun.com/xnwyd/article/details/7086384

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

Android Jni代码示例讲解

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

JNI callMethod参考文档

其他推荐学习网站

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

http://blog.youkuaiyun.com/ostrichmyself/article/details/4557851

JNI 的多线程

http://blog.youkuaiyun.com/popop123/article/details/1511180

Android NDK 开发

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

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

JNI 攻略系列

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

http://blog.youkuaiyun.com/yjkwf/article/details/7006260

JNI全攻略之二――JNI基础

http://blog.youkuaiyun.com/yjkwf/article/details/7006261

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

http://blog.youkuaiyun.com/yjkwf/article/details/7006264

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

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