Android Studio引入ndk编译的so库, 通过jni给Java程序使用

前言

工作要求将一个C++老项目的函数用ndk打包成库给安卓同事的java程序调用。

这个任务我debuff拉满:

  • 自己之前从来没接触过安卓开发,问了老板为什么不让安卓开发来干,老板说安卓开发不懂c++,公司就我一个是懂c++的。。。
  • 项目开发年限超过十年,只在32位系统编译过,一些32位可以通过的代码到了64位就不行了,很多的库多少有些兼容问题
  • 项目开发环境全程断网,给开发带来诸多不便

感谢智谱和GPT4,最后花了几天还是摸清了一条路出来,不然可能过了一周都搞不清android.mk要怎么写。

不废话,笔记如下:

知识点记录:
NDK:Native Development Kit,是 Android 的一个工具开发包。NDK 可以看做是 Android 中实现 JNI 的一种手段(另一种是CMake),通过 NDK,还可以打包 C/C++ 动态库,并自动打包进 APK/AAR 中。我们可以到安卓官网下载NDK,可以直接执行NDK命令,也可以集成NDK到AndroidStudio中编译C/C++文件。

JNI:Java Native Interface,即 Java 本地接口。使得 Java 与本地其他类型语言(如 C、C++)交互。也就是在 Java 中调用 C/C++ 代码,或者在 C/C++ 中调用 Java 代码。JNI 是 Java 的,和 Android 无关。
.SO文件:so文件是Linux下的程序函数库,即编译好的可以供其他程序使用的代码和数据。一般来说.so文件就是常说的动态链接库, 都是C或C++编译出来的。与Java比较就是:它通常是用的Class文件(字节码)。Linux下的.so文件时不能直接运行的,一般来讲,.so文件称为共享库。

Android.mk :文件位于项目 jni/ 目录的子目录中,用于向编译系统描述源文件和共享库。它实际上是编译系统解析一次或多次的微小 GNU makefile 片段。Android.mk 文件用于定义 Application.mk、编译系统和环境变量所未定义的项目范围设置。它还可替换特定模块的项目范围设置。Android.mk 的语法支持将源文件分组为模块。模块是静态库、共享库或独立的可执行文件。

开发环境

OS:Windows 11

Android Studio版本:2021.3.1.17 Download link

NDK: r26d download link

开始操作

编译安卓so库

首先得搞清楚ndk-build怎么使用,这东西本质是对clang的封装, android.mk就相当于ndk的makefile,这里用一个c++的四则运算来讲。

创建这么个项目:

PS D:\MyCodeBase\ndk_test> ls
目录: D:\MyCodeBase\ndk_test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----         2024/7/13     17:34            594 android.mk
-a----         2024/7/13     17:29             71 application.mk
-a----         2024/7/13     17:27            838 mycal.cpp
-a----         2024/7/13     17:27            520 mycal.h

c++的四则运算类实现如下,我这里参考公司的实现方式,一个亮点是使用了工厂模式,头文件类只放基类,基类内全是纯虚函数(接口),实现在源文件里另有子类处理,头文件只提供creator创建实现类,返回基类指针,通过基类指针来操作接口方法。

// mycal.h

#ifndef MYCAL_H
#define MYCAL_H

#include <iostream>
#include <string>

// 运算接口基类
class Calculator {
public:
    virtual ~Calculator() = default;

    virtual double add(double a, double b) const = 0;
    virtual double sub(double a, double b) const = 0;
    virtual double mul(double a, double b) const = 0;
    virtual double div(double a, double b) const = 0;
};

// 非类成员工厂函数声明
Calculator* createCalculator();

#endif // MYCAL_H
// mycal.cpp

#include "mycal.h"
#include <stdexcept>

// 实现Calculator接口的具体类
class CalculatorImpl : public Calculator {
public:
    double add(double a, double b) const override {
        return a + b;
    }

    double sub(double a, double b) const override {
        return a - b;
    }

    double mul(double a, double b) const override {
        return a * b;
    }

