JNI开发(基于AS高低版本说明)

更新了Android Studio版本之后,在按照之前的方式搭建JNI的开发环境,发现不断的报错,通过查看日志发现,android.useDeprecatedNdk不再支持了让,使用CMake or ndk-build。本文介绍了在低版本和高版本上分别怎么实现,以及总结在搭建过程中遇到的错误和解决办法。

Android Studio 2.2版本以下

1.首先通过SDKManager-SDK Tools下载NDK插件

2.在local.properties文件里面配置NDK路径:

一种方式是在该文件中直接填写NDK的路径

另一种方式是在SDK Location里面配置:在项目上右键->选择open Moulde Settings

3.在在gradle.properties文件中追加下面代码:

android.useDeprecatedNdk=true

4.使用native关键字编写JNI接口

public class JNIUtils {
    public static native String getStringFromC();
}

编写之后,make project,在工程目build\intermediates\classes\debug\自己的包名下就可以看到编译后的class文件JNIUtils.class如下图所示:


5.使用javah命令生成.h头文件

5.1 打开Terminal,然后在命令行中先进入到工程的build\intermediates\classes\debug目录下(cd 直接拖拽debug目录即可)
5.2 输入命令:javah 包名.类名

javah com.bysj.myapplication.JNIUtils

在debug目录下就会生成对应的头文件(.h文件)


6. 实现上述头文件里面的方法

6.1 在main目录下新建jni文件夹



6.2 将上述的头文件复制进来,文件名可以随意该,但是内容不能改。
6.3 新建一个c或者c++源文件实现头文件中的方法,并在源文件中引入头文件(此处我自己建立的是C++的文件)

#include "com_bysj_jniapplication_JNIUtils.h" //头文件的名字要对应

JNIEXPORT jstring JNICALL Java_com_bysj_jniapplication_JNIUtils_getStringFromC
        (JNIEnv *env, jclass) {
    return env -> NewStringUTF("Hello from C++");
    }

7. 添加NDK配置

7.1 开发app内build.gradle,在android/defaultConfig下面添加ndk配置

android {
       。。。。。。
 defaultConfig {
      。。。。。。
        ndk {
            moduleName "JNISample" //生成so库的名字
        }
    }
    buildTypes {
    。。。。。。
    }
}

7.2 加载so库,在JNIUtils类中添加以下的代码:

public class JNIUtils {
    static {
        System.loadLibrary("JNISample");//名字要与build.gradle中配置的一致
    }
    public native static String getStringFromC();
}

最后编译运行,可以看到结果:


以上是在AS2.2版本以下这样做会成功,但是在2.2以后在编译的时候会报以下的错误:

我们仔细看下Log,大概意思就是说:

  1. android.useDeprecatedNdk不再支持了
  2. 让使用CMake or ndk-build
  3. 然后还有链接
    考虑使用CMake或ndk构建集成。要了解更多信息,请访问:
    https://d.android.com/r/studio-ui/add-native-code.html#ndkCompile
    首先,您可以使用Android的ndk构建脚本示例插件为您生成:
    /Users/apple/Desktop/AndroidJNITest/app/build/intermediates/ndk/debug/Android.mk
    或者,你可以使用实验插件:
    https://developer.android.com/r/tools/experimental-plugin.html
    继续使用已弃用的NDK编译60天,设置在gradle.properties
    android.deprecatedNdkCompileLease = 1523416167903(这个测试不起作用)
    经过各种查资料,发现原来在gradle3.0以上以前这种方法不再支持

所以在AS2.2版本以后进行NDK开发要使用CMake,下面演示以下具体的实现方法(你会发现很简单,省去类很多的事)

Android Studio 2.2版本以上

1. 先通过SDKManager下载:CMake和LLDB

2.在新建项目的时候勾选 Include C++ Support

接下来的步骤跟创建普通项目一样。

2.1 配置C++支持功能(Customize C++ Support)在Customize C++ Support界面默认即可。


  • C++ Standard

指定编译库的环境,其中Toolchain Default使用的是默认的CMake环境;C++ 11也就是C++环境。两种环境都可以编库,至于区别,后续会跟进,当前博文使用的是CMake环境。

  • Exceptions Support

如果选中复选框,则表示当前项目支持C++异常处理,如果支持,在项目Module级别的build.gradle文件中会增加一个标识 -fexceptions到cppFlags属性中,并且在so库构建时,gradle会把该属性值传递给CMake进行构建。

  • Runtime Type Information Support

同理,选中复选框,项目支持RTTI,属性cppFlags增加标识-frtti

点击完成,Android Studio会自动把JIN开发的环境搭建好,可以直接运行,比起低版本的是不是省很多事啊!

勾选了 Include C++ Support以后,会自动在build.gradle中添加以下配置

