本篇入门教程开发环境为mac + Android Studio + gradle 2.14.1,主要包含以下3块内容:

  • NDK环境搭建

  • 编写第一个JNI项目

  • 打包出动态so文件,在其他项目中使用

一、NDK环境搭建

  1. 从Android Studio安装(自行×××)
    打开AndroidStudio,选择顶部工具条,Tools->Android->SDK Manager->SDK Tools->NDK 点击install

  2. 自行下载ndk包

    1)国内推荐通过 AndroidDevTools镜像 下载,或者Google的官方网站下载Android NDK的安装包 https://developer.android.com/ndk/downloads/index.html

    Android Studio之NDK环境搭建,so文件打包以及使用_第1张图片

    NDK r13b

    2)下载ndk包后解析到某个路径,打开Project Structure->设置 NDK location

    Android Studio之NDK环境搭建,so文件打包以及使用_第2张图片

    AndroidDevTools 下载

  3. ndk环境变量配置,我们需要使用到ndk-build命令
    打开终端 -> 输入 :vim ~/.bash_profile -> 加入ndk 包的路径(mac中环境变量之间以封号隔开)

自此,ndk开发环境我们已经可以进行jni开发了

二、JNI开发

  1. 创建android项目

  2. 查看项目local.properties中加入ndk和sdk的路径是否正确 

    ndk.dir=/Users/userName/AndroidStudioProjects/ndk/android-ndk-r13b
    sdk.dir=/Users/userName/Library/Android/sdk
  3. 配置项目下的gradle.properties文件,表示我们要使用NDK进行开发。 

    android.useDeprecatedNdk=true
  4. 在moudle根目录下的的build.gradle中的defaultConfig标签内部里加入如下代码 

    ndk{    
    moduleName "hello"       //生成的so文件名字,调用C程序的代码中会用到该名字    abiFilters "armeabi", "armeabi-v7a", "x86" //输出指定三种平台下的so库,// 还可以添加 'x86_64', 'mips', 'mips64'}
  5. 编写jni代码

    package com.david.ndktest;
    -public class MainActivity extends AppCompatActivity { //使用静态代码块,表示我们要加载的资源文件为libsecret.so
     static {
         System.loadLibrary("secret");
     } @Override
     protected void onCreate(Bundle savedInstanceState) {     super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
         TextView tv_msg = (TextView) findViewById(R.id.tv_msg);
         tv_msg.setText(stringFromat());
    
     } //声明一个本地方法,用native关键字修饰
     public native String stringFromat();
    }
  6. 生成.h头文件

    直接使用Android Studio 底部的Terminal,默认命令行窗口路径已经在当前项目,进入到app/src/main/java目录,输入以下命令(固定格式:javah -jni 包名+类名)

    javah -jni com.david.ndktest.MainActivity

    为在对应包的根目录下生成.h文件,熟悉该函数名后,日常开发中可以不用生成.h文件

    Android Studio之NDK环境搭建,so文件打包以及使用_第3张图片

    生成头文件

  7. 执行第5部的时候,对应native会提示找不到对应方法,快捷键 alt+enter 会生成对应jni文件夹,包含libName.c文件,此处MainActivity中的native方法还是会显示红色,但是不影响编译

    Android Studio之NDK环境搭建,so文件打包以及使用_第4张图片

    生成.c文件

  8. 编译项目后会发现app/build中已经生成so文件,并且已经对应的cpu包就是我们在gradle中已经配置的,并且已经调用成功

    Android Studio之NDK环境搭建,so文件打包以及使用_第5张图片

    build中生成对应so文件

    Android Studio之NDK环境搭建,so文件打包以及使用_第6张图片

    成功调用native方法

自此我们的第一个JNI项目已经编写完毕

三、打包出动态so文件,在其他项目中使用

有时候我们的需求是这样的,我们把一些比较重要的业务逻辑封装到ndk内部,对java层只暴露接口。我们就需要打包出so文件,并且可能需要在其他项目中使用,下面将介绍so(符合JNI标准)文件的打包,以及在其他项目中如何正确的调用

  • 编写Android.mk文件,放到jni文件夹根目录,与.c文件同级

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := secret //lib 名LOCAL_SRC_FILES := \
    /Users/userName/AndroidStudioProjects/NdkTest/app/src/main/jni/secret.c \ //.c文件名include $(BUILD_SHARED_LIBRARY)
  • 使用ndk-build命令(需要配置ndk环境变量,参照第一步第3点),生成so文件

    进入到main目录后在terminal中输入命令,ndk-build工具便会帮我们打包出所有cpu平台so文件(目前不知道如何设置需要打包cpu平台)

    ndk-build

    Android Studio之NDK环境搭建,so文件打包以及使用_第7张图片

    building so文件

Android Studio之NDK环境搭建,so文件打包以及使用_第8张图片

main根目录下生成lib,obj目录

  • 其他项目中使用该so文件 

    • 拷贝so文件到项目的main/jniLibs目录

    • ==新建package,包名与类名以及方法名必须与生成so文件的类保持一致!==

    • 使用方法与第二部一致,需要声明loadLibrary与native方法 

      Android Studio之NDK环境搭建,so文件打包以及使用_第9张图片

  • 调用native方法

    com.keywea.duolintest;
    -public class MainActivity extends AppCompatActivity { @Override
     protected void onCreate(Bundle savedInstanceState) {     super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
         TextView tv_msg = (TextView) findViewById(R.id.tv_msg);
         tv_msg.setText(com.david.ndktest.MainActivity.stringFromat());
    
     }
    }

自此我们已经能够接入符合JNI标准的so库,重点在于包名,类名,方法名需要与so库保持一致,因此我们在提供so库的时候一定要记录详细的交互文档