    double div(double a, double b) const override {
        if (b != 0.0) {
            return a / b;
        } else {
            throw std::runtime_error("Division by zero.");
        }
    }
};

// 工厂函数实现
Calculator* createCalculator() {
    return new CalculatorImpl();
}

ndk-build通过android.mk和application.mk来控制编译,android.mk已经提过,什么是application.mk? 其实是另一个脚本,专门用于控制编译平台相关的东西,比如android平台版本,ABI架构,我在这个例子中指定平台为android-24,输出x86, x86_64, arm64-v8a, armeabi-v7a四种架构的so库。

#application.mk
APP_PLATFORM := android-24
APP_ABI := x86 x86_64 arm64-v8a armeabi-v7a
# android.mk
# build: ndk-build NDK_PROJECT_PATH="./" APP_BUILD_SCRIPT="./android.mk" NDK_APPLICATION_MK="./application.mk" V=1
LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE    := mycal 					#模块名
LOCAL_SRC_FILES := mycal.cpp   				#源文件路径
LOCAL_C_INCLUDES := $(LOCAL_PATH) 			#指定头文件搜索路径
LOCAL_CPPFLAGS := -fexceptions 				#启用throw错误,默认不启用会保存
LOCAL_LDLIBS    := -llog -lc++_shared 		#指定链接库, 其中c++_shared对于c++文件编译必须要加上,否则会报错

include $(BUILD_SHARED_LIBRARY)

ndk-build编译:

ndk-build NDK_PROJECT_PATH="./" APP_BUILD_SCRIPT="./android.mk" NDK_APPLICATION_MK="./application.mk" V=1

参数讲解:

NDK_PROJECT_PATH:指定ndk项目的根路径

APP_BUILD_SCRIPT:指定android.mk路径

NDK_APPLICATION_MK:指定application.mk路径

V=1:输出clang的编译日志,默认不输出

ndk-build的更多选项可见:ndk-build官方使用说明

命令编译成功后,应该会在目录下出现libs和objs两个文件夹,其中libs存在指定的各个架构下的so库:

PS D:\MyCodeBase\ndk_test> tree /F
卷 New Volume 的文件夹 PATH 列表
卷序列号为 6AC4-31C7
D:.
│  android.mk
│  application.mk
│  main.cpp
│  mycal.cpp
│  mycal.h
│
├─libs
│  ├─arm64-v8a
│  │      libmycal.so
│  │
│  ├─armeabi-v7a
│  │      libmycal.so
│  │
│  ├─x86
│  │      libmycal.so
│  │
│  └─x86_64
│          libmycal.so
│
└─obj
    ....

自此android程序需要的so库编译完成。

android studio的jni编程

打开android studio,新建一个native c++项目MyCalLib:

image-20240717111945879

在MyCalLib项目中,将ndk_test项目的libs文件夹拷贝到对应的libs文件夹(更老版本可能是jniLibs,不过我这个创建就有libs), 并将mycal.h拷贝到cpp文件夹,接着修改CMakeLists.txt将so库引入:

cmake_minimum_required(VERSION 3.18.1)

# Declares and names the project.

project("mycallib")


find_library(log-lib log)
find_library(c++_shared-lib c++_shared)

# Creates and names a library, sets it as either STATIC
# or SHARED, and provides the relative paths to its source code.
# You can define multiple libraries, and CMake builds them for you.
# Gradle automatically packages shared libraries with your APK.
set(my_lib_path ${CMAKE_SOURCE_DIR}/../../../libs)
add_library(mycal SHARED IMPORTED)
set_target_properties(mycal PROPERTIES IMPORTED_LOCATION ${my_lib_path}/${ANDROID_ABI}/libmycal.so)

add_library( # Sets the name of the library.
        mycallib

        # Sets the library as a shared library.
        SHARED

        # Provides a relative path to your source file(s).
        native-lib.cpp
        )


# Specifies libraries CMake should link to your target library. You
# can link multiple libraries, such as libraries you define in this
# build script, prebuilt third-party libraries, or system libraries.

target_link_libraries( # Specifies the target library.
        mycallib

        # Links the target library to the log library
        # included in the NDK.
        ${log-lib}
        ${c++_shared-lib}
        mycal
        )

