概述

• Android Studio2.2开始支持使用ndk-build来构建NDK项目。

目录结构

• tree 项目根目录/app/src/main，得到以下文件树：

├── AndroidManifest.xml
├── java
│   └── com
│       └── daking
│           └── app
│               └── ndkdemo
│                   ├── MainActivity.java
│                   ├── NDKUtil.java // NDK的Java调用工具类
│                   └── bean // 各实体类
│                       └── User.java
├── jni
│   ├── Android.mk
│   ├── Application.mk 
│   ├── api.c // 对外接口实现
│   ├── api.h // 对外接口定义
│   └── entrance.c // jni入口
└── res

build.gradle配置

• 指定Application.mk、输出abi等项目信息。

android {
    defaultConfig {
        externalNativeBuild {
            ndkBuild {
                // 指定Application.mk
                arguments "NDK_APPLICATION_MK:=src/main/jni/Application.mk" 
                // 输出ABI
                abiFilters "armeabi", "armeabi-v7a", "x86" 
                // c编译选项，可自定义，如ENABLE_DEBUG_LOG为控制是否输出debug日志
                cFlags "-DENABLE_DEBUG_LOG" 
            }
        }
    }
}

• 指定Android.mk。

android {
    externalNativeBuild {
        ndkBuild {
            path "src/main/jni/Android.mk"
        }
    }
}

文件详解

Application.mk

• 模板内容：

# 输出ABI
APP_ABI := armeabi

Android.mk

• 模板内容：

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

# 模块名，此处为最终生成的共享库库名
LOCAL_MODULE := nativecode
# 包含的头文件
LOCAL_C_INCLUDES := \
    $(NDK_PROJECT_PATH)
# 编译的源文件
LOCAL_SRC_FILES := \
    entrance.c \
    api.c
# 生成共享库
include $(BUILD_SHARED_LIBRARY)

api

• api为对Java等上层公开的接口。其中api.h为函数定义，api.c为实现。

• api.h模板内容：

#ifndef NDKDEMO_API_H
#define NDKDEMO_API_H

#include <jni.h>
#include <string.h>
#include <stdio.h>

jstring getLibName(JNIEnv* env, jobject obj);

#endif //NDKDEMO_API_H

• api.c模板内容：

#include <jni.h>
#include <string.h>
#include <stdio.h>

#include "api.h"

jstring getLibName(JNIEnv *env, jobject obj) {
    return (*env)->NewStringUTF(env, "nativecode lib!");
}

entrance.c

• App加载so库时，虚拟机首先会去执行JNI_OnLoad()。于是可在JNI_OnLoad方法中注册jni函数。

• 模板内容：

#include <jni.h>
#include <stdio.h>

#include "api.h"

// 各jni函数
static JNINativeMethod jniMethods[] = {
        {"getLibName", "()Ljava/lang/String;", (void*)getLibName}
        // 若有新jni方法，则用逗号分隔，添加新的元素。
};

int JNI_OnLoad(JavaVM *vm, void *reserved)
{
    JNIEnv *env;
    if ((*vm)->GetEnv(vm, (void **)&env, JNI_VERSION_1_4) != JNI_OK) {
        return JNI_ERR;
    }

    jclass cls = (*env)->FindClass(env, "com/daking/app/ndkdemo/NDKUtil");
    if (cls == NULL)
        return JNI_ERR;

    int len = sizeof(jniMethods) / sizeof(jniMethods[0]);
    (*env)->RegisterNatives(env, cls, jniMethods, len);

    return JNI_VERSION_1_4;
}

NDKUtil.java

• 模板内容：

package com.daking.app.ndkdemo;

public class NDKUtil {

    static {
        System.loadLibrary("nativecode");
    }

    public static native String getLibName();   
}