Android JNI入门

已于 2023-12-12 11:54:28 修改
阅读量811 收藏 1
点赞数 2
分类专栏： jni 文章标签： java jvm c++
于 2022-08-09 18:08:26 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/lepaitianshi/article/details/126253106
版权

JNI数据类型及与Java数据类型的映射关系

Java数据类型JNI数据类型
bytejbyte
charjchar
shortjshort
intjint
longjlong
floatjfloat
doublejdouble

java数据类型与签名类型的对应关系

Java类型类型签名
booleanZ
byteB
intI
charC
shortS
longL
floatF
doubleD
voidV
数组[类型签名，比如String[] 是[Ljava/lang/String;
类L全限定名;，比如String, 其签名为Ljava/lang/String;(注意后面有个分号)

静态注册函数

根据函数名来建立 java 方法与 JNI 函数的一一对应关系；
命名规则如下：Java+方法的全路径（路径中一定要用“_”代替Java全路径里面的"“.”）
固定模式1：每个函数头部必须包含extern “C” JNIEXPORT <函数的返回类型> JNICALL
固定模式2：每个函数的入参必须包含JNIEnv env, jclass clazz

  jobject与jclass通常作为JNI函数的第二个参数，当所声明Native方法是静态方法时，对应参数jclass，因为静态方法不依赖对象实例，而依赖于类，所以参数中传递的是一个jclass类型。相反，如果声明的Native方法时非静态方法时，那么对应参数是jobject

在MainActivity里面定义了一个native方法:

 public native String stringFromJNI();

按照命名对应规则，JNI层的函数注册为：

extern "C" JNIEXPORT jstring JNICALL
Java_com_anniljing_jnidemo_MainActivity_stringFromJNI(
        JNIEnv *env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    LOGD("Get native message success");
    return env->NewStringUTF(hello.c_str());
}

问题1：正常情况下，光标放在native方法上，然后使用快捷键alt+enter会有Create JNI function for setMode提示，选择Create JNI function for setMode,会快速帮我们创建对应的cpp文件，
在这里插入图片描述
如果没有的话，需要我们手动创建，手动输入是不存在的，还是把光标放在对应的native方法之上，复制提示的内容，然后加上头部固定模式就可以了。
在这里插入图片描述

动态注册函数

原理：利用 RegisterNatives 方法来注册 java 方法与 JNI 函数的一一对应关系；
实现流程：
1、实现 JNI_OnLoad 方法，该方法在jni.h的头文件中定义，其中还定义了JNI_OnUnload方法，在加载动态库后，执行动态注册;

JNIEXPORT jint JNI_OnLoad(JavaVM* vm, void* reserved);
JNIEXPORT void JNI_OnUnload(JavaVM* vm, void* reserved);

JNIEXPORT int JNICALL JNI_OnLoad(JavaVM *vm, void *reserved) {
}

2、调用 FindClass 方法，获取 java 对象；

 jclass jcls;
    jcls = env->FindClass(name);
    if (jcls == nullptr) {
        return JNI_FALSE;
    }

3、利用结构体 JNINativeMethod 数组记录 java 方法与 JNI 函数的对应关系；

typedef struct {
    const char* name;
    const char* signature;
    void*       fnPtr;
} JNINativeMethod;

name为java层的方法名，signature为java层的参数和返回值的类型签名，fnPtr为jni层方法名

static JNINativeMethod gMethods[] = {
        {"sum",             "(II)I",                (void *) sum},
        {"getNativeString", "()Ljava/lang/String;", (void *) getMessage}
};

4、调用 RegisterNatives 方法，传入 java 对象，以及 JNINativeMethod 数组，以及注册数目完成注册；

 if (env->RegisterNatives(jcls, methods, nMethods) < 0) {
        return JNI_FALSE;
    }

JNI层访问Java层类属性

JNI获取属性方法含义
GetFieldID(jclass clazz, const char* name, const char* sig)获取属性Id,形参：clazz-java类，name-java类属性名，sig-java类属性类型签名
GetObjectField(jobject obj, jfieldID fieldID)获取属性为对象的
GetBooleanField(jobject obj, jfieldID fieldID)获取类型为布尔值的属性
GetByteField(jobject obj, jfieldID fieldID)获取类型为byte的属性
GetCharField(jobject obj, jfieldID fieldID)获取类型为Char的属性
GetShortField(jobject obj, jfieldID fieldID)获取类型为Short的属性
GetIntField(jobject obj, jfieldID fieldID)获取类型为Int的属性
GetLongField(jobject obj, jfieldID fieldID)获取类型为long的属性
GetFloatField(jobject obj, jfieldID fieldID)获取类型为float的属性
GetDoubleField(jobject obj, jfieldID fieldID)获取类型为double的属性

JNI层设置Java层类属性值

JNI设置属性方法含义
SetObjectField(jobject obj, jfieldID fieldID, jobject value)设置类型为Object的属性值
SetBooleanField(jobject obj, jfieldID fieldID, jobject value)设置类型为Boolean的属性值
SetByteField(jobject obj, jfieldID fieldID, jobject value)设置类型为Byte的属性值
SetCharField(jobject obj, jfieldID fieldID, jobject value)设置类型为Char的属性值
SetShortField(jobject obj, jfieldID fieldID, jobject value)设置类型为Short的属性值
SetIntField(jobject obj, jfieldID fieldID, jobject value)设置类型为Int的属性值
SetLongField(jobject obj, jfieldID fieldID, jobject value)设置类型为Long的属性值
SetFloatField(jobject obj, jfieldID fieldID, jobject value)设置类型为Float的属性值
SetDoubleField(jobject obj, jfieldID fieldID, jobject value)设置类型为Double的属性值

第一步、获取到Java类

jclass jc = env->GetObjectClass(people);

第二步、GetFieldID方法获取到Java层类属性

jfieldID fidAge = env->GetFieldID(jc, "age", "I");

第三步、调用SetXXXField()方法，为java层的类属性设置值

env->SetIntField(people, fidAge, 18);

JNI层访问Java层类成员方法

第一步、获取Java类

jclass jc = env->GetObjectClass(people);

第二步、调用GetMethodID（）方法，获取jMethodID

jmethodID jMethod = env->GetMethodID(jc, "doIntroduce", "()V");

第三步、调用CallVoidMethod（）方法，调用Java类成员方法

 env->CallVoidMethod(people, jMethod);

问题1：新增加的AndroidLog.h的头文件一直无法预编译<android/log.h>和<jni.h>头文件

AndroidLog.h

//头文件只有被其他CPP文件依赖以后才能正常导入
#include <android/log.h>
#include <jni.h>

#ifndef JNIDEMO_ANDROIDLOG_H
#define JNIDEMO_ANDROIDLOG_H

#define TAG "JniDemo"

#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG,TAG ,__VA_ARGS__) // 定义LOGD类型
#define LOGI(...) __android_log_print(ANDROID_LOG_INFO,TAG ,__VA_ARGS__) // 定义LOGI类型
#define LOGW(...) __android_log_print(ANDROID_LOG_WARN,TAG ,__VA_ARGS__) // 定义LOGW类型
#define LOGE(...) __android_log_print(ANDROID_LOG_ERROR,TAG ,__VA_ARGS__) // 定义LOGE类型
#define LOGF(...) __android_log_print(ANDROID_LOG_FATAL,TAG ,__VA_ARGS__) // 定义LOGF类型
#endif //JNIDEMO_ANDROIDLOG_H

<android/log.h>

/*
 * Copyright (C) 2009 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#pragma once

/**
 * @addtogroup Logging
 * @{
 */


#include <stdarg.h>
#include <stddef.h>
#include <stdint.h>
#include <sys/cdefs.h>

#if !defined(__BIONIC__) && !defined(__INTRODUCED_IN)
#define __INTRODUCED_IN(x)
#endif

#ifdef __cplusplus
extern "C" {
#endif

/**
 * Android log priority values, in increasing order of priority.
 */
typedef enum android_LogPriority {
  /** For internal use only.  */
  ANDROID_LOG_UNKNOWN = 0,
  /** The default priority, for internal use only.  */
  ANDROID_LOG_DEFAULT, /* only for SetMinPriority() */
  /** Verbose logging. Should typically be disabled for a release apk. */
  ANDROID_LOG_VERBOSE,
  /** Debug logging. Should typically be disabled for a release apk. */
  ANDROID_LOG_DEBUG,
  /** Informational logging. Should typically be disabled for a release apk. */
  ANDROID_LOG_INFO,
  /** Warning logging. For use with recoverable failures. */
  ANDROID_LOG_WARN,
  /** Error logging. For use with unrecoverable failures. */
  ANDROID_LOG_ERROR,
  /** Fatal logging. For use when aborting. */
  ANDROID_LOG_FATAL,
  /** For internal use only.  */
  ANDROID_LOG_SILENT, /* only for SetMinPriority(); must be last */
} android_LogPriority;

int __android_log_write(int prio, const char* tag, const char* text);

int __android_log_print(int prio, const char* tag, const char* fmt, ...)
    __attribute__((__format__(printf, 3, 4)));

int __android_log_vprint(int prio, const char* tag, const char* fmt, va_list ap)
    __attribute__((__format__(printf, 3, 0)));

void __android_log_assert(const char* cond, const char* tag, const char* fmt, ...)
    __attribute__((__noreturn__)) __attribute__((__format__(printf, 3, 4)));

/**
 * Identifies a specific log buffer for __android_log_buf_write()
 * and __android_log_buf_print().
 */
typedef enum log_id {
  LOG_ID_MIN = 0,

  /** The main log buffer. This is the only log buffer available to apps. */
  LOG_ID_MAIN = 0,
  /** The radio log buffer. */
  LOG_ID_RADIO = 1,
  /** The event log buffer. */
  LOG_ID_EVENTS = 2,
  /** The system log buffer. */
  LOG_ID_SYSTEM = 3,
  /** The crash log buffer. */
  LOG_ID_CRASH = 4,
  /** The statistics log buffer. */
  LOG_ID_STATS = 5,
  /** The security log buffer. */
  LOG_ID_SECURITY = 6,
  /** The kernel log buffer. */
  LOG_ID_KERNEL = 7,

  LOG_ID_MAX,

  /** Let the logging function choose the best log target. */
  LOG_ID_DEFAULT = 0x7FFFFFFF
} log_id_t;

int __android_log_buf_write(int bufID, int prio, const char* tag, const char* text);

int __android_log_buf_print(int bufID, int prio, const char* tag, const char* fmt, ...)
    __attribute__((__format__(printf, 4, 5)));

struct __android_log_message {
  size_t
      struct_size;   /** Must be set to sizeof(__android_log_message) and is used for versioning. */
  int32_t buffer_id; /** {@link log_id_t} values. */
  int32_t priority;  /** {@link android_LogPriority} values. */
  const char* tag;   /** The tag for the log message. */
  const char* file;  /** Optional file name, may be set to nullptr. */
  uint32_t line;     /** Optional line number, ignore if file is nullptr. */
  const char* message; /** The log message itself. */
};


typedef void (*__android_logger_function)(const struct __android_log_message* log_message);

typedef void (*__android_aborter_function)(const char* abort_message);

#if !defined(__ANDROID__) || __ANDROID_API__ >= 30

void __android_log_write_log_message(struct __android_log_message* log_message) __INTRODUCED_IN(30);

void __android_log_set_logger(__android_logger_function logger) __INTRODUCED_IN(30);

void __android_log_logd_logger(const struct __android_log_message* log_message) __INTRODUCED_IN(30);

void __android_log_stderr_logger(const struct __android_log_message* log_message)
    __INTRODUCED_IN(30);

void __android_log_set_aborter(__android_aborter_function aborter) __INTRODUCED_IN(30);

void __android_log_call_aborter(const char* abort_message) __INTRODUCED_IN(30);

void __android_log_default_aborter(const char* abort_message) __attribute__((noreturn))
__INTRODUCED_IN(30);

int __android_log_is_loggable(int prio, const char* tag, int default_prio) __INTRODUCED_IN(30);
int __android_log_is_loggable_len(int prio, const char* tag, size_t len, int default_prio)
    __INTRODUCED_IN(30);

int32_t __android_log_set_minimum_priority(int32_t priority) __INTRODUCED_IN(30);

int32_t __android_log_get_minimum_priority(void) __INTRODUCED_IN(30);

void __android_log_set_default_tag(const char* tag) __INTRODUCED_IN(30);
#endif

#ifdef __cplusplus
}
#endif

/** @} */

该头文件是系统下的log.h的头文件内容，里面定义了我们AndroidLog.h里面使用的__android_log_print方法，以及android系统log的等级。

typedef enum android_LogPriority {
  /** For internal use only.  */
  ANDROID_LOG_UNKNOWN = 0,
  /** The default priority, for internal use only.  */
  ANDROID_LOG_DEFAULT, /* only for SetMinPriority() */
  /** Verbose logging. Should typically be disabled for a release apk. */
  ANDROID_LOG_VERBOSE,
  /** Debug logging. Should typically be disabled for a release apk. */
  ANDROID_LOG_DEBUG,
  /** Informational logging. Should typically be disabled for a release apk. */
  ANDROID_LOG_INFO,
  /** Warning logging. For use with recoverable failures. */
  ANDROID_LOG_WARN,
  /** Error logging. For use with unrecoverable failures. */
  ANDROID_LOG_ERROR,
  /** Fatal logging. For use when aborting. */
  ANDROID_LOG_FATAL,
  /** For internal use only.  */
  ANDROID_LOG_SILENT, /* only for SetMinPriority(); must be last */
} android_LogPriority;

解决方法：

先创建空的AndroidLog.h文件，然后在其他的cpp源文件加入其预编译的头文件，重新编译一下，AndroidLog头文件再重新加入相关的头文件，编译即可通过

问题2：新增加jni_dynamic_load.cpp，实现动态注册jni，CMakeList.txt的编写如下：

image
新增了如下代码：

add_library(
        dynamicLoad-lib
        SHARED
        jni_dynamic_load.cpp
)

但是编译的时候，抛出之前的AndroidLog.h文件未定义的异常

555d51a695b861ed316cd118068eefb

解决方法：

1、把jni_dynamic_load.cpp放到 native-lib里面，CMakeList.txt如下：

cmake_minimum_required(VERSION 3.10.2)

project("jnidemo")


add_library(
        native-lib
        SHARED
        native-lib.cpp
        jni_dynamic_load.cpp
)
find_library(
        log-lib
        log
)
include_directories(${CMAKE_HOME_DIRECTORY}/base)
target_link_libraries(
        native-lib
        ${log-lib})

这样的话，就放在了一个库里面。

2、但是这不是我当初想要的效果，我是想生成两个库的。原因肯定是在连接库的地方出现了问题的，于是CMakeList.txt改为如下内容：

cmake_minimum_required(VERSION 3.10.2)

project("jnidemo")


add_library(
        native-lib
        SHARED
        native-lib.cpp
)
add_library(
        dynamicLoad-lib
        SHARED
        jni_dynamic_load.cpp
)
find_library(
        log-lib
        log
)
include_directories(${CMAKE_HOME_DIRECTORY}/base)
target_link_libraries(
        native-lib
        ${log-lib})
target_link_libraries(
        dynamicLoad-lib
        ${log-lib}
)

核心代码在于最下面第二个target_link_libraries，就是做了dynamicLoad-lib库与Log库的连接。

target_link_libraries(
        dynamicLoad-lib
        ${log-lib}

问题3：illegal class name

image
image

cpp文件是无法识别“.”的路径，要把“.”换成“/”即可

#define JAVA_CLASS "com/anniljing/jnidemo/JniDynamicLoad"

GitHub源码
官方地址：https://docs.oracle.com/en/java/javase/21/docs/specs/jni/index.html

余生爱静
关注
  • 2
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Android JNI入门Demo
02-15
这个"Android JNI入门Demo"是一个适合初学者了解和学习JNI基础操作的实践项目。 在Android开发中，JNI的应用场景广泛，例如：提升性能的关键算法实现、调用系统库、访问硬件设备、游戏开发中的图形渲染等。下面将...
android jni开发入门
05-10
Android JNI（Java Native Interface）开发入门是Android应用开发中的一个重要环节，它允许Java代码和其他语言写的代码进行交互。JNI在Android系统中起到了桥梁的作用，使得开发者可以利用C、C++等本地代码来实现...
[JNI] 开发基础（7）结构体
猫的阁楼
12-11 1222
基本定义：结构体，通俗讲就像是打包封装，把一些有共同特征（比如同属于某一类事物的属性，往往是某种业务相关属性的聚合）的变量封装在内部，通过一定方法访问修改内部变量。有点生硬，对于java程序员来说，结构体就相当于java model比如定义 personclass Person{ string name; int arg; string cardId; }对于c来说要把这个对
Android之 JNI详解
qq_29848853的博客
03-07 4995
Android JNI详解
Android NDK开发（二）——JNIEnv、jobject与jclass关系
最新发布
君莫笑lucky的博客
05-09 1325
本文主要讲解Android NDK开发中JNIEnv、jobject与jclass的相关知识，并用c和c++两种语言实现了jobject和jclass。
Android学习--JNI
a130226123的博客
08-17 1861
JNI学习
Android-JNI的简单使用
HZF
08-30 4821
一、什么是JNI 1、jni的含义 JNI即为java native interface Java本地接口；JNI是用来调用本地方法的技术，用来使Java和C/C++进行通信。 简单来说，Java运行一个程序需要和不同的系统进行交互，在windows里就要和windows底层平台交互，mac里就要和mac的底层平台交互， JVM就是通过大量的JNI技术能够使Java运行在不同的系统平台当中，与不同的系统平台底层进行交互。 2、Java与JNI类型对照表 基本类型对照 引用类型对照 3、什么是动态库 静态
Android JNI 学习实践
杨充
06-28 658
01.学习JNI开发流程1.1 JNI开发概念1.2 JNI和NDK的关系1.3 JNI实践步骤1.4 NDK使用场景1.5 学习路线说明02.NDK架构分层2.1 NDK分层构建层2.2 NDK分层Java层2.3 Native层03.JNI基础语法3.1 JNI三种引用3.2 JNI异常处理3.3 C和C++互相调用3.4 JNI核心原理3.5 注册Native函数3.6 JNI签名是什么04.一些必备操作4.1 so库生成打包。
Android jni 编程实例
09-08
在这个"Android jni 编程实例"中，我们将探讨如何在Android Studio环境下进行JNI开发，通过一个简单的入门demo来学习这个过程。 首先，我们需要了解JNI的基本概念。JNI是Java平台提供的一种接口，它允许Java代码...
Android Studio JNI编程入门实例
03-11
通过以上步骤，你已经成功实现了Android Studio中的JNI编程入门。然而，这只是基础，实际开发中可能需要处理更复杂的情况，如多线程、内存管理、错误处理等。同时，CMakeLists.txt作为现代的构建系统，提供了更多...
Android Studio JNI开发入门教程
03-14
Android Studio的JNI（Java Native Interface）开发入门教程 JNI，全称为Java Native Interface，是Java平台标准的一部分，它允许Java代码和其他语言写的代码进行交互。JNI在Android开发中扮演着重要角色，尤其当...
JNI层传递数据
05-17
jni获取内部类对象，多层结构体嵌套，jni层按位接收解析数据很方便
JNI入门Demo3.0
03-20
通过这个"JNI入门Demo3.0"，我们可以深入理解动态注册Native函数的概念和实现，从而在实际项目中更灵活地使用JNI。需要注意的是，动态注册虽然方便，但也需要谨慎处理，因为它可能会引入运行时错误，如方法签名不...
Android 入门JNI的函数统计
11-03
以前开发JNI是整理的一个JNI表格，都是常用的JNI函数，并且是个excel表格，方便查询，里面有各个函数的用法，挺好的资料，分享给大家参考
android jni helloword
06-23
"android jni helloworld"这个标题暗示我们将讨论一个简单的JNI入门教程，可能是通过一个实际的 HelloWorld 示例来介绍如何配置环境并进行调试。 在Android Studio 2.3.3中，配置JNI开发环境涉及以下步骤： 1. **...
Android jni demo
10-30
本示例“Android JNI Demo”提供了一个入门级别的工程，帮助开发者了解和学习如何在Android项目中使用JNI。 首先，我们需要理解JNI的基本概念。JNI是一个接口，使得Java虚拟机（JVM）能够调用本地（即非Java）代码...
Java进阶——JNI原理简介
qq_27752085的博客
02-11 371
JNI （Java Native Interface） Java源码层 —— JNI层 —— Native层 JNI（Java Native Interface）是Jave本地接口，是Java与其它语言之间相互调用的桥梁。 主要作用 解决无法用Java语言调用Java语言不支持的依赖于操作系统平台特性的一些功能的问题； 方便整合旧的非Java语言编写的系统代码； 为了提示性能...
【Android NDK 开发】JNI 方法解析 ( C/C++ 设置 Java 对象字段 | 查找字段 | 设置字段 )
让 学习 成为一种 习惯 ( 韩曙亮 の 技术博客 )
02-05 1837
I . 设置 Java 对象 属性 流程 II . 查找 Java 对象属性 ( GetFieldID ) III . 设置 Java 对象属性 ( GetFieldID )
java jni 结构体_JNI 返回结构体参数
weixin_39616477的博客
02-17 731
如何使用JNI的一些基本方法和过程在网上多如牛毛，如果你对Jni不甚了解，不知道Jni是做什么的，如何建立一个基本的jni程序，或许可以参考下面下面这些文章:利用VC++6.0实现JNI的最简单的例子JNI入门教程之HelloWorld篇SUN JNI Tutorial这些资料的例子中，大多数只是输入一些简单的参数，获取没有参数。而在实际的使用过程中，往往需要对参数进行处理转换。才可以被C/C++...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值