NDK开发第一课:环境配置与第一个JNI程序 - 阿飞的博客 - CSDN博客

标签: | 发表时间:2019-06-25 11:36 | 作者:
出处:https://blog.csdn.net

一、JNI 与 NDK

1. JNI 是什么

    JNI 是 Java Native Interface 的缩写,即 Java 的本地接口。
    目的是使得 Java 与本地其他语言(如 C/C++)进行交互。
    JNI 是属于 Java 的,与 Android 无直接关系。

2. NDK 是什么

    NDK 是 Native Development Kit 的缩写,是 Android 的工具开发包。
    作用是快速开发 C/C++ 的动态库,并自动将动态库与应用一起打包到 apk。
    NDK 是属于 Android 的,与 Java 无直接关系。

3. JNI 与 NDK 的关系

    JNI 是实现的目的,NDK 是 Android 中实现 JNI 的手段。

 

二、NDK 的下载

1. 官网下载

    地址为: https://developer.android.com/ndk/downloads/
    下载后直接解压即可,注意路径名不能带有中文或者空格。

2. Android Studio 中下载

    点开 Android Studio 的 SDK Manager 可以看到如下截图,这里我们选择下载红框中勾选的3个工具。

  • CMake:一个跨平台的编译构建工具,替代 Android.mk
  • LLDB:一个高效的 C/C++ 的调试工具
  • NDK:即我们需要下载的工具,会生成到 SDK 根目录下的 ndk-bundle 目录下

 

三、我的第一个 JNI 程序

1. 新建工程,并选择包含 C++ support,如下图所示

    在接下来向导中的 Customize C++ Support 部分,您可以使用下列选项自定义项目:

  • C++ Standard:使用下拉列表选择您希望使用哪种 C++ 标准。选择 Toolchain Default 会使用默认的 CMake 设置。
  • Exceptions Support:如果您希望启用对 C++ 异常处理的支持,请选中此复选框。如果启用此复选框,Android Studio 会将 -fexceptions标志添加到模块级 build.gradle 文件的 cppFlags 中,Gradle 会将其传递到 CMake。
  • Runtime Type Information Support:如果您希望支持 RTTI,请选中此复选框。如果启用此复选框,Android Studio 会将 -frtti 标志添加到模块级 build.gradle 文件的 cppFlags 中,Gradle 会将其传递到 CMake。

2. Android Studio 会自动帮你生成一个可执行的 Hello World 程序,我们简单看一下这个工程

    相比平常的 Android 工程,这里主要是多了上面截图中红框处的文件。其中 cpp 目录就是我们的 C/C++ 代码、预编译库的默认路径了,而 CMakeList.txt 就是编译的脚本文件了。

    接下来我们详细分析一下每一块的原理。

3. MainActivity

      public class MainActivity extends AppCompatActivity {
 
    // Used to load the 'native-lib' library on application startup.
    static {
        System.loadLibrary("native-lib");
    }
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
 
        // Example of a call to a native method
        TextView tv = (TextView) findViewById(R.id.sample_text);
        tv.setText(stringFromJNI());
    }
 
    /**
     * A native method that is implemented by the 'native-lib' native library,
     * which is packaged with this application.
     */
    public native String stringFromJNI();
}

    我们知道,Java 调用本地方法,是使用 native 关键字。而本例中,本地方法的实现是在一个叫做 “native-lib” 的动态库里(动态库的名称是在 CMakeList.txt 中指定的),要想使用这个动态库,就必须先加载这个库,即 System.loadLibrary(native-lib)。这些都是 Java 的语法定义。

4. native-lib.cpp

      #include <jni.h>
#include <string>
 
extern "C" JNIEXPORT jstring
 
JNICALL
Java_com_afei_jnidemo_MainActivity_stringFromJNI(
        JNIEnv *env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}

    上面提到的 public native String stringFromJNI()方法的实现就是在这里,那怎么知道 Java 中的某个 native 方法是对应的 cpp 中的哪个方法呢?这就和 JNI 的注册有关了,本例中使用的是静态注册,即 “Java 包名类名_方法名” 的形式,其中包名也是用下划线替代点号。

    后续章节将详细介绍 JNI 方法的注册,以及参数的转换等。

