NDK开发从放弃到入门

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 推荐方案
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,383评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,522评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,852评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,621评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,741评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,929评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,076评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,803评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,265评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,582评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,716评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,395评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,039评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,027评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,488评论 2 361
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,612评论 2 350

推荐阅读更多精彩内容