image-20240717113422508

然后在MainActitivity.java声明jni接口:

    public native void calInit();
    public native double add(double a, double b);
    public native double sub(double a, double b);
    public native double mul(double a, double b);
    public native double div(double a, double b);

在native-lib.cpp实现这些jni接口,jni的命名方式为Java_包名_类名_方法名,不过AS下应该能自动生成函数签名。

#include <jni.h>
#include <string>
#include "mycal.h"


extern "C" JNIEXPORT jstring JNICALL
Java_com_example_mycallib_MainActivity_stringFromJNI(
        JNIEnv* env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}
Calculator* cal;
extern "C"
JNIEXPORT void JNICALL
Java_com_example_mycallib_MainActivity_calInit(JNIEnv *env, jobject thiz) {
    cal = createCalculator();
}
extern "C"
JNIEXPORT jdouble JNICALL
Java_com_example_mycallib_MainActivity_add(JNIEnv *env, jobject thiz, jdouble a, jdouble b) {
    return cal->add(a, b);
}
extern "C"
JNIEXPORT jdouble JNICALL
Java_com_example_mycallib_MainActivity_sub(JNIEnv *env, jobject thiz, jdouble a, jdouble b) {
    return cal->sub(a, b);
}
extern "C"
JNIEXPORT jdouble JNICALL
Java_com_example_mycallib_MainActivity_mul(JNIEnv *env, jobject thiz, jdouble a, jdouble b) {
    return cal->mul(a, b);
}
extern "C"
JNIEXPORT jdouble JNICALL
Java_com_example_mycallib_MainActivity_div(JNIEnv *env, jobject thiz, jdouble a, jdouble b) {
    return cal->div(a, b);
}

函数的生成结果需要在机子上测试,测试界面activity_main.xml准备四个文本框,分别显示四则运算的运算结果:

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/sample_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <TextView
        android:id="@+id/tv_add"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.554" />

    <TextView
        android:id="@+id/tv_sub"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.639" />

    <TextView
        android:id="@+id/tv_mul"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.502"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.683" />

    <TextView
        android:id="@+id/tv_div"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.744" />

</androidx.constraintlayout.widget.ConstraintLayout>

MainActivity.java测试代码:

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        binding = ActivityMainBinding.inflate(getLayoutInflater());
        setContentView(binding.getRoot());

        calInit();

        // Example of a call to a native method
        TextView tv_add = binding.tvAdd;
        TextView tv_sub = binding.tvSub;
        TextView tv_mul = binding.tvMul;
        TextView tv_div = binding.tvDiv;

        double val = add(5,6);
        tv_add.setText(String.valueOf(val));
        val = sub(11,10);
        tv_sub.setText(String.valueOf(val));
        val = mul(11, 10);
        tv_mul.setText(String.valueOf(val));
        val = div(12,7);
        tv_div.setText(String.valueOf(val));


    }

自此一切准备工作完毕,Device Manager>Create device创建一个安卓虚拟机,这里指定系统为x86,API 24。

image-20240717114626543

创建成功后build run, 如果运行成功,虚拟机应该会打开一个app,里面是activity_main.xml上测试代码的输出结果。

image-20240717115620697

坑点记录

  1. android studio不能用的太新,一开始直接官网下的最新的android studio koala 2024.1来弄,结果发现网上很多教程(包括AI回答)都停留在安卓的老版本,很多项目设置找不到,ndk路径设置找不到(后来才知道谷歌2021年出于多余理由把ndk选项从AS中移除了),这个版本用的gradle 8.0,build.gradle一些cmake和ndk的设置放到上面根本build不了,寒。。。最后请了安卓同事给我弄了这个老版本,gradle7.4,build.gradle的一些设置缺失果然就没了。

  2. android.mk编译的第三方so库如果有引入c++_shared.so库,AS中cmake版本太低是不会识别编译选项的,届时运行会在Logcat上报找不到库的错误,而升级cmake的提示,在有中间文件生成时是不会提醒的。就因为这个不会提示,我从下午4点一直被硬控到第二天下午3点。

