Android NDK开发两部曲(一)之初识篇(JNI通识与NDK配置)

目录

Android NDK开发两部曲(一)之初识篇(JNI通识与NDK配置)
Android NDK开发两部曲(二)之应用篇(增量更新也就那样)

前言

之前发过一篇在Eclipse上关于JNI和NDK的博客Android JNI与Android NDK扫盲, 里面只是笼统地介绍了一下, 文章本身并没有深入学习的意思. 那么现在我们就开始在这篇文章的基础上, 在Android Studio上面去详细学习NDK开发吧.

JNI通识

NDK是什么

原生开发工具包 (NDK) 是一组可让您在 Android 应用中利用 C 和 C++ 代码的工具。 可用以从您自己的源代码构建,或者利用现有的预构建库。
-来自Google 官方文档

为什么要使用NDK

  • 从设备获取卓越性能以用于计算密集型应用,例如游戏或物理模拟。

  • 重复使用您自己或其他开发者的 C 或 C++ 库。

如果不满足上面的条件, 那么你还是不要引入NDK, 这样会把你的应用变得非常非常地复杂.

主要组件

ndk-build

ndk-build 脚本用于在 NDK 中心启动构建脚本

Java

Android 构建过程从 Java 来源生成 .dex (Dalvik EXecutable) 文件,这些文件是 Android OS 在 Dalvik 虚拟机(“DVM”)中运行的文件。 即使您的应用根本未包含任何 Java 源代码,构建过程仍会生成原生组件在其中运行的 .dex 可执行文件。

原生共享库

NDK 从原生源代码构建这些库或 .so 文件。

原生静态库

NDK 也可构建静态库或 .a 文件,您可以关联到其他库。

Java 原生接口 (JNI)

JNI 是 Java 和 C++ 组件用以互相沟通的接口。

应用二进制界面 (ABI)

ABI 可以非常精确地定义应用的机器代码在运行时如何与系统交互。 NDK 根据这些定义构建 .so 文件。 不同的 ABI 对应不同的架构:NDK 包含对 ARMEABI(默认)、MIPS 和 x86 的 ABI 支持。

清单文件

如果您要编写没有 Java 组件的应用,必须在清单文件中声明 NativeActivity 类。

两个重要的配置文件

Android.mk

必须在 jni 文件夹内创建 Android.mk 配置文件。 ndk-build 脚本将查看此文件,其中定义了模块及其名称、要编译的源文件、版本标志以及要链接的库。

概览

Android.mk 文件位于项目 jni/ 目录的子目录中,用于向构建系统描述源文件和共享库。事实上就是告诉ndk去编译哪些c/c++文件还有怎么去编译它们

NDK定义的变量

常用
编译目标目录声明
LOCAL_PATH := $(call my-dir)

必须定义, LOCAL_PATH表示需要编译的源文件的目录, $(call my-dir)表示使用宏函数my-dir的返回值, 对应的就是当前Android.mk的所在目录

重置全局变量
include $(CLEAR_VARS)

CLEAR_VARS变量指向特殊 GNU Makefile, 可为您清除许多LOCAL_XXX变量. 不包括LOCAL_PATH 因为系统在单一 GNU Make 执行环境(其中所有变量都是全局的)中解析所有构建控制文件. 在描述每个模块之前, 必须声明(重新声明)此变量

指定需要编译的模块
LOCAL_MODULE := recorder-jni
LOCAL_SRC_FILES := video.c audio.c

LOCAL_MODULE指定模块的名称, 唯一且不含空格, 之后会编译出librecorder-jni.so, 如果模块名已包含前缀lib, 则不会自动添加lib前缀.
LOCAL_SRC_FILES表示该模块需要编译哪些源文件, 多个源文件使用空格分割

上面的意思就是, 编译video.c和audio.c并输出为librecorder-jni.so

整合
include $(BUILD_SHARED_LIBRARY)

BUILD_SHARED_LIBRARY变量指向GNU Makefile脚本, 用于收集您自最近 include 后在 LOCAL_XXX 变量中定义的所有信息. 其实就是让上一次include到这里之间的内容生效

如果引用了其他的so文件, 那么ndk会清掉库目录下的所有so文件, 默认是jnilibs, 所以必须使用预构建库解决这问题

其他

