JNI基础--Android.mk

Android NDK对Android.mk的支持可以说,已经是接近放弃的状态了,如果碰到Android.mk编译的项目,需要改成Cmake的方式,需要我们读懂Android.mk的编写

Android.mk是一个向Android NDK构建系统描述NDK项目的GNU makefile片段。主要用来编译生成以下几种:

●APK程序:一般的Android应用程序, 系统级别的直接push即可。
●JAVA库: JAVA类库,编译打包生成JAR文件。
●C\C++应用程序:可执行的C\C++应用程序。
●C\C++静态库:编译生成C\C++静态库,并打包成.a文件。
●C\C++共享库:编译生成共享库,并打包成.so文件。

Android.mk 基本格式

这是一个简单的Android.mk文件的内容:

#定义模块当前路径(必须定义在文件开头,只需定义一次)
LOCAL_ PATH := $(call my-dir)
#清空当前环境变量 (LOCAL_PATH除外)
include $(CLEAR_VARS )
#当前模块名(这里会生成libhello-jni.so),模块名唯一,且不能包含空格
LOCAL_MODULE := hello-jni
#当前模块包含的源代码文件
LOCAL_ SRC_ FILES := hello-jni.c 
#表示当前模块将被编译成一个共享库
include $(BUILD_ SHARED_LIBRARY)
编译多个共享库

一个Android.mk可能编译产生多个共享库模块。这里会产生libmodulel.so和libmodule2.so两个动态库:

LOCAL_ PATH := $(call my-dir)
#模块1
include $(CLEAR_VARS )
LOCAL_MODULE:= modulel
LOCAL_SRC_FILES := modulel.c
include $(BUILD_SHARED_LIBRARY )
#模块2
include $(CLEAR_VARS )
LOCAL_MODULE := module2
LOCAL_SRC_FILES:= module2.c
include $(BUILD_SHARED_LIBRARY )
编译静态库

虽然Android应用程序不能直接使用静态库,静态库可以用来编译动态库。比如在将第三方代码添加到原生项目中时,可以不用直接将第三方源码包括在原生项目中,而是将第三方源码编译成静态库,然后并入共享库。

LOCAL_PATH := $(call my-dir)
#第三方AVI库
include $(CLEAR_VARS )
LOCAL_MODULE:= avilib
LOCAL_SRC_FILES := avilib.c platform_posix.c
include $(BUILD_STATIC_LIBRARY)
#原生模块
include $(CLEAR_VARS )
LOCAL_MODULE :=module
LOCAL_SRC_FILES := module. c
#将静态库模块名添加到LOCAL_STATIC_LIBRARIES变量
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY )
使用共享库共享通用模块

静态库可以保证源代码模块化,但是当静态库与共享库相连时,它就变成了共享库的一部分。在多个共享库的情况下,多个共享库与静态库连接时,需要将通用模块的多个副本与不同的共享库重复相连,这样就增加了APP的大小。这种情况,可以将通用模块作为共享库。

LOCAL_PATH := $(call my-dir)
#第三方AVI库
include $(CLEAR_VARS )
LOCAL_MODULE := avilib
LOCAL_ SRC_ FILES := avilib.c platform_posix.c
incLude $ (BUILD_SHARED_LIBRARY)
#原生模块1
include $(CLEAR_VARS )
LOCAL_MODULE := modulel
LOCAL_SRC_FILES := modulel.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
#原生模块2
include $(CLEAR_VARS )
LOCAL_MODULE := module2
LOCAL_SRC_FILES := module2.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
在多个NDK项目间共享模块

首先将avilib源代码移动到NDK项目以外的位置,比如:C:\android\shared-modules\transcodel\avilib。作为共享模块,avilib需要有自己的Android.mk文件。以transcode/avilib为参数调用函数宏import-module添加到NDK项目的Android.mk文档末尾。