image-20240717120039386

image-20240717120055924

解决方法:Tools>SDK Manager>SDK Tools, 找到CMake, 下载3.19以上的版本,可勾选Show Package Details看到版本信息。

image-20240717112751480

参考

https://developer.android.com/ndk/guides/android_mk?hl=zh-cn

ndk-build官方使用说明

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:/a/802796.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

自定义短语 - 那些年狠狠惊艳了我们的输入法使用技巧

你是不是每次注册或者登录的时候还在吭哧吭哧地输入你的电话号、邮箱或者昵称&#xff1f; 你是不是在填写各种信息的时候还在一次又一次地输入自己的身份证号、银行卡号或者车牌号&#xff1f; 而我只要输入“mail”&#xff0c;我的候选框里就有6个email号待我挑选&#xf…

css实现前端水印

单处水印 代码 <!DOCTYPE html> <html lang"en"> <head><meta charset"UTF-8"><meta name"viewport" content"widthdevice-width, initial-scale1.0"><title>Watermark Example</title>&l…

单片机设计_自行车码表(AT89C51, LCD1602, DS1302,霍尔传感器)

想要更多项目私wo!!! 一、电路设计 系统采用51单片机LCD1602液晶DS1302时钟模块霍尔传感器电机按键模块蜂鸣器报警模块设计而成。 产品自带单片机上电复位电路、手动复位电路&#xff08;复位按键&#xff09;、晶振电路&#xff08;给单片机提供时钟周期&#xff09;。 …

Java面试题--JVM大厂篇之深入解析JVM中的Serial GC:工作原理与代际区别

目录 引言&#xff1a; 正文&#xff1a; 一、Serial GC工作原理 年轻代垃圾回收&#xff08;Minor GC&#xff09;&#xff1a; 老年代垃圾回收&#xff08;Major GC或Full GC&#xff09;&#xff1a; 二、年轻代和老年代的区别 年轻代&#xff08;Young Generation&a…

数据库基础-进阶

数据库管理&#xff1a; *sql语句 数据库用来增删改查的语句 *** 备份 数据库的数据进行备份 * 主从复制&#xff0c;读写分离&#xff0c;高可用 原理 数据库的概念和相关的语法和规范&#xff1a; 数据库&#xff1a;组织&#xff0c;存储&#xff0c;管理数据的仓库。 数据…

Python用Pyqt5制作音乐播放器

具体效果如下 需要实现的功能主要的几个有&#xff1a; 1、搜索结果更新至当前音乐的列表&#xff0c;这样播放下一首是搜素结果的下一首 2、自动播放 3、滚动音乐文本 4、音乐进度条 5、根据实际情况生成音乐列表。我这里的是下面的情况&#xff0c;音乐文件的格式是 歌…

Calibration相机内参数标定

1.环境依赖 本算法采用张正友相机标定法进行实现&#xff0c;内部对其进行了封装。 环境依赖为 ubuntu20.04 opencv4.2.0 yaml-cpp yaml-cpp安装方式&#xff1a; &#xff08;1&#xff09;git clone https://github.com/jbeder/yaml-cpp.git #将yaml-cpp下载至本地 &a…

Fastjson解析JSON时key对应的value存在多个英文双引号解决

情景 如上图所示&#xff0c;经常在解析json时会出现因双引号报错的问题。 fastjson解决方案 JSONObject jsonfile JSONObject.parseObject(json, Feature.OrderedField);JSONArray jsonArray jsonfile.getJSONObject("result").getJSONArray("items");…

Linux网络编程-socket套接字使用详解

1.概念 在Linux中&#xff0c;套接字&#xff08;socket&#xff09;是一种通信机制&#xff0c;用于实现不同进程之间或同一主机上的不同线程之间的数据交换。它是网络编程的基础&#xff0c;允许应用程序通过网络进行通信&#xff0c;也可以在同一台机器上的不同进程间进行通…

ajax实时监控input搜索框并给提示词的事实举例的超全版本(上-不用字典树)