5. 整个调用流程就是:

  1. Gradle 调用您的外部构建脚本 CMakeLists.txt。
  2. CMake 按照构建脚本中的命令将 C++ 源文件 native-lib.cpp 编译到共享的对象库中,并命名为 libnative-lib.so,Gradle 随后会将其打包到 APK 中。
  3. 运行时,应用的 MainActivity 会使用 System.loadLibrary()加载原生库。现在,应用可以使用库的原生函数 stringFromJNI()
  4. MainActivity.onCreate() 调用 stringFromJNI(),这将返回“Hello from C++”并使用这些文字更新 TextView。

 

四、 手动配置  gradle 支持 NDK 开发

要手动配置 Gradle 以关联到您的原生库,需要将 externalNativeBuild {} 块添加到模块级 build.gradle 文件中,并使用 cmake {} 或 ndkBuild {} 对其进行配置:

      android {
  ...
  defaultConfig {...}
  buildTypes {...}
 
  // Encapsulates your external native build configurations.
  externalNativeBuild {
 
    // Encapsulates your CMake build configurations.
    cmake {
 
      // Provides a relative path to your CMake build script.
      path "CMakeLists.txt"
    }
  }
}

注意:

    如果您想要将 Gradle 关联到现有 ndk-build 项目,请使用 ndkBuild {} 块而不是 cmake {},并提供 Android.mk 文件的相对路径。如果 Application.mk 文件与您的 Android.mk 文件位于相同目录下,Gradle 也会包含此文件。

 

 

五、 CMakeLists.txt 简单分析

1. 首先我们看一下自动生成的 CMakeLists.txt 都有些什么内容

      # For more information about using CMake with Android Studio, read the
# documentation: https://d.android.com/studio/projects/add-native-code.html
   
# Sets the minimum version of CMake required to build the native library.
   
cmake_minimum_required(VERSION 3.4.1)
   
# 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.
   
add_library( # Sets 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 )
   
# Searches for a specified prebuilt library and stores the path as a
# variable. Because CMake includes system libraries in the search path by
# default, you only need to specify the name of the public NDK library
# you want to add. CMake verifies that the library exists before
# completing its build.
   
find_library( # Sets the name of the path variable.
              log-lib
   
              # Specifies the name of the NDK library that
              # you want CMake to locate.
              log )
   
# 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.
                       native-lib
   
                       # Links the target library to the log library
                       # included in the NDK.
                       ${log-lib} )

2. cmake_minimum_required

    指定 Cmake 需要的最低版本

3. add_library

    创建和命名该库,第一个参数是库的名字,例如取名为 native-lib,将会生成一个命名为 libnative-lib.so 的库。
    第二个参数是指定库的类型,一般为 SHARED,即动态库(以 .so 为后缀),还有一种是静态库 STATIC,即静态库(以 .a 为后缀)。
    第三个参数是指定该库使用的源文件路径。
    使用多个 add_library() 命令,您可以为 CMake 定义要从其他源文件构建的更多库。

4. find_library

    找到一个 NDK 的库,并且将这个库的路径存储在一个变量中。例如上例中是找到 NDK 中的 log 库(Android 特定的日志支持库),并将其路径存储在 “log-lib” 变量中,在后面你就可以通过 “${log-lib}” 命令取出变量中的值了。

5. target_link_libraries

    关联库。将指定的库关联起来 。

6. 注释应该基本也能看得懂,关于 CMake 的更多语法,将在后续章节介绍。

博客链接: CMakeLists.txt 语法介绍与实例演练

 

其它:

​NDK 学习系列: Android NDK 从入门到精通(汇总篇)

相关 [ndk 开发 第一课] 推荐:

NDK开发第一课:环境配置与第一个JNI程序 - 阿飞的博客 - CSDN博客

- -
    JNI 是 Java Native Interface 的缩写,即 Java 的本地接口.     目的是使得 Java 与本地其他语言(如 C/C++)进行交互.     JNI 是属于 Java 的,与 Android 无直接关系.     NDK 是 Native Development Kit 的缩写,是 Android 的工具开发包.

Android NDK开发Crash错误定位