构建系统提供许多可用于 Android.mk 文件中的变量。其中许多变量已预先赋值。 另一些变量由您赋值。

除了这些变量之外,您还可以定义自己的任意变量。在定义变量时请注意,NDK 构建系统会预留以下变量名称

  • 以 LOCAL_ 开头的名称,例如 LOCAL_MODULE。
  • 以 PRIVATE_、NDK_ 或 APP 开头的名称。构建系统在内部使用这些变量。
  • 小写名称,例如 my-dir。构建系统也是在内部使用这些变量。
    如果为了方便而需要在 Android.mk 文件中定义自己的变量,建议在名称前附加 MY_。
编译指定平台库
TARGET_ARCH_ABI := arm64-v8a

当构建系统解析此 Android.mk 文件时,此变量将 CPU 和架构的名称存储到目标。 您可以指定以下一个或多个值,使用空格作为多个目标之间的分隔符。其实就是指定需要编译的平台

CPU和架构 设置
ARMv5TE armeabi
ARMv7 armeabi-v7a
ARMv8 AArch64 arm64-v8a
i686 x86
x86-64 x86_64
mips32 (r1) mips
mips64 (r6) mips64
全部 all
指定Android版本
TARGET_PLATFORM := android-22

作为构建系统目标的 Android API 级别号

更多请参考Google文档的NDK 定义的变量

模块描述的变量

每个模块描述应遵守以下基本流程:

  • 使用 CLEAR_VARS 变量初始化或取消定义与模块相关的变量。

  • 为用于描述模块的变量赋值。

  • 使用 BUILD_XXX 变量设置 NDK 构建系统,以便为模块使用适当的构建脚本。

编译目录路径

LOCAL_PATH, 表示需要编译的源文件的目录

编译模块名称

LOCAL_MODULE, 指定模块的名称, 唯一且不含空格, 之后会编译出librecorder-jni.so, 如果模块名已包含前缀lib, 则不会自动添加lib前缀.

编译模块输出名称

LOCAL_MODULE_FILENAME, 真正的库输出文件名. 如果不喜欢系统自动生成的文件名, 可以指定这个值

LOCAL_MODULE := foo
LOCAL_MODULE_FILENAME := libnewfoo

上面表示输出libnewfoo.so

更多参考Google文档的模块描述变量

待编译的源文件

LOCAL_SRC_FILES,指定源文件列表, 多个文件使用空格分割. 可以使用相对文件路径(指向 LOCAL_PATH)和绝对文件路径

Application.mk

此文件枚举并描述您的应用需要的模块。 Android.mk有效的前提是依靠该文件的保证 位于jni的目录下

该文件信息包括:

  • 用于针对特定平台进行编译的 ABI。

  • 工具链。

  • 要包含的标准库(静态和动态 STLport 或默认系统)。

工程路径

APP_PROJECT_PATH, 应用项目根目录的绝对路径. 如果将Application.mk 文件放在 $NDK/apps/<myapp>/ 下,则必须定义此变量。 如果将其放在 $PROJECT/jni/ 下,则此变量可选。

编译平台

APP_ABI, 默认情况下, NDK 构建系统为 armeabi ABI 生成机器代码.多个值使用空格分割

指令集
基于 ARMv7 的设备上的硬件 FPU 指令 APP_ABI := armeabi-v7a
ARMv8 AArch64 APP_ABI := arm64-v8a
IA-32 APP_ABI := x86
Intel64 APP_ABI := x86_64
MIPS32 APP_ABI := mips
MIPS64 (r6) APP_ABI := mips64
所有支持的指令集 APP_ABI := all

编译Android版本

APP_PLATFORM, 此变量包含目标 Android 平台的名称.

其他

更多参考Google文档的Application.mk

由于Android Studio以强大的方式集成了NDK, 所以上面很多配置都不需要写. 方便了很多.

NDK配置

环境

环境 版本
OS OSX 10.12.3
IDE Android Studio 2.3
JDK Oracle JDK1.7

Android Studio 2.3集成NDK比以前方便多了, 因为NDK已经在SDK Manager中提供下载.

下载安装

File->Settings->Appearance & Behavior->System Settings->Android SDK->SDK Tools->勾上NDK->Apply->OK

NDK配置.png

然后就开始下载了, 下载完成后finish就可以了.

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

推荐阅读更多精彩内容