JNI 详细使用 基础【步骤】

  • 1、定义本地【native】方法。通常情况下,应单独定义一个类来封装所有native方法。native方法相当于一个【接口】中的方法,只有方法声明,没有方法体。
  • 2、在项目根目录下创建【jni文件夹】,将利用【javah】命令生成的【.h】头文件拷到jni目录中。然而在实际测试中发现,这个文件没有任何卵用,不拷贝也没问题。
  • 3、在jni目录中编写所需的【.c】文件,这一步才是核心,在c代码中,实现上面定义的本地方法。其中ndk工具中提供的<jni.h>头文件中详细定义了JNI【基本数据类型】和【本地等效类型】之间的转换。
  • 4、在jni目录中创建【Android.mk】文件,主要是声明所引用的.c文件和生成的.so库的文件名
  • 5、创建【Application.mk】文件,主要是声明所有支持的平台。每增加一个支持的架构,编译后就会在lib目录下生成一个相应架构平台的目录。
  • 6、使用【ndk】工具编译生成【.so动态链接库文件】。当完成这一步后,如果我们以后不需要再重新编译,我们就可以直接删除【jni】目录。另外发布的时候这些文件都是应该删掉的。
  • 7、使用时先 System.loadLibrary("hello"),然后直接调用本地native方法即可。注意,加载库文件时的文件名要去掉前面的lib和后面的.so

1、定义本地【native】方法

定义本地方法,通常情况下,应单独定义一个类来封装所有native方法

/** 存放native方法的类 */

public class MyNativeMethods {
    private static MyNativeMethods mEmployee;
    private MyNativeMethods() {
    }
    public static MyNativeMethods getInstance() {
        if (mEmployee == null) {
            mEmployee = new MyNativeMethods();
        }
        return mEmployee;
    }
    //相当于在java代码中定义了一个接口,然后用C语言实现了此接口
    public native String helloFromC();
    public native int passwordFromC(int x, int y);
}

2、利用javah命令生成的.h头文件

1、定位到工程的【 src目录】下
cd/d E:\HelloFromC\src

2、对native方法所在类执行【javah】命令,其中javah后面的类文件的格式是【包名.类名】
javah com.bqt.hellofromc.MyNativeMethods
执行过程如下:

报错的原因是因为MyNativeMethods中有中文字符,即使是注释也会报错,且发现一处中文就报错一次
但是这并不影响处理结果,所以大可不用理会

3、在项目根目录下创建【jni文件夹】,将生成的【.h文件】拷贝到jni目录下
在实际测试中发现,这个文件没有任何卵用,不拷贝也没问题。可能是因为我测试的代码比较简单吧。


文件的内容为
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_bqt_hellofromc_MyNativeMethods */
#ifndef _Included_com_bqt_hellofromc_MyNativeMethods
#define _Included_com_bqt_hellofromc_MyNativeMethods
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_bqt_hellofromc_MyNativeMethods
 * Method:    helloFromC
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_bqt_hellofromc_MyNativeMethods_helloFromC
  (JNIEnv *, jobject);
/*
 * Class:     com_bqt_hellofromc_MyNativeMethods
 * Method:    passwordFromC
 * Signature: (II)I
 */
JNIEXPORT jint JNICALL Java_com_bqt_hellofromc_MyNativeMethods_passwordFromC
  (JNIEnv *, jobject, jint, jint);
#ifdef __cplusplus
}
#endif
#endif  

3、在jni目录中编写所需的.c文件【这一步才是核心】

在项目根目录下创建【jni文件夹】,在jni文件夹中创建一个【.c文件】,在c代码中,实现上面定义的本地方法
在.c文件中引入上面生成的.h文件(非必须,个人觉得有用的东西就是,它帮我们自动生成了符合JNI规范的方法声明,我们只需把方法声明拷走就行了)
#include "com_bqt_hellofromc_MyNativeMethods.h"  

以下为.c中的代码

#include <stdio.h>

#include <stdlib.h>
#include <jni.h>//必须添加的头文件

jstring Java_com_bqt_hellofromc_MyNativeMethods_helloFromC(JNIEnv* env, jobject obj) { //【返回值】【方法名】【参数列表】返回值类型jstring就是java中的string
    char* cstr = "hello from c"//  char*  在c中可用来表示一个字符串。注意,这里绝对不能有中文
    jstring jstr = (*env)->NewStringUTF(env, cstr);
    return jstr;
}

