Android Studio上进行NDK编程之Hello world

Android Studio很早之前就支持NDK编程了，但是资料比较少，照着网上的写，一大堆的坑，各种错误一堆。

经过不断的努力，弄出了第一个能正常奔跑的NDK示例——Hello world。现整理如下：

我的配置：

Android Studio 3.0.0

Gradle 4.1

NDK 14

OpenJDK 8

总结一下流程：

1、下载与安装NDK（最好连CMake，LLDB也下了）

2、配置NDK环境变量（如果需要到处运行）

3、为项目配置NDK

4、编写java以及需要相关的C/C++代码

5、编译C/C++代码生成.so库文件

6、引入库文件，编译/调试/运行APP。

——————-

1、第一件要事就是下载NDK。

可以直接在Android Studio下载，也可以单独去下载。Android Studio下载的NDK默认放置于“android-sdk/ndk-bundle”路径下。

NDK版本集合：https://developer.android.google.cn/ndk/downloads/revision_history.html

NDK的官方示例：https://github.com/googlesamples/android-ndk（NDK10自带，13、14没看见）

在Android Studio下载更方便，Android Studio下载的是最新版——NDK14。顺便连CMake和LLDB也下载了。

CMake: C/C++的外部构建工具，可以提示代码什么的。

LLDB: 调试本地代码的工具。

如图：

 

 

 

 

2、配置NDK环境变量。

如果想要想java命令一样在CMD上，各种路径下到处跑ndk的命令，需要设置。最好设置。

类似java，将NDK安装目录丢到Path中即可。如：

新建变量

变量名：NDK_HOME

变量值：“D:\Programming\Android\android-sdk\ndk-bundle”

 

 

 

 

3、为项目配置NDK。

在开的项目的Android Studio中依次打开“File——Project Structure”，设置NDK路径并确定：

 

 

 

或者直接在项目的“local.properties”文件中添加NDK路径：

## This file is automatically generated by Android Studio.# Do not modify this file — YOUR CHANGES WILL BE ERASED!## This file must *NOT* be checked into Version Control Systems,# as it contains information specific to your local configuration.## Location of the SDK. This is only used by Gradle.# For customization when using a Version Control System, please read the# header note.#Wed Mar 22 18:21:45 CST 2017ndk.dir=D\:\\Programming\\Android\\android-sdk\\ndk-bundlesdk.dir=D\:\\Programming\\Android\\android-sdk

配置完，我感觉最好重启一下。。。我擦，未知原因，我的头一次使用ndk-build命令时提示不是内部或外部命令，也不是可运行的程序或批处理文件。

4、编写java以及相关的C/C++代码。

（1）新建JniLoader类。如：

package yue.excample.hello;/** * Created by Yue on 2017/3/19. */public class JniLoader {static {        System.loadLibrary(“firstndk”);    }public native StringgetHelloString();}

（2）编写C/C++文件。

在“项目/app/src/main/jni”路径下（没有jni文件夹就创建）新建C++资源文件，名字随便写，尽量规范易懂。我取名为JniLoaderndk.cpp,内容如下：

 

 

 

 

注意事项：如果编写的是C++代码，而不是C，应当注意使用extern “C”{}；上述代码注释部分有说明。

比较固定的写法，其中Java层的native方法getHelloString()对应的名称为Java_yue_simplendk_JniLoader_getHelloString，是一种全称的写法，Java代表java方法，接着是包名+方法名。包名的分隔符“.”号用“_”代替。两个参数貌似乎是C/C++的指针和java对象。

如果需要编写C/C++的头文件，可以使用javah命令来快速生成。首先要找到.class文件所在，没有需要先Make Project 一下。

Android Studio和eclipse目录不同，Android Studio在“项目/app/build/intermediates/classes/debug”下。

使用terminal进入该目录下，执行“javah -jni yue.simplendk.JniLoader”命令。

