Android JNI Demo

说在最前面,当前使用的系统是 Windows 10,笔者使用过Mac,Linux 和 Windows感觉不同的系统的差异不过是在环境配置和指令参数方面的问题,使用其它系统的小伙伴可以灵活变化。

1 JNI 及 NDK工具的 Simply 介绍

不记录啥大道理,笔者只是简单粗暴地做一下说明

  • JNI(Java Native Interface) Java 本地化(C/C++)接口的集合,目的是在Java中使用C/C++的库
  • NDK(Native Develop Kit) 本地(C/C++)开发工具集,包括了C/C++编译需要的工具集合

2 使用NDK生成SO库

  • 下载NDK
    有梯子的小伙伴可以去Google官方下载
    https://developer.android.com/ndk/downloads/index.html
    或者国内Google Android
    https://developer.android.google.cn/ndk/downloads/revision_history
    或者国内小伙伴常去的
    http://www.androiddevtools.cn/
    或者Android Studio中【使用国内镜像】直接下载
    总而言之 最终的目的就是下载NDK,条条大道通罗马!笔者有梯子,所以到官方下了的,为了说明特意下载了一个 r12r16 两个版本

  • 环境变量配置
    首先说明,配置环境变量只是方便在命令行在所有目录都可以使用ndk指令,否则需要使用NDK指令时,必须cd到NDK的安装目录下执行指令(很烦有没有?)
    使用Windows打开环境变量配置的方法:"Win键 + Pause|Break键" 打开系统面板 -> 高级系统设置 -> 环境变量 -> 在系统变量那一块中找到并选择 Path 变量 -> 编辑 -> 点击"添加" -> <输入你的NDK build文件夹完整目录> -> 一路点击"确定"返回!!!

    NDK develop environment variables.png

    验证环境:命令行任意目录执行 ndk-build --version ,输出如图
    Verify NDK system variables.png

  • 编写C/C++代码(笔者写C)
    在桌面新建一个"NDK-Test"文件夹(其它目录和名字也随意了,这个小伙伴们都懂),在“NDK-Test”中新建文件 age.h age.c student.c,同一个目录新建文件夹 include 如图:

    image.png

接着将 .h 全部文件移动到 include 文件夹中。
编辑 age.h

int get_five_years_later_age(int age);

编辑 age.c

#include<stdio.h>
#include "include/age.h"

int get_five_years_later_age(int age) {
    printf("In get_five_years_later_age: input age is -> %d", age);
    age+=5;
    return age;
}

编辑 student.c

#include <stdio.h>
#include "include/age.h"

int get_ten_years_later_age(int age) {
    int get_age = get_five_years_later_age(age);
    printf("In get_ten_years_later_age: get age is -> %d", get_age);
    get_age += 5;
    return get_age;
}

int main() {
    int final_age = get_ten_years_later_age(8);
    printf("In main: final age is -> %d", final_age);
    getchar();
    return 0;
}
  • 编写 Android.mk 文件
#build-so.mk

# 初始化编译目录由编译系统完成: 取得调用宏函数my-dir的返回值(当前目录)存放到LOCAL_PATH变量
LOCAL_PATH := $(call my-dir)
# 隔离系统变量(除了我们设置的LOCAL_PATH变量)
include $(CLEAR_VARS)
# 模块名字(输出库的名字)
LOCAL_MODULE    := student
# 编译中依赖的源文件(非头文件)
LOCAL_SRC_FILES := student.c age.c
# 编译中依赖的头文件(系统头文件自动依赖添加)
LOCAL_C_INCLUDES := include/age.h
# 输出库的类型 BUILD_SHARED_LIBRARY 动态库 .so,BUILD_STATIC_LIBRARY 静态库 .a,可执行文件 BUILD_EXECUTABLE
include $(BUILD_SHARED_LIBRARY)
  • 编译.so动态库
    打开命令行并 cdNDK-Test 目录,然后执行:
ndk-build NDK_PROJECT_PATH=. APP_BUILD_SCRIPT=./Android.mk

结果:


Compile output.png

说明,NDK_PROJECT_PATH=. APP_BUILD_SCRIPT=./Android.mk这两个必须指定,NDK_APPLICATION_MK=./Application.mk 可选指定,不指定的时候将使用默认的Application.mk,也就是指定Android版本为android-14,输出所有架构的.so库。假使以可执行的方式进行编译,则需要在Android pak运行时,使得linux fork新的进程执

  • 关于Application.mk

未完待续 ~~

3 在 Eclipse 中编译 .so库

这里说明一下,前面是在命令行执行代码,其实在Eclipse配置编译的program就是指定路径过程

  • 新建NDKDemo项目
    在配置好Android SDK和NDK环境后可以直接新建Android项目,这里顺带提一下几个问题:
  1. min SDK 最低SDK版本(4.2+),选择过低的版本比如 Android 2.2等,会报style的theme找不到的错。
  2. target version 编译版本,一般推荐的是 6.0了,6.0是个分水岭,想知道的留言,笔者给你Google一下
  3. compile version 使用已经下载的最高版本吧
  • 拷贝源文件到 NDKDemo 项目
    在新建的项目中,右键项目新建 jni 文件夹,将我们前面的 NDK-Test 中的文件夹和源文件拷贝到jni文件夹下,

  • 配置项目 NDK builde program
    右键项目 -> 属性 -> Builders -> New -> Program ->

