Android使用NDK(从java调用本地函数'JNI')

简介: Android使用NDK(从java调用本地函数'JNI')

当编写一个混合有本地C代码和Java的应用程序时,需要使用Java本地接口(JNI)作为连接桥梁。JNI作为一个软件层和API,允许使用本地代码调用Java对象的方法,同时也允许在Java方法中调用本地函数。


在Java端,开发者所需要做的仅仅是在连接本地函数的方法之前加上native关键字。这样VM就会去寻找这个本地函数。


1.从Java调用本地函数


从Java调用本地函数时,需要在类中定义一个带有native关键字的特有方法,作为连接本地代码的桥梁。通过这个定义,尝试调用本地方法时JVM会找到一个名字带有包名,类名和方法名的本地函数。

package com.example.liyuanjing.jniproject;
import android.util.Log;
public class NativeSorting {
    static {
        System.loadLibrary("sorting_jni");
    }
    public NativeSorting() {
    }
    public void sortIntegers(int[] ints) {
        nativeSort(ints);
        for (int i = 0; i < ints.length-1; i++) {
            System.out.print(String.valueOf(ints[i]));
            Log.i("liyuanjinglyj",String.valueOf(ints[i]));
        }
    }
    private native void nativeSort(int[] ints);
}


上面是一个简化的示例,包括一个对int数组进行排序的方法。除构造函数之外还有两个方法。第一个是sortIntegers(),它是一个常规的Java方法,可以在其他Java类中调用它。第二个是nativeSort(),这个方法指向本地代码中的函数。虽然可以把本地方法定义为公共的,但更好的做法是把它们作为私有方法包装在一个Java方法中,以便进行一些错误处理。


可以从头开始写本地代码,但也可以借助javah工具来生成部分代码,该工具在Java SDK中。它会生成一个C语言头文件,包括本地方法对应的函数定义。首先要编译Java程序代码,然后在当前项目的src/main目录运行如下命令:

javah -classpath ../../build/intermediates/classes/debug/ -d jni/ com.example.liyuanjing.jniproject.NativeSorting


上面命令展示了如何为之前示例代码中的NativeSorting生成一个头文件。-classpath参数指定了编译好的类文件位置,注意不是DEX文件。-d参数指定了生成头文件的输出目录。运行完命令后,会在jni目录生成com_example_liyuanjing_jniproject_NativeSorting.h文件,它包含了本地函数的定义。

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_example_liyuanjing_jniproject_NativeSorting */
#ifndef _Included_com_example_liyuanjing_jniproject_NativeSorting
#define _Included_com_example_liyuanjing_jniproject_NativeSorting
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_example_liyuanjing_jniproject_NativeSorting
 * Method:    nativeSort
 * Signature: ([I)V
 */
JNIEXPORT void JNICALL Java_com_example_liyuanjing_jniproject_NativeSorting_nativeSort
  (JNIEnv *, jobject, jintArray);
#ifdef __cplusplus
}
#endif
#endif


这段代码即为生成的头文件。正如第一行注释所说,不要修改这个文件。开发者所要做的就是把函数定义复制到实现该函数的.c文件中。


下面的代码展示了头文件com_example_liyuanjing_jniproject_NativeSorting.h中的JNI函数实现,本例没有在JNI_OnLoad函数做太多的操作,只是返回了代表当前JNI版本为1.6的常量,这是Dalvik VM支持的一个版本,下面是array.c代码:

#include <jni.h>
#include <android/log.h>
#include "com_example_liyuanjing_jniproject_NativeSorting.h"
void quicksort(int *arr, int start, int end);
JNIEXPORT jint JNI_OnLoad(JavaVM *vm, void *reserved) {
    return JNI_VERSION_1_6;
}
JNIEXPORT void JNICALL Java_com_example_liyuanjing_jniproject_NativeSorting_nativeSort
  (JNIEnv *env, jobject obj, jintArray data) {
    jint* array = (*env)->GetIntArrayElements(env, data, 0);
    jint length = (*env)->GetArrayLength(env, data);
    quicksort(array, 0, length);
    (*env)->ReleaseIntArrayElements(env, data, array, 0);
}
void quicksort(int *arr, int start, int end)
{
    int i, j, temp;
    for (i = 0; i < end-1; i++)
    {
        for (j = 0; j < end - i-1; j++)
            {
                if (*(arr+j) < *(arr+j+1))
                    {
                        temp = *(arr+j);
                        *(arr+j) = *(arr+j+1);
                        *(arr+j+1) = temp;
                    }
            }
    }
}