JniLoader类要写全名，即带包名的方式，不能直接为“javah -jni JniLoader”,会提示找不到类文件。成功则在debug目录下直接生成了规范的头文件了，丢过去用即可。

 

 

 

 

（3）Activity中使用：

 

 

 

 

5、编译C/C++文件为.so库。

编写Android.mk和Application.mk文件。

Android.mk指定.so文件名称：

 

 

 

 

Application.mk指定生成不同平台的.so库：

 

 

 

三种常用平台，不写则全部生成（armeabi arm64-v8a armeabi-v7a mips mips64 x86 x86_64）。架构不同有的不兼容。不写则全部生成。

在Terminal中使用cd 命令跳转到“jni”目录下，使用“ndk-build”命令编译C/C++文件。

生成结果如图：

 

 

 

题外话：

快速获取指定路径：Android Studio中选中文件(夹)，Ctrl+Shift+C复制路径,相当于鼠标右击——Copy Path。然后cd+粘贴路径即可。

另一个方法就直接跳转过去了：拖文件（夹）到Tirminal中。但是这么做的弊端是，清空了缓存的命令，也就是历史命令不能调出来了（windows的CMD中不会，只会把路径字符串放过来）。

6、引入.so文件，调试、运行

首先，马上要注意ndk-build命令生成的.so文件默认在src/main/libs目录下,此目录非Android Studio 默认的.so库目录，直接调试/运行会报错。要将.so文件全部移动到src/main/jniLibs中去。默认目录，可以修改。

打开app目录下的build.gralde，在android 节点下添加sourceSets部分，设置jni库的资源路径：

 

 

 

之后尝试调试/运行了,结构报错：

 

 

 

说的是项目包含C++文件，但是却没有使用能够支持的构建系统。考虑使用CMake，或者稳定的ndk集成插件进行构建。

看来，新版的有所问题。使用Cmake，额，这又是什么东东…好吧先不用它。。查资料，是这么解决的：在项目下的gradle.properties中增加一句：

android.useDeprecatedNdk=true

使用过时的NDK。

再次编译运行：

刚开始开这个错误日志有点懵了，但是我们仔细看一下会发现android.useDeprecatedNdk不在被支持了，但是在日志后面给了我们一个解决办法

To continue using the deprecated NDK compile for another 60 days, set android.deprecatedNdkCompileLease=1517304753794 in gradle.properties

大概意思是想要继续使用已弃用的NDK编译60天，在gradle.properties文件里把android.useDeprecatedNdk去掉换成android.deprecatedNdkCompileLease=1517304753794就行了，我猜有肯能每个人错误日志里得到android.deprecatedNdkCompileLease=1517304753794不一定一样，所以尽量使用自己错日志里的进行运行。

再次运行：

这是ndk 版本更新到16后出现的问题，修改如下：

1、删除application.mk；

2、app的build.gradle文件中修改如下：

android {

    compileSdkVersion26

    defaultConfig {

        //省略

        ndk{

            moduleName “NDK_01” //必须加上，否则在AS中就报错。

            ldLibs”log”,”z”,”m” //可以不写，在C代码打印Log

            abiFilters’armeabi-v7a’,’arm64-v8a’ // ‘x86’, ‘x86_64’ may be added

        }

    }

    sourceSets{

        main{

                jniLibs.srcDirs = [‘src/main/libs’]//Android Studio 默认的.so库目录src/main/jniLibs

        }

    }

    task ndkClean(type: Delete) {

        delete fileTree(‘.externalNativeBuild’) {

                exclude defaultConfig.ndk.abiFilters.collect {‘**/’ + it }

         }

      }

      tasks.findByPath(‘:clean’).dependsOn ndkClean

}

删除.so文件，再次ndk-build，并运行项目：

错误说的是文件重复，在app目录查看是否jniLibs目录下是否也生成了对应的so文件，由于在build.gradle已经指定so

文件目录为jniLibs.srcDirs = [‘src/main/libs’，所以将jniLibs目录下的so文件删除即可。