JNIEXPORT jint JNICALL Java_com_bqt_hellofromc_MyNativeMethods_passwordFromC(JNIEnv *env, jobject obj, jint a, jint b) {
//JNIEXPORT和JNICALL都是JNI的关键字,表明函数是被JNI调用的;JNIEXPORT 表示输出类型;JNICALL表示参数的压栈顺序;貌似都可以省略
    return a + b + 10000; //c中的int占用字节数在不同环境下可能不同,可能是0-65535,所以,稍微大一点的数(十万级别)都得用double

}


4、在jni目录中创建Android.mk文件,主要是声明所引用的.c文件和生成的.so库的文件名

在工程的jni目录下创建一个【Android.mk文件】,在里面定义打包成函数【库的名字】及对应的【c代码的文件名】

LOCAL_PATH :$(call my-dir)

# C/C++代码所在目录,也就是我们的jni目录,不必修改
include $(CLEAR_VARS)
LOCAL_MODULE    :hello
# 对应打包成函数库的名字,编译器会自动在前面加上lib,在后面加上.so,最终结果就是libhello.so
LOCAL_SRC_FILES :hello.c
# 对应的c代码的文件名,即hello.c  

include $(BUILD_SHARED_LIBRARY)  


5、创建Application.mk文件,主要是声明所有支持的平台

默认只会生成支持arm平台的动态链接库文件,若项目支持arm外的平台,需在jni目录中添加【Application.mk】文件,并加上以下内容

APP_ABI := armeabi armeabi-v7a x86

#Application.mk文件的目的是,描述在你的应用程序中所有需要的模块(即静态库或动态库)
#APP_ABI 的值以空格区分,代表要支持的架构,默认值为【armeabi】。其他架构,ARMv7 【armeabi-v7a】;IA-32【 x86】

#每增加一个架构,编译后都会在lib目录下生成一个相应的文件夹,文件夹下的文件都是同名的.so文件(当然文件内容不一样)


编译成功后,会在lib目录下生成对应的多个文件夹及.so文件

6、使用ndk工具编译生成.so成动态链接库文件

可以使用cygwin工具编译,其中下面第三步中为Android工程的根目录

cd ../..

cd cygdrive/

cd D/Users/Android_workspace/HelloFromC

ndk-build


或直接用cmd编译,注意要先在"系统变量path"中增加NDK工具所在路径,如【D:\Android\android-ndk-r10d】

cd/d D:\Users\Android_workspace\HelloFromC

ndk-build

过程:


编译成功后会在工程libs/armeabi目录下生成一个【libhello.so】文件
其中,eabi的含义为:Embedded Application Binary Interface(嵌入式应用二进制接口)

细心观察会发现,除了自动生成了libs目录下的.so文件外,还产生了一个比libs目录大很多倍的obj目录,并且其结构及内容也很像

网上找到的资料解释为:
As part of the build process过程, the files in the libs folder have been stripped剥皮 of symbols符号 and debugging information. So you'll want to keep two copies of each of your .so files: One from the libs folder to install on the Android device, and one from the obj folder to install for GDB一个调试工具 to get symbols from.

简单来说就是,obj下的是带符号和调试信息的,lib下的是去掉这些庞大信息后的动态链接库文件,在安装到Android设备上时只需libs目录下的.so文件即可

当完成这一步后,如果我们以后不需要再重新编译,我们就可以直接删除【jni】目录和【obj】目录了

以下是是发布前的工程结构


7、使用时,直接调用本地native方法即可

在java代码中加载.so类库,之后就可以调用本地方法了

public class MainActivity extends ListActivity {
    static {
        System.loadLibrary("hello");// 在java代码中引入libs目录下的库函数,文件名为【libhello.so】。注意,引入时的文件名要去掉前面的lib和后面的.so
    }

    private TextView tv_info;
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        String[] array = { "调用C中的无参方法,返回一个字符串""调用C中的有参方法,返回处理1+2后的值", };
        tv_info = new TextView(this);
        tv_info.setTextColor(Color.BLUE);
        tv_info.setTextSize(TypedValue.COMPLEX_UNIT_SP, 16);
        tv_info.setPadding(20, 10, 20, 10);
        getListView().addFooterView(tv_info);
        setListAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1new ArrayList<String>(Arrays.asList(array))));
    }
    @Override
    protected void onListItemClick(ListView l, View v, int position, long id) {
        switch (position) {
        case 0:
            String stringFromC = MyNativeMethods.getInstance().helloFromC();
            tv_info.setText(stringFromC);
            break;
        case 1:
            int intFromC = MyNativeMethods.getInstance().passwordFromC(1, 2);
            tv_info.setText(intFromC+"");
            break;
        }
    }
} 






附件列表

     

    posted @ 2016-06-21 16:35  白乾涛  阅读(6614)  评论(0编辑  收藏