Setting main.png
Setting refresh.png
image.png

Then -> project -> clean


image.png

We make it!!!

4 在 Eclipse 中编译使用现有的 .so 库(第三方库)并运行

还是基于上面的项目进行

  • 获取一个 armeabi-v7a 架构的 .so 库作为我们的引用库
    这里小伙伴们可以刪除 libs目录下的所有文件,和JNI中的源文件(.c),笔者这里为了保留上次编译痕迹,就不删除了。我们把 armeabi-v7a 中的 libstudent.so 库到 jni目录下

  • 编写调用符合JNI格式文件
    在jni目录下新建并编写我们调用库的 teacher.c 文件,这里注意 teacher.c 中供 Java 使用的方法必须按照 JNI 格式写!(com_example_ndkdemo_MainActivity 这是java调用类的权限类名)

#include <jni.h>
#include "include/age.h"


int add_one(int age) {
    age += 1;
    return age;
}

JNIEXPORT jint JNICALL Java_com_example_ndkdemo_MainActivity_get(JNIEnv *env,
        jobject obj);

JNIEXPORT jint JNICALL Java_com_example_ndkdemo_MainActivity_get(JNIEnv *env,
        jobject obj) {
    int result = get_five_years_later_age(12);
    result = add_one(result);
    return result;
}
  • 编写我们的Android.mk
LOCAL_PATH := $(call my-dir)

# 重新打包已存在的 .so 库
include $(CLEAR_VARS)
LOCAL_MODULE    := student
LOCAL_SRC_FILES := libstudent.so
# .so 头文件
LOCAL_EXPORT_C_INCLUDES := include
include $(PREBUILT_SHARED_LIBRARY)

# 
include $(CLEAR_VARS)
LOCAL_MODULE    := teacher
LOCAL_SRC_FILES := teacher.c
LOCAL_LDLIBS    += -L$(SYSROOT) -llog
LOCAL_CFLAGS    := -g
# 引用重新打包后的 .so 库
LOCAL_SHARED_LIBRARIES := student
include $(BUILD_SHARED_LIBRARY)
  • !!! 编写我们的 Application.mk

这个在现在才提出来,其实是有原因的,跟着一起编下来的小伙伴会发现,如果没有 Application.mk 中指定的参数,会导致各种的方法索引不到,库的格式错误的问题。笔者大概是在编armeabi-v8a过程中,引发这个问题,这才在这里提出Application.mk,让小伙伴们可以更加贴切地感受Application.mk的强大之处!

Application.mk

APP_STL:=gnustl_static
APP_CPPFLAGS:=-frtti -fexceptions 
APP_ABI := armeabi-v7a armeabi

这里笔者只说明Application.mk用到的变量:

APP_STL:=gnustl_static
# APP_STL := stlport_static    --> static STLport library
# APP_STL := stlport_shared    --> shared STLport library
# APP_STL := system            --> default C++ runtime library

APP_CPPFLAGS:=-frtti -fexceptions 
# C++代码的编译, < r15 此变量只适用于C++,> 15 适用于C和C++

APP_ABI := armeabi armeabi-v7a x86 # 指定输出架构 
  • 编译我们的 .so 库
    project -> clean


    Package existed so.png
  • 编写我们的Java调用类
    上面我们有提到 com_example_ndkdemo_MainActivity, 也就是我们JNI格式方法中包含的字段,而且,本地方法需要在这个类中加载库和本地方法,而其它类可以调用该类中的方法,但不能在其它类中再次加载动态库的本地方法

package com.example.ndkdemo;

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;

public class MainActivity extends Activity {

    private static final String TAG = "MainActivity"; 
    
    static {
        System.loadLibrary("student");
        System.loadLibrary("teacher");
    }
    public static native int get();
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Log.i(TAG, "get() = " + get());
    }

}
  • Run!!!


    Make you a hello world.png

写在最后

Android NDK Eclipse 入门篇目到这里就结束了,之前开发过程中都是简简单单地了解,现在特意花两天时间整理了基础的流程,感觉吧,写文章还是比较费时费劲的,但是可以分享给一起工作的小伙伴们,我也是拼了老命坚持写下来了,笔者也会多写写总结,多输出输出。而NDK的编译远不止于此,还有更多的功能,我也希望能够抽空整理一番分享给小伙伴们。

JNIDemo

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,752评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,100评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,244评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,099评论 1 286
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,210评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,307评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,346评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,133评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,546评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,849评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,019评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,702评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,331评论 3 319
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,030评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,260评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,871评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,898评论 2 351

推荐阅读更多精彩内容