前言 感觉前面直接放概念和字典树还是差了点&#xff0c;有的看了概念还是没有思路的&#xff0c;于是写这篇文章来举例子&#xff0c;首先这不不包含字典树的版本&#xff0c;用字典树的版本等下会发。 需要的技术 jsp和ajax简单的理解&#xff0c;做示例的后端框架是sprin…

物流智能锁在物流锁控中的应用设计方案

一、案例介绍与问题剖析 &#xff08;一&#xff09;案例概述 某知名物流企业&#xff0c;拥有广泛的运输网络和多样化的客户群体&#xff0c;涵盖了制造业、零售业等多个领域。然而&#xff0c;随着业务规模的不断扩大&#xff0c;其在货物锁控方面遇到了一系列棘手的问题。…

Java | Leetcode Java题解之第238题除自身以外数组的乘积

题目&#xff1a; 题解&#xff1a; class Solution {public int[] productExceptSelf(int[] nums) {int length nums.length;// L 和 R 分别表示左右两侧的乘积列表int[] L new int[length];int[] R new int[length];int[] answer new int[length];// L[i] 为索引 i 左侧…

[C++] 深度剖析C_C++内存管理机制

文章目录 内存分布内存分布图解 C语言中动态内存管理方式malloc:callocrealloc C内存管理方式内置类型**自定义类型** operator new & operator deleteoperator new & operator delete函数operator newoperator delete **new T[N]** 与**delete[]** **定位new表达式(pl…

JavaScript基础(十四)

函数 很多人一看到这两个字就头大&#xff0c;可能由于多年被数学摧残有不小阴影&#xff0c;放心&#xff0c;我们这里的函数不是那些东西&#xff0c;在编程中我们的函数指的是: 程序的基本单元&#xff0c;是完成特定任务的代码语句块。 我们在写程序时&#xff0c;可能会…

【保姆级】Python项目部署到Linux生产环境(uwsgi+python+flask+nginx服务器)

1.安装python 我这里是3.9.5版本 安装依赖&#xff1a; yum install zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel gcc make -y 根据自己的需要下载对应的python版本&#xff1a; cd /usr/local wget https://www.python.or…

springboot机场投诉管理平台-计算机毕业设计源码22030

摘要 随着航空运输业的迅速发展&#xff0c;机场的客流量不断增加&#xff0c;旅客对机场服务的质量和效率也提出了更高的要求。为了提高机场的服务质量&#xff0c;及时处理旅客的投诉&#xff0c;建立一个高效、便捷的机场投诉管理平台显得尤为重要。 本项目旨在设计与实现一…

# ffmpeg 工具使用

文章目录 ffmpeg 工具使用1.图片转换2.图片转视频3.截取片段4. 视频格式转换5. 视频转图片方法一&#xff1a;方法二&#xff1a;生成更清晰无压缩的图片方式&#xff1a; ffmpeg 工具使用 windows安装教程&#xff1a;https://blog.csdn.net/csdn_yudong/article/details/129…

Python一对一辅导答疑|Rust 德国

你好&#xff0c;我是悦创。 下面是答疑内容。 在 Rust 中&#xff0c;方法的调用方式通常取决于它们是如何定义的。在你的例子中&#xff0c;print_drink方法最初是作为一个接受Drink类型实例作为参数的关联函数&#xff08;类似于静态方法&#xff09;定义的。后来&#xff…

紫外测熔融实验结果温度和abs作折线图和求一阶导最大值

import numpy as np import pandas as pd from pyecharts.charts import Line from pyecharts import options as opts from matplotlib import pyplot as plt import xlrd # 读取 csv 文件 data pd.read_excel(F:/LJX/lc8.xls)# 假设 csv 文件中有两列数据&#xff1a;x 和 y…

[transformer] Attention is all you need

1、目的 提出一种新的网络结构&#xff0c;不用CNN或者RNN&#xff0c;只基于self-attention 2、方法 * Norm: Layer Normalization 1&#xff09;Encoder -> -> self-attention的k、v、q来自上一个encoder层 2&#xff09;Decoder -> 由于每个位置i的预测只能参考i…