android {
    compileSdkVersion 27
    defaultConfig {
        。。。。。。。。
        externalNativeBuild {
            cmake {
                cppFlags ""
            }
        }
    }
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt" //该文件用于配置JNI项目属性
        }
    }
}

3.CMakeLists.txt文件说明

CMakeLists.txt文件用于配置JNI项目属性,主要用于声明CMake使用版本、so库名称、C/CPP文件路径等信息,下面是该文件内容:

# Sets the minimum version of CMake required to build the native
# library. You should either keep the default value or only pass a
# value of 3.4.0 or lower.

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 it for you.
# Gradle automatically packages shared libraries with your APK.

add_library( # Sets the name of the library.
            # 设置so文件名称
             native-lib

             # Sets the library as a shared library.
             SHARED

             # Provides a relative path to your source file(s).
             # Associated headers in the same location as their source
             # 设置这个so文件为共享.
             # file are automatically included.
             src/main/cpp/native-lib.cpp )

# Searches for a specified prebuilt library and stores the path as a
# variable. Because system libraries are included 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 the
# 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} )
  • cmake_minimum_required(VERSION 3.4.1)
    CMake最小版本使用的是3.4.1。

    • add_library()
      配置so库信息(为当前当前脚本文件添加库)

    • native-lib
      这个是声明引用so库的名称,在项目中,如果需要使用这个so文件,引用的名称就是这个。值得注意的是,实际上生成的so文件名称是libnative-lib。当Run项目或者build项目是,在Module级别的build文件下的intermediates\transforms\mergeJniLibs\debug\folders\2000\1f\main下会生成相应的so库文件。* SHARED
      这个参数表示共享so库文件,也就是在Run项目或者build项目时会在目录intermediates\transforms\mergeJniLibs\debug\folders\2000\1f\main下生成so库文。此外,so库文件都会在打包到.apk里面,可以通过选择菜单栏的Build->Analyze Apk...*查看apk中是否存在so库文件,一般它会存放在lib目录下。

    • src/main/cpp/native-lib.cpp
      构建so库的源文件。

STATIC:静态库,是目标文件的归档文件,在链接其它目标的时候使用。
SHARED:动态库,会被动态链接,在运行时被加载。
MODULE:模块库,是不会被链接到其它目标中的插件,但是可能会在运行时使用dlopen-系列的函数动态链接。
更详细的解释请参考这篇文章:C++静态库与动态库

下面的配置实际上与自定义的JNI项目(自定义的so库)没有太大关系。

  • find_library()
    这个方法与我们要创建的so库无关而是使用NDK的Apis或者库,默认情况下Android平台集成了很多NDK库文件,所以这些文件是没有必要打包到apk里面去的。直接声明想要使用的库名称即可(猜测:貌似是在Sytem/libs目录下)。在这里不需要指定库的路径,因为这个路径已经是CMake路径搜索的一部分。如示例中使用的是log相关的so库。

  • log-lib
    这个指定的是在NDK库中每个类型的库会存放一个特定的位置,而log库存放在log-lib中

  • log
    指定使用log库

  • target_link_libraries()
    如果你本地的库(native-lib)想要调用log库的方法,那么就需要配置这个属性,意思是把NDK库关联到本地库。

  • native-lib
    要被关联的库名称

  • ${log-lib}
    要关联的库名称,要用大括号包裹,前面还要有$符号去引用。

实际上,我们可以自己创建CMakeLists.txt文件,而且路径不受限制,只要在build.gradle中配置externalNativeBuild.cmake.path来指定该文件路径即可。

说明

AS2.2版本以后不会再创建jin文件夹,而创建的是cpp文件夹


总结

Android Studio2.2以上版本进行JNI开发,只需要在新建项目的时候勾选 Include C++ Support选项,AS会自动帮我们搭建好JNI开发环境,我们只需要改成我们需要的文件名即可。相比低版本的各种配置,是简单方便了很多。

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,333评论 25 707
  • 用两张图告诉你,为什么你的 App 会卡顿? - Android - 掘金 Cover 有什么料? 从这篇文章中你...
    hw1212阅读 12,677评论 2 59
  • 向您的项目添加 C 和 C++ 代码 本文内容 下载 NDK 和构建工具 创建支持 C/C++ 的新项目 构建和运...
    会飞的大象_阅读 3,744评论 0 3
  • 昨晚告诫自己一定不可以熬夜晚睡,强制自己10点关灯睡觉。今早6点半自然醒,神清气爽,把要做的的事在早上完成不是更好...
    KellyWei阅读 152评论 0 0
  • 琳经过一夜的思考,决定把玉叫过来商量一下。她跟玉直接了当的说,现在自己有个机会可以重新返回珠海,老板承诺加薪,毕竟...
    碎花纷飞阅读 278评论 1 2