美文网首页Android JNINDKAndroid知识
NDK开发从放弃到入门

NDK开发从放弃到入门

作者: GordenNee | 来源:发表于2017-05-24 15:59 被阅读127次

    1.NDK简介

    1.1、NDK和 So

    ​ NDK 全称 Native Development Kit,是Google在Android开发中提供的一套用于快速创建native工程的一个工具。从上图这个Android系统框架来看,我们上层是通过JNI方式来调用NDK层的,使用这个工具可以很方便的编写和调试JNI的代码。因为C语言不跨平台,在Windows系统下使用NDK编译在Linux下能执行的函数库——SO文件,全称Shared Objects,其实质就是一堆c、c++的头文件和实现文件打包成一个库。目前Android系统目前支持以下七种不同的CPU架构,每一种对应着各自的应用程序二进制接口ABI:(Application Binary Interface)定义了二进制文件(尤其是.so文件)如何运行在相应的系统平台上,从使用的指令集,内存对齐到可用的系统函数库。

    • ARMv5——armeabi

    • ARMv7 ——armeabi-v7a

    • ARMv8——arm64- v8a

    • x86——x86

    • MIPS ——mips

    • MIPS64——mips64

    • x86_64——x86_64

      ​应该尽可能的提供专为每个ABI优化过的.so文件,(尽量不要混合着使用)。应该为每个ABI目录提供对应的.so文件。当一个应用安装在设备上,只有该设备支持的CPU架构对应的.so文件会被安装。在x86设备上,libs/x86目录中如果存在.so文件的 话,会被安装,如果不存在,则会选择armeabi-v7a中的.so文件,如果也不存在,则选择armeabi目录中的.so文件(因为x86设备也支 持armeabi-v7a和armeabi)。ps: Native Libs Monitor 这个应用可以帮助我们理解手机上安装的APK用到了哪些.so文件,以及.so文件来源于哪些函数库或者框架。

    1.2 、JNI

    ​ JNI 全称Java Native Inteface,即Java本地接口,是Java中定义的一种用于连接Java和C/C++接口的一种实现方式。Java语言装载到虚拟机中,不能和硬件交互,不能驱动开发。JNI扩展了Java虚拟机的能力,驱动开发、无线热点共享,底层语言(C、C++)效率高,数学运算、实时渲染的游戏,音视频处理等等,简而言之,就是Java代码调用c、c++代码,JNI模式一共涉及到三个角色:C/C++ 代码本地方法接口类Java层中具体业务类

    1.3、JNI的变量类型与Java类型对比表
    Java中变量的类型 JNI对应的类型名 C/C++变量类型
    boolean jboolean unsigned char
    float jfloat float
    double jdouble double
    byte jbyte signed char
    char jchar unsigned short
    short jshort short
    int jint/jsize int
    long jlong long long
    Object jobject void *
    String jstring void *
    3、JNI的基本语法
    • 命名规则

      JNIExport jstring JNICALL Java_com_example_hellojni_HelloJni_stringFromJNI( JNIEnv * env,jobject thiz ) 
      
      这里写图片描述
    • Java端加载so

     System.loadLibrary("helloJni");//加载so文件,不要带上前缀lib和后缀.so11
    
    • Java端的调用jni
    ((TextView)findViewById(R.id.jni_text)).setText(helloJni());
    

    2.传统的NDK开发方法:

    2.1 NDK开发环境配置:
    2.2 代码开发

    ​ 在Java代码中声明Native方法,命令行进入当前类所在的src/main/Java 目录,然后 javah +com…(包名+类名) ,会在src下生成当前类中Native方法的声明头文件,对Native方法进行声明。

    public static native int EncodeInit(int speexMode);
    

    ​ 手动新建c/c++文件,用于编写JNI代码,需要实现.h文件中所声明的方法。

    ​ 因为Eclipse或Android Studio 并不支持c/c++的代码开发,因此需要在在VS等c/c++开发平台开发Native代码,并完成测试。

    2.3 对需要生成的so包进行配置

    ​ 将开发完成的Native文件全部导入Android工程jni目录下,并编写Android.mk和Application.mk文件,对需要生成的so包进行配置。

    • Application.mk目的是描述在你的应用程序中所需要的模块(即静态库或动态库),如下是表示编译出所有对应的平台。
     APP_ABI := all
    
    • Android.mk是Android提供的一种makefile文件,用来指定诸如编译生成so库名、引用的头文件目录、需要编译的.c/.cpp文件和.a静态库文件等。
    LOCAL_PATH := $(call my-dir)
    
    include $(CLEAR_VARS)
    
    LOCAL_MODULE    := hello-jni   //ps:生成的so文件名格式为:lib+声明的so名字
    LOCAL_SRC_FILES := hello-jni.c
    
    include $(BUILD_SHARED_LIBRARY)
    
    2.4 生成so包

    命令行下进入JNI代码所在位置,执行ndk-build 便会生成指定的so。

    2.5 引用so包

    ​ 首先在Gradle中引用so包

        sourceSets{
            main {
                jniLibs.srcDirs 'libs'
            }
        }
    

    ​ 在java的native方法声明处加载so包:

    static {
            try {
                System.loadLibrary("hello-jni");
                mIsloaded = true;
            } catch (UnsatisfiedLinkError e) {
                Logging.e(TAG, "", e);
            }
    
        }
    
    public static native int EncodeInit(int speexMode);
    
    

    3.Android Studio 新的 ndk-build

    ​ Android Studio 在2.2增加了对NDK的支持,这里主要指ndk-build 和cMake。这里的ndk-build 是相对于以前的ndk-build更加方便。

    开发步骤:

    3.1 环境配置

    ​ 需要在gradle.properties中支持NDK开发

    android.useDeprecatedNdk=true
    
    3.2 声明一个原生的方法
    public class NdkJniUtils {
      
        static {
            System.loadLibrary("native-lib");   
        }
      
        public native String getString();
    
    }
    
    3.3 头文件的生成

    ​ 命令行进入当前类所在的src/main/Java 目录,然后 javah +com…(包名+类名) ,会在src下生成当前类中Native方法的声明头文件,对Native方法进行声明。

    3.4 JNI代码的具体实现

    将.h文件移动到项目的JNI开发目录,并可根据需要改名。新建C/C++文件,对.h文件中的方法进行实现。

    3.5 Gradle配置

    ​ 在defaultConfig 中加入对NDK的一些配置

    ndk{
                moduleName "native-lib"         //生成的so名字
                abiFilters "armeabi", "armeabi-v7a", "x86"  //输出指定三种abi体系结构下的so库
            }
    

    直接编译生成so包并被引用。

    ps :直接使用so包进行开发

    ​ 1.上述过程编译成功后会在build/intermediates目录下生成对应的ABI的so包,可以直接拿来使用。

    ​ 2.将so包复制到项目的libs文件夹下

    ​ 3.在Gradle中引入so包:

    sourceSets{
            main {
                jniLibs.srcDirs=['libs']
            }
        }
    

    ​ 4.在native方法声明处直接加载so包就可以正常使用了

    static {
            System.loadLibrary("native-lib");   
        }
    

    ​ 5.这个时候因为是直接使用so包,那么我们的jni目录下的jni代码以及NDK{}配置均可移除。

    4. cMake -崭新的开发方式

    4.1 主要优点:
    • 便于管理引用的第三方包
    • 最重要!旧的JNI开发 JNI代码文件满屏的红色报错,没有任何代码提示! now,支持代码提示,支持自动创建方法!
    4.2 开发步骤

    (不需要配置gradle.properties中android.useDeprecatedNdk=true)

    1.声明一个原生的方法

    2.实现c/c++ 文件

    3.创建cMake脚本,编写cMakeLists.txt 文件

    4.提供一个指向 CMake 脚本文件的路径,将 Gradle 关联到原生库。Gradle 使用构建脚本将源代码导入Android Studio 项目并将原生库(SO 文件)打包到 APK 中。在Gradle中配置cMake

    defaultConfig {
            applicationId "com.iflytek.cmaketest"
            minSdkVersion 21
            targetSdkVersion 25
            versionCode 1
            versionName "1.0"
            testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
            externalNativeBuild {
                cmake {
                    cppFlags ""
                }
            }
            ndk {
                abiFilters "armeabi" 
            }
        }
    
    externalNativeBuild {
            cmake {
                path "CMakeLists.txt"
            }
        }
    
    4.3 cMakeList语法:

    cMakeLists文件位置可自定义,一般放在module的根目录下,对应Gradle中cmake的path路径

    # Sets the minimum version of CMake required to build your native library.
    # This ensures that a certain set of CMake features is available to
    # your build.
    
    cmake_minimum_required(VERSION 3.4.1)
    
    # Specifies a library name, specifies whether the library is STATIC or
    # SHARED, and provides relative paths to the source code. You can
    # define multiple libraries by adding multiple add.library() commands,
    # and CMake builds them for you. When you build your app, Gradle
    # automatically packages shared libraries with your APK.
    
    add_library( # Specifies the name of the library.
                 native-lib
    
                 # Sets the library as a shared library.
                 SHARED
    
                 # Provides a relative path to your source file(s).
                 src/main/cpp/native-lib.cpp )
      
    # Specifies a path to native header files. 
    include_directories(src/main/cpp/include/)
      
      
    

    1.基础使用:

    • cmake_minimum_required 表示所支持的CMake编译器最低版本(不重要)

    • addLibrary() 要求CMake根据指定的源文件生成库文件.

      其中第一个参数表示生成的库的名称,第二个参数选择[SHARED|STATIC|MODULE]其中的一个,表示生成的库的类型,第三个参数为所有的需要加入这个库的源文件地址。

    • 使用 add_library() 向您的 CMake 构建脚本添加源文件或库时,Android Studio 还会在您同步项目后在 Project 视图下显示关联的标头文件。不过,为了确保 CMake 可以在编译时定位您的标头文件,您需要将 include_directories() 命令添加到 CMake 构建脚本中并指定标头的路径.

    2.进阶使用:

    • 上述是使用我们自己写的jni代码,如果需要依赖第三方的so包,并在此基础上进行JNI开发,需要引入第三方库

      add_library(
                  fmodL  
                  SHARED
                  IMPORTED)
      set_target_properties(
                  fmodL
                  PROPERTIES IMPORTED_LOCATION
                  ../../../../libs/${ANDROID_ABI}/libfmodL.so
      
    • 在调式的时候我们需要进行打log,这个使用就需要引入log库,那么我们就要引入系统的NDK API。

      find_library( # Defines the name of the path variable that stores the
                    # location of the NDK library.
                    log-lib
      
                    # Specifies the name of the NDK library that
                    # CMake needs to locate.
                    log )
        
      # Links your native library against one or more other native libraries.
      target_link_libraries( # Specifies the target library.
                             native-lib
      
                             # Links the log library to the target library.
                             ${log-lib} )
      

    5.对比分析

    5.1三种方式优缺点
    改进ndk-build 原始ndk-build cMake
    优点 1.三方源代码保留,可以随时查看 1.支持动态调试 1.支持代码提示 2.代码调试 3.管理方便
    缺点 1.不支持代码编辑,调试 1.不支持代码提示 1.每次调试都需要编译JNI
    5.2 推荐方案

    相关文章

      网友评论

      • 宇宙只有巴掌大:博主我想问一下如果我生成so库拿去给别的项目使用但是别的项目的包名和类名全都和native 方法不一致,这样不是有问题了?应为java代码这块的包名类名还有方法名称都要和cpp 里面的代码对应啊。我有点疑惑
        宇宙只有巴掌大:可不可以这么理解 用so库调用别人的so库写自己的native方法,还有一个是直接调用自己的so库。
        宇宙只有巴掌大:@GordenNee 我想到一个方法 也没问题 就是 不管你so 怎么写,Java 这块 按照cpp里面的包名类名方法名打成jar包供其他项目使用。也可以不过我不知道是不是所有的共别人使用的so库都是这么干的。
        GordenNee:我的理解:1.如果是用标准的c/c++ 生成的so库,比如你编译ffmpeg生成so,这个时候想要在Android工程中使用,你必须要手动写jni调用so包里的东西。 2.如果你把ffmpeg的so包跟你的jni打成一个新的so包,那么这个so包是只能在你的项目工程直接使用,就是你说的方法名对应。

      本文标题:NDK开发从放弃到入门

      本文链接:https://www.haomeiwen.com/subject/valoxxtx.html