# avilib模块自己的Android . mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS )
LOCAL_MODULE  :=avilib
LOCAL_SRC_FILES := avilib.c platform_posix.c
include $(BUILD_SHARED_LIBRARY)
#使用共享模块的NDK项目1的Android.mk文件
LOCAL_PATH := $(call my-dir )
include $(CLEAR_VARS)
LOCAL_MODULE  := modulel 
LOCAL_SRC_FILES := modulel.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY )
$(call import-module , transcode/avilib)
#使用共享模块的NDK项目2的Android . mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS )
LOCAL_MODULE:= module2
LOCAL_SRC_FILES := module2.c
LOCAL_SHARED_LIBRARIES := avilib
include $(BUILD_SHARED_LIBRARY)
$( call import-module , transcode/avilib)
使用预编译库

*想在不发布源代码的情况下将模块发布给他人。
*想使用共享模块的预编译版来加速编译过程。

#预编译共享模块的Android.mk文件 
LOCAL_PATH := $(call my-dir)
#第三方预编译的库
include $(CLEAR_VARS)
LOCAL_MODULE  :=avilib
LOCAL_SRC_FILES := libavilib. so
include $ (PREBUILT_SHARED_LIBRARY)
编译独立的可执行文件

为了方便测试和进行快速开发,可以编译成可执行文件。不用打包成APK就可以复制到Android设备上直接执行。

#独立可执行模块的And roid.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS )
LOCAL_MODULE  := module 
LOCAL_SRC_FILES := module.c
LOCAL_STATIC_LIBRARIES := avilib
include $(BUILD_EXECUTABLE)
注意事项
  • 假如我们本地库libhello-jni.so依赖于libTest.so (可以使用NDK下的ndk-depends查看so的依赖关系)
  • 在Android6.0版本之前,需要在加载本地库前先加载被依赖的so。
  • 在Android6.0版本之后,不能再使用预编译的动态库(静态库没问题)。
# Android 6. 0版本之前:
System.loadLibrary("Test") ;
System.loadLibrary("hello-jni");
# Android 6. 0版本之后:
System.loadLibrary("hello-jni");
创建NDK 项目demo

① Android studio创建一个项目
② 创建一个名为jniBuild的文件夹与java同级,在文件夹下创建一个hello-jni.c文件
③在hello-jni.c中导入头文件,并创建一个方法

#include<jni.h>

int test(){
    return 123;
}

④ 在MainActivity中创建一个本地方法

public class MainActivity extends AppCompatActivity {

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

    native int nativeTest();
}

⑤在hello-jni.c中编写jni的方法,如下:

//修改后
#include<jni.h>

int test(){
    return 123;
}

//MainActivity的包名com.tpson.ndkdemo_1
//jni方法 ,我们在MainActivity中的返回值是int,所以这里返回值为jint
//方法名为Java开头跟上包名+类名+方法名 注意包名中的.换成下划线,报名中的 _数字 需要在_后加个1
jint Java_com_tpson_ndkdemo_11_MainActivity_nativeTest(){
    return test();
}

⑥jniBuild文件夹下创建Android.mk文件,内容如下:

#定义模块当前路径,基本上是固定写法
LOCAL_PATH := $(call my-dir)
#清空当前环境变量
include $(CLEAR_VARS)
#当前模块名
LOCAL_MODULE  :=hello-jni
#当前模块包含的源代码文件,有多个的话空格隔开
LOCAL_SRC_FILES := hello-jni.c
#生成一个动态库
include $(BUILD_SHARED_LIBRARY)

⑦修改app目录下的build.gradle文件,android的defaultConfig下添加externalNativeBuil指导源文件如何编译,配置native编译脚本的路径 :


android {
    compileSdkVersion 28
    defaultConfig {
        applicationId "com.tpson.ndkdemo_1"
        minSdkVersion 19
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        // 指定源文件的编译方式以及配置编译选项,模拟器用x86 真机主流都是armeabi-v7a
        externalNativeBuild{
            ndkBuild{
                abiFilters 'armeabi-v7a'
            }
        }
    }
    //配置native的编泽脚本路径
    externalNativeBuild{
        ndkBuild{
            path 'src/main/ndkBuild/Android.mk'
        }
    }

⑧在MainActivity中加载动态库,调用nativeTest()方法,将返回值123显示在TextView上

public class MainActivity extends AppCompatActivity {
    {
        System.loadLibrary("hello-jni");
    }


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        TextView textView = findViewById(R.id.textView);
        textView.setText("native: "+nativeTest());
    }

    native int nativeTest();
}

结果:

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

推荐阅读更多精彩内容