Skip to content

pengMaster/NDKJniDemo

Repository files navigation

项目简介

JNI:Java Native Interface(Java 本地编程接口),一套编程规范,它提供了若干的 API 实现了 Java 和其他语言的通信(主要是 C/C++)。Java 可以通过 JNI 调用本地的 C/C++ 代码,本地的 C/C++ 代码也可以调用 java 代码。Java 通过 C/C++ 使用本地的代码的一个关键性原因在于 C/C++ 代码的高效性。

NDK:Native Development Kit(本地开发工具),一系列工具的集合,提供了一系列的工具,帮助开发者快速开发 C/C++,极大地减轻了开发人员的打包工作。

项目环境

  • Android studio 3.1.2
  • gradle 4.4 plugin 3.1.2
  • targetSdkVersion 28

Jni三部曲

  • 1.新建Java文件编写相关代码
  • 2.通过命令工具Terminal生成.h文件
  • 3.新建.c 或者.cpp文件编写相关代码

环境配置

1.安装NDK+CMake

  • NDK:这套工具集允许为 Android 使用 C 和 C++ 代码。
  • CMake:一款外部构建工具,可与 Gradle 搭配使用来构建原生库。如果只计划使用 ndk-build,则不需要此组件。
Ps:CMake 是 AS 2.2 之后加入的一个跨平台的安装(编译)工具,可以用简单的语句来描述所有平台的安装(编译过程),简单来说就是简化 JNI 开发的编译步骤

2.NDK环境配置

1.local.properties
ndk.dir=D\:\\workTime\\android-studio-sdk-2.3\\android-studio-sdk-2.3\\ndk-bundle
sdk.dir=D\:\\workTime\\android-studio-sdk-2.3\\android-studio-sdk-2.3
2.gradle.properties
#gradle:3.0.1  studio3.0 之前用
android.useDeprecatedNdk=true
#gradle:3.0.1  studio3.0 之后用
android.deprecatedNdkCompileLease=1511832698813

3.build.gradle中添加CMake

android {
   .........
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
        }
    }
}

4.在app目录下新建CMakeLists.txt

CMakeLists.txt所在目录和上面path "CMakeLists.txt"相关连

CMakeLists.txt中内容如下:

# CMake的编译脚本配置文件

# 1. 标注需要支持的CMake最小版本
cmake_minimum_required(VERSION 3.4.1)

# 2. add_library 定义需要编译的代码库 名称, 类型, 包含的源码
add_library(
            # Sets the name of the library.
            JNIControl
            # Sets the library as a shared library.
            SHARED
            src/main/jni/JNIControl.cpp
)

# 3. find_library 定义当前代码库需要依赖的系统或者第三方库文件(可以写多个)
find_library(
        log_lib # 指定要查找的系统库, 给个名字
        log     # 真正要查找的liblog.so或者liblog.a
)

# 4. target_link_libraries设置最终编译的目标代码库
target_link_libraries(
     JNIControl  # add_library 生成的
     ${log_lib} # find_library 找到的系统库
)
}

到这里环境就搭建完成了,那么下面我们开始装逼了。。。

执行装逼三部曲

1.新建要编译成.h文件的java文件

/**
 * <pre>
 *     author : Wp
 *     e-mail : 18141924293@163.com
 *     time   : 2018/11/15
 *     desc   :
 *     version: 1.0
 * </pre>
 */
public class JNIUtils {

    static {
         //JNIControl 后面新建的.c 或者.cpp 文件名  在这里可以先注释掉
        System.loadLibrary("JNIControl");
    }

    public static native String printStringByJni();
}

2.打开Android studio 最下面的命令工具Terminal

1.进入java目录下,默认为项目根目录
cd app/src/main/java
2.如上图,确保在java目录下,执行以下命令,会在java目录下生成.h文件
javah king.bird.ndkjnidemo.JNIUtils
3.main下面新建jni文件夹,将.h文件拷贝过来
4. .h文件如下
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class king_bird_ndkjnidemo_JNIUtils */

#ifndef _Included_king_bird_ndkjnidemo_JNIUtils
#define _Included_king_bird_ndkjnidemo_JNIUtils
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     king_bird_ndkjnidemo_JNIUtils
 * Method:    printStringByJni
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_king_bird_ndkjnidemo_JNIUtils_printStringByJni
  (JNIEnv *, jclass);

#ifdef __cplusplus
}
#endif
#endif

3.编写.c或者.cpp文件

JNIControl.cpp文件内容:
#include "king_bird_ndkjnidemo_JNIUtils.h"
//king_bird_ndkjnidemo_JNIUtils_printStringByJni 包名+文件名+文件内方法名
JNIEXPORT jstring JNICALL Java_king_bird_ndkjnidemo_JNIUtils_printStringByJni
        (JNIEnv *env, jclass jclass){
    //字符串返回
return env->NewStringUTF("没想到吧!我竟然会JNI了!!!");
}

到这里已经大功告成了

1.MainActivity文件
package king.bird.ndkjnidemo

import android.support.v7.app.AppCompatActivity
import android.os.Bundle
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        mBtnLoadNative.setOnClickListener {
            val jniUtils = JNIUtils.printStringByJni()
            mTvText.text = jniUtils
        }
    }
}
2.activity_main.xml文件
<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/mTvText"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <Button
        android:id="@+id/mBtnLoadNative"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="LoadNativeText"
        app:layout_constraintTop_toBottomOf="@+id/mTvText"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        tools:ignore="HardcodedText" />
</android.support.constraint.ConstraintLayout>

参与贡献

  1. Fork 本项目
  2. 新建 Feat_xxx 分支
  3. 提交代码
  4. 新建 Pull Request

个人说明

  • 编译报错或有什么问题call me
  • QQ群:830556582
  • QQ:1101313414

github地址