Android Studo jni开发入门——看我就够了!

2017-03-31

此贴记录一下Android Studio 进行jni开发的基础配置以及入门教程，想当初使用eclipse配置ndk环境都难，现在基本都向AS转型，特此给需要帮助的新手村的同学们少走弯路☺

一、环境配置

主要需要配置的就是NDK（Native Development Kit），现在Android studio很便利，可以一键下载：
file → setting → 按截图找到如下路径 → 选择NDK → 确定应用下载

NDK安装

安装完成以后就可以开撸了

二、jni hello world!

1. 新建一个项目

新建一个app，测试jni开发

2.设置支持jni

打开gradle.properties，添加：
1
android.useDeprecatedNdk=true
打开local.properties，添加：
1
ndk.dir=NDK的路径
最后打开app内build.gradle，在android/defaultConfig下面添加ndk配置

apply plugin: 'com.android.application'

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.0"
    defaultConfig {
        applicationId "com.lilei.testjni"
        minSdkVersion 15
        targetSdkVersion 25
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"


        ndk {
            moduleName "JNISample"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    compile 'com.android.support:appcompat-v7:25.3.1'
    compile 'com.android.support.constraint:constraint-layout:1.0.0-alpha8'
    testCompile 'junit:junit:4.12'
}

moduleName 表示编译出的so文件的名字

3.新建java访问c层的接口类

创建一个Jni的工具类，并定义接口函数，函数关键字用native（static用不用均可）

package com.lilei.testjni;

/**
 * Created by lilei on 2017/3/29.
 */

public class JniUtils {

    public static native String getJniString();

}

getJniString()方法即要与C层的交互的函数

4.生成头文件

“make-project”编译完成

打开终端，运行

1 2	cd app/build/intermediates/classes/debug/ javah com.lilei.testjni.JniUtils

运行成功之后打开app/build/intermediates/classes/debug/ 即可找到编译出的头文件”com_lilei_testjni_JniUtils.h”，不难发现头文件名是有原报名+类名组成

生成头文件

5.创建jni开发的文件夹

点击app文件夹，New → Folder → JNI Folder, 选择在main文件夹下即可，生成成功后main目录下会出现一个jni的文件夹
找到刚才生成到头文件，复制到jni文件夹下（记得关闭刚才使用的终端，否则无法复制）
头文件有了，现在在jni目录下创建一个C++文件用于开发使用，命名与头文件相同
编写C++文件中定义函数的代码

#include "com_lilei_testjni_JniUtils.h"

JNIEXPORT jstring JNICALL Java_com_lilei_testjni_JniUtils_getJniString
        (JNIEnv *env, jclass) {
    // new 一个字符串，返回Hello World
    return env -> NewStringUTF("Hello World");
}

6.java层加载so

回到JniUtils，加上

1
2
3

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

加载so

7.运行Run

调用jni的函数

package com.lilei.testjni;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        Log.i("Jni", JniUtils.getJniString());

    }
}

至此就成功运行出jni的Hello World了

三、生成so文件

前文介绍如何运行C++程序，但是实际开发中大多是封装编译出so文件后进行开发，就类似java里面的jar包

1.配置NDK环境变量

找到Android Studio安装的NDK包的文件目录（E:\AndroidStudioSDK\SDK\ndk-bundle），添加到系统的环境变量中

2.新建mk文件

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)

LOCAL_MODULE := JNISample
LOCAL_SRC_FILES := com_lilei_testjni_JniUtils.cpp

include $(BUILD_SHARED_LIBRARY)

在jni目录下新建Application.mk文件

APP_STL := gnustl_static
APP_CPPFLAGS := -frtti -fexceptions -std=c++0x
APP_ABI := armeabi-v7a
APP_PLATFORM := android-18

3.编译生成so

打开终端cd到jni目录下
调用ndk-build开始编译so
1
ndk-build
运行无误的话会如图所示
运行成功之后即会看到main文件夹下多了libs和obj的文件夹，里面就是生成的各种CPU的so文件

libs和obj里面都有so文件，两者的区别google给出的解释是：
As part of the build process, the files in the libs folder have been stripped of symbols and debugging information. So you’ll want to keep two copies of each of your .so files: One from the libs folder to install on the Android device, and one from the obj folder to install for GDB to get symbols from.
也就是说，libs目录下生成的库是剥离了符号表与调试信息的，而obj下的库是带有调试信息的。

至此jni的开发入门已完成

四、jni常用类型和方法

jni也有自己特定的语法，完成入门教程的同学想进阶的话可以查看这篇博客，该博主汇总收集了jni的常用方法和类型