这个示例中,函数GetIntArrayElements,GetArrayLength和ReleaseIntArrayElements都是特定的JNI代码。第一个函数得到一个本地数据指针,以便把数据传给普通的C函数;第二个函数返回数据的大小;第三个函数告诉JVM本地端的工作已经完成,需要把数组复制回原地。这些函数都是必须的,因为从Java到JNI传送复杂的数据类型时必须通过JNIEnv对象来完成。


注意:调用GetIntArrayElements返回一个jint指针,指向函数中jintArray里的数据,接下来就可以把jint指针作为普通int类型指针来使用。


2.Android实现JNI


要想Android能运行起来,必须到NDK目录android-ndk-r10d\samples\native-activity\jni目录下拷贝Android.mk,到刚才放置com_example_liyuanjing_jniproject_NativeSorting.h和array.c同一目录下,当然还要更改Android.mk的几个值。


LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE    := sorting_jni
LOCAL_SRC_FILES := array.c
include $(BUILD_SHARED_LIBRARY)
$(call import-module,android/native_app_glue)


一.LOCAL_PATH := $(call my-dir)

一个Android.mk file首先必须定义好LOCAL_PATH变量。它用于在开发树中查找源文件。在这个例子中,宏函数’my-dir’, 由编译系统提供,用于返回当前路径(即包含Android.mk file文件的目录)。


二.include $(CLEAR_VARS)

CLEAR_VARS由编译系统提供,指定让GNU MAKEFILE为你清除许多LOCAL_XXX变量(例如 LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES, 等等...),


除LOCAL_PATH 。这是必要的,因为所有的编译控制文件都在同一个GNU MAKE执行环境中,所有的变量都是全局的。


三.LOCAL_MODULE    := sorting_jni

LOCAL_MODULE变量必须定义,以标识你在Android.mk文件中描述的每个模块。名称必须是唯一的,而且不包含任何空格。注意编译系统会自动产生合适的前缀和后缀,换句话说,一个被命名为'sorting_jni'的共享库模块,将会生成'libsorting_jni'文件。


重要注意事项


如果你把库命名为‘libhelloworld’,编译系统将不会添加任何的lib前缀,也会生成libhelloworld.so,这是为了支持来源于Android平台的源代码的Android.mk文件,如果你确实需要这么做的话。


四.LOCAL_SRC_FILES := array.c

   LOCAL_SRC_FILES变量必须包含将要编译打包进模块中的C或C++源代码文件。注意,你不用在这里列出头文件和包含文件,因为编译系统将会自动为你找出依赖型的文件;仅仅列出直接传递给编译器的源代码文件就好。【注意,默认的C++源码文件的扩展名是’.cpp’. 指定一个不同的扩展名也是可能的,只要定义LOCAL_DEFAULT_CPP_EXTENSION变量,不要忘记开始的小圆点(也就是定义为‘.cxx’,而不是‘cxx’)(当然这一步我们一般不会去改它)】


五.include $(BUILD_SHARED_LIBRARY)

BUILD_SHARED_LIBRARY是编译系统提供的变量,指向一个GNU Makefile脚本(应该就是在build/core目录下的shared_library.mk),负责收集自从上次调用'include $(CLEAR_VARS)'以来,定义在LOCAL_XXX变量中的所有信息,并且决定编译什么,如何正确地去做。并根据其规则生成静态库。同理对于静态库。


当配置完上面所说的一个C头文件,一个.c文件,一个Android.mk文件后,进入CMD到当前目录中。输入ndk-build命令:

[armeabi] Compile thumb  : sorting_jni <= array.c
[armeabi] SharedLibrary  : libsorting_jni.so
[armeabi] Install        : libsorting_jni.so => libs/armeabi/libsorting_jni.so


如果没有意外会显示上述正确结果。


然后在Android Studio项目的app/src/main/目录下建立jinLibs目录将生成的libs目录中的文件拷贝到JinLibs目录中。如下图所示:


2.png


然后调用此方法,就可以实现Android使用JNI的功能了。

05-25 20:02:46.720  32349-32349/com.example.liyuanjing.jniproject I/liyuanjinglyj﹕ 9
05-25 20:02:46.720  32349-32349/com.example.liyuanjing.jniproject I/liyuanjinglyj﹕ 8
05-25 20:02:46.720  32349-32349/com.example.liyuanjing.jniproject I/liyuanjinglyj﹕ 7
05-25 20:02:46.720  32349-32349/com.example.liyuanjing.jniproject I/liyuanjinglyj﹕ 6
05-25 20:02:46.720  32349-32349/com.example.liyuanjing.jniproject I/liyuanjinglyj﹕ 5
05-25 20:02:46.720  32349-32349/com.example.liyuanjing.jniproject I/liyuanjinglyj﹕ 4
05-25 20:02:46.720  32349-32349/com.example.liyuanjing.jniproject I/liyuanjinglyj﹕ 3
05-25 20:02:46.720  32349-32349/com.example.liyuanjing.jniproject I/liyuanjinglyj﹕ 2
05-25 20:02:46.720  32349-32349/com.example.liyuanjing.jniproject I/liyuanjinglyj﹕ 1