- - 极客521 | 极客521
在Android开发中,程序Crash分三种情况:未捕获的异常、ANR(Application Not Responding)和闪退(NDK引发错误). 其中 未捕获的异常根据logcat打印的堆栈信息很容易定位错误. ANR错误也好查,Android规定,应用与用户进行交互时,如果5秒内没有响应用户的操作,则会引发ANR错误,并弹出一个系统提示框,让用户选择继续等待或立即关闭程序.

Android 之 JNI 开发 详解 - NDK从入门到精通

- - CSDN博客推荐文章
-- 第一个JNI示例程序下载 :  GitHub - https://github.com/han1202012/NDKHelloworld.git . JNI概念 : Java本地接口, Java Native Interface, 它是一个 协议, 该协议用来沟通Java代码和外部的本地C/C++代码, 通过该协议 Java代码可以调用外部的本地代码, 外部的C/C++ 代码可以调用Java代码;.

Android NDK开发扫盲及最新CMake的编译使用 - 简书

- -
本篇文章旨在简介 Android 中. NDK是什么以及重点讲解最新 Android Studio 编译工具. NDK之前还是首推 Android 官方. 官方文档分别从以下几个方面介绍了. ABI是什么以及不同 CPU 指令集支持哪些. 如何使用您自己及其他预建的库. 所以建议先浏览一遍文档,或者看完本篇文章再回头看一遍文档.

android NDK的学习

- - CSDN博客推荐文章
NDK是基于系统原生的C/C++的开发,但是它不是一种主流,而是Android SDK开发的有益补充,因为NDK没有提供界面,也没有提供生命周期管理这一类环境. NDK是一系列的工具包,使用这些工具包能够让我们很方便的进行JNI的开发. Java native interface,JNI就是java和C/C++相互调用的接口.

基于 Android NDK 的学习之旅-----数据传输一(基本数据类型和数组传输)(附源码)

- UnderSn0w - 博客园-首页原创精华区
基于 Android NDK 的学习之旅-----数据传输(基本数据类型和数组传输).        之前的一些文章都有涉及到上层和中间层的数据传输,简单来说,也就是参数和返回值的使用. 因为中间层要做的最多的也就是数据传输与转换,下面来介绍下这方面的知识.        数据传输可分为 基本数据类型传输 和 引用数据类型的传输 , 因为数组传输也比较特别(其实数组也是引用类型),所以这里也专门分出来讲讲.

让中国人还将汗颜百年的美国开学第一课

- - 废话一筐
让中国人还将汗颜百年的美国开学第一课. 去年,国产教育部从美国搬来了个《开学第一课》,并重金买来成龙操刀主演,结果骂声一片,今年只好偃旗息鼓,任由各学校胡乱折腾他们的《开学第一课》了. 我只是奇怪:原创不行,山寨咋也不行呢. 1910年,胡适考取“庚子赔款”第二期官费生赴美国留学,就读于康乃尔大学.

给年轻人的婚姻第一课:世界上没有“灵魂伴侣”存在

- - 36氪
编者按:关于爱情,它的复杂性不仅常常被忽视,还远远超过了我们常常关注的浪漫性,Northwestern University的一门课程试图教导学生如何建立健康的爱情关系. 本文作者 CHRISTINE GROSS-LOH,原文标题 The First Lesson of Marriage 101: There Are No Soul Mates.

Android开发Tips

- - CSDN博客推荐文章
欢迎Follow我的 GitHub, 关注我的 CSDN.. 介绍一些, 在Android开发中, 会经常使用的小知识点.. submodule与git可以保持实时同步. 导入, 路径多于一个, 前面不添加冒号(:).. 使用PackageManager.. // 检查App是否安装 private boolean appInstalledOrNot(String uri) {.

WPS for Linux 开发中

- Quantum - Wow! Ubuntu
据消息称,WPS for Linux 办公套件目前正在开发中,如图:. # 本文采用CC协议进行授权,转载本文请注明本文链接. - Twitter / 微博 / 问答 / 投稿 / 加入我们 wow0slx6bcs721xo1udcc. - 高性价比 Ubuntu VPS / 本站架设于 PhotonVPS / 定制 Ubuntu T-Shirt.