之前的JNI例子只是演示用的,开发者应该使用Arrays.sort()或Collections.sort()来进行排序。通常不需要在本地进行排序,因为Java实现已经够快了。

相关文章
|
2月前
|
Java
让星星⭐月亮告诉你,jdk1.8 Java函数式编程示例:Lambda函数/方法引用/4种内建函数式接口(功能性-/消费型/供给型/断言型)
本示例展示了Java中函数式接口的使用,包括自定义和内置的函数式接口。通过方法引用,实现对字符串操作如转换大写、数值转换等,并演示了Function、Consumer、Supplier及Predicate四种主要内置函数式接口的应用。
32 1
|
3月前
|
Java
java基础(11)函数重载以及函数递归求和
Java支持函数重载,即在同一个类中可以声明多个同名方法,只要它们的参数类型和个数不同。函数重载与修饰符、返回值无关,但与参数的类型、个数、顺序有关。此外,文中还展示了如何使用递归方法`sum`来计算两个数之间的和,递归的终止条件是当第一个参数大于第二个参数时。
35 1
java基础(11)函数重载以及函数递归求和
|
2月前
|
Java 编译器 C语言
【一步一步了解Java系列】:Java中的方法对标C语言中的函数
【一步一步了解Java系列】:Java中的方法对标C语言中的函数
32 3
|
2月前
|
编译器 Android开发
配置环境变量,使CMakeLists.txt可直接使用Android NDK工具链编译项目
配置环境变量,使CMakeLists.txt可直接使用Android NDK工具链编译项目
|
3月前
|
Java Android开发 C++
🚀Android NDK开发实战!Java与C++混合编程,打造极致性能体验!📊
在Android应用开发中,追求卓越性能是不变的主题。本文介绍如何利用Android NDK(Native Development Kit)结合Java与C++进行混合编程,提升应用性能。从环境搭建到JNI接口设计,再到实战示例,全面展示NDK的优势与应用技巧,助你打造高性能应用。通过具体案例,如计算斐波那契数列,详细讲解Java与C++的协作流程,帮助开发者掌握NDK开发精髓,实现高效计算与硬件交互。
169 1
|
4月前
|
存储 搜索推荐 Java
探索安卓开发中的自定义视图:打造个性化UI组件Java中的异常处理:从基础到高级
【8月更文挑战第29天】在安卓应用的海洋中,一个独特的用户界面(UI)能让应用脱颖而出。自定义视图是实现这一目标的强大工具。本文将通过一个简单的自定义计数器视图示例,展示如何从零开始创建一个具有独特风格和功能的安卓UI组件,并讨论在此过程中涉及的设计原则、性能优化和兼容性问题。准备好让你的应用与众不同了吗?让我们开始吧!
|
4月前
|
Java 调度 Android开发
Android经典实战之Kotlin的delay函数和Java中的Thread.sleep有什么不同?
本文介绍了 Kotlin 中的 `delay` 函数与 Java 中 `Thread.sleep` 方法的区别。两者均可暂停代码执行,但 `delay` 适用于协程,非阻塞且高效;`Thread.sleep` 则阻塞当前线程。理解这些差异有助于提高程序效率与可读性。
87 1
|
4月前
|
IDE Java Linux
探索安卓开发:从基础到进阶的旅程Java中的异常处理:从基础到高级
【8月更文挑战第30天】在这个数字时代,移动应用已经成为我们日常生活中不可或缺的一部分。安卓系统由于其开放性和灵活性,成为了开发者的首选平台之一。本文将带领读者踏上一段从零开始的安卓开发之旅,通过深入浅出的方式介绍安卓开发的基础知识、核心概念以及进阶技巧。我们将一起构建一个简单的安卓应用,并探讨如何优化代码以提高性能和应用的用户体验。无论你是初学者还是有一定经验的开发者,这篇文章都将为你提供宝贵的知识和启发。
|
4月前
|
存储 运维 Java
函数计算产品使用问题之怎么配置定时触发器来调用Java函数
函数计算产品作为一种事件驱动的全托管计算服务,让用户能够专注于业务逻辑的编写,而无需关心底层服务器的管理与运维。你可以有效地利用函数计算产品来支撑各类应用场景,从简单的数据处理到复杂的业务逻辑,实现快速、高效、低成本的云上部署与运维。以下是一些关于使用函数计算产品的合集和要点,帮助你更好地理解和应用这一服务。