Android Stuido Ndk-Jni 开发(四):Jni打包及引用aar

aar包介绍

在介绍aar之前,先来看看jar。现在在android开发过程中经常需要引用jar等第三方库。你可以很容易把Android Library Project项目打包成jar包给其他项目引用。但是如果你打包的库需要引用到drawable文件、xml文件等资源文件,jar就无法满足要求。与jar不同,aar包是把整个module都打包进去,aar包包含以下文件:

/AndroidManifest.xml (mandatory)
/classes.jar (mandatory)
/res/ (mandatory)
/R.txt (mandatory)
/assets/ (optional)
/libs/*.jar (optional)
/jni/<abi>/*.so (optional)
/proguard.txt (optional)
/lint.jar (optional)

如果我们要引用一个带有资源文件的库,就可以很方便的引用aar包。
对于jni开发,我们可以把c/c++文件编译成so文件,然后应用到其他工程中,但是引用so文件的工程就需要创建一个package一个与so文件的包名一致,这样才能调用到so文件的方法。有了aar,就可以把so文件和调用so文件的java代码都封装起来,打包成aar给其他工程调用,这样就可以让主工程与库完全独立,不需要受到包名或路径的限制。

本文的源码请前往Github https://github.com/dragonjiang/JniPackagingToAar

环境配置

如果已经配置好可以跳过这个步骤。

  • 下载ndk,墙内官网访问不了,可以度娘,现在最新的是
    android-ndk-r10e-windows-x86_64.exe

  • 解压,一般是解压到与SDK同级的目录下:

  • 设置Windows环境变量

然后在Path里面添加%Android_NDK_HOME%

新建工程

1. 打开android studio,新建工程

选择新建一个Empty Actity

2. 新建一个module

选择File->New->New Module 新建一个module,选择Android Library

取名JniModule

3. 在JniModule下新建NativeHelper类,声明一个native方法:

声明代码如下:

 public class NativeHelper {
     public native String getStringFromJni();
 }

4. 执行Build->Make Project,目的是生成class文件###

打开工程目录PackagingToAar\jnimodule\build\intermediates\classes\debug\com\dj\jni\jnimodule\NativeHelper.class 可以看到生成了NativeHelper.class文件:

5. 根据class文件生成对应的c语言头文件

打开android stuido 的 terminal,执行命令cd jnimodule/src/main进入JniModule的mian目录,目的是在mian目录下生成jni文件夹。

然后用javah生成c头文件:

javah -d jni -classpath D:\ANDROID_DEVELOP_ENVIRNMONT\SDK\platforms\android-21\android.jar;..\..\build\intermediates\classes\debug com.dj.jni.jnimodule.NativeHelper

命令格式是:

javah -d (jni文件夹名) -classpath (sdk路径);(class路径) (class完整的文件名,包括包名)

然后再看JniModule的mian目录下会多出jni文件夹,里面已经自动生成了一个头文件com_dj_jni_jnimodule_NativeHelper.h

文件内容如下:

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_dj_jni_jnimodule_NativeHelper */

#ifndef _Included_com_dj_jni_jnimodule_NativeHelper
#define _Included_com_dj_jni_jnimodule_NativeHelper
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_dj_jni_jnimodule_NativeHelper
 * Method:    getStringFromJni
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_dj_jni_jnimodule_NativeHelper_getStringFromJni
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif


6. 新建.c文件

在jni文件下新建.c文件,当然新建.cpp文件也是可以的啦,就看大家习惯使用c还是c++

添加内容如下:

//
// Created by dragonjiang on 2016/2/26.
//
#include <jni.h>
#include<android/log.h>

#ifndef LOG_TAG
#define LOG_TAG "JNI"
#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG,LOG_TAG ,__VA_ARGS__) // 定义LOGD类型
#define LOGI(...) __android_log_print(ANDROID_LOG_INFO,LOG_TAG ,__VA_ARGS__) // 定义LOGI类型
#define LOGW(...) __android_log_print(ANDROID_LOG_WARN,LOG_TAG ,__VA_ARGS__) // 定义LOGW类型
#define LOGE(...) __android_log_print(ANDROID_LOG_ERROR,LOG_TAG ,__VA_ARGS__) // 定义LOGE类型
#define LOGF(...) __android_log_print(ANDROID_LOG_FATAL,LOG_TAG ,__VA_ARGS__) // 定义LOGF类型
#endif

/*
 * Class:     com_dj_jni_jnimodule_NativeHelper
 * Method:    getStringFromJni
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_dj_jni_jnimodule_NativeHelper_getStringFromJni
        (JNIEnv *env, jobject obj){

    LOGD("LOG from JNI");
    return (*env)->NewStringUTF(env,"Hello from JNI !");
}


7. 配置ndk

执行Build->Clean Project, 再执行Build->Make Project,期间可能会提示错误:

我们根据提示在gradle.properties文件中添加以下内容:

android.useDeprecatedNdk=true

打开File->Project Structure,选择ndk的路径

在jnimodule目录下的build.gradle中设置要生成的so库文件名,注意是在jnimodule目录下,因为我们的jni工程在这个module下。
在defaultConfig这项里面添加:

        ndk {
            moduleName "JniPackageTest" //编译后会生成JniPackageTest.so
            ldLibs "log", "z", "m"
        }

在NativeHelper类中添加对so库的加载:

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

android动态加载库文件有两个方法,System.load 和 System.loadLibrary
System.load 参数必须为库文件的绝对路径
System.loadLibrary 参数为库文件名,不包含库文件的扩展名。
注意加载的库名字要与build.gradle中配置的库名字一致。

NativeHelper类的完整代码如下:

package com.dj.jni.jnimodule;

/**
 * @author DragonJiang
 * @Date 2016/2/26
 * @Time 9:49
 * @description
 */
public class NativeHelper {
    public native String getStringFromJni();

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

8. 编译jni, 在app中调用native方法

再执行Build->Clean Project,
执行Build->Make Project。

打开工程目录PackagingToAar\jnimodule\build\intermediates\ndk\debug\lib 可以看到生成了各个平台的so文件:

打开工程目录PackagingToAar\jnimodule\build\outputs\aar 可以看到生成了aar包。

注意: 每次修改jni文件夹下的.c文件或者.h文件都要重新执行Build->Make Project,重新生成so文件和aar包。

把aar文件copy出来,后缀名改为.zip,然后解压,看到aar包里面包含了jni、res、lib等文件夹:

其中jni文件夹下面已经放入各个平台的so文件:

打开app module下的build.gradle文件,配置引用jnimodule, 在dependecies下添加

compile project(':jnimodule')

然后更新一下gradle,打开app module下的MainActivity,直接引用JniModule下的NativeHelper类。

public class MainActivity extends AppCompatActivity {

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

        NativeHelper nativeHelper = new NativeHelper();
        TextView textView = (TextView) findViewById(R.id.text_view);
        textView.setText(nativeHelper.getStringFromJni());
    }
}

运行结果:

9. 导出aar包

执行上面的步骤8后,再来打开工程目录下PackagingToAar\jnimodule\build\outputs\aar 可以看到分别生成了debug和release版的aar包。

把jnimodule-release copy出来就可以使用了。


引用aar包

引用aar包有两种方式,一种是添加新module,选择Import .JAR/.AAR Package的方式导入。
一种是配置依赖的方式导入。

完整源码请前往Github https://github.com/dragonjiang/ImportAarTest

1. 新建module的方式导入

在需要导入aar的工程中,打开File->New->New Module,选择Import .JAR/.AAR Package:

然后下一步选择需要导入的aar包,导入成功后就可以看到新的module:

最后在app下的build.gralde中添加依赖

compile project(':jnimodule-release')

到此就可以在app中引用aar包中的类了。

但是这种方式有个缺点,就是被依赖的aar包无法看到资源文件等内容

2. 配置依赖的方式导入

先将aar包放入需要引用的Module的libs目录下,这里我们在app中引用aar包,所以放到aap下的libs目录下:

然后在app下的build.gralde中把libs目录加入依赖:

repositories {
    flatDir {
        dirs 'libs'
    }
}

接着在build.gralde的依赖配置中加入compile (name:'jnimodule-release',ext:'aar')
格式是compile(name: 'xxx', ext: 'aar'),表示依赖aar文件。

至此依赖的配置完毕。

然后构建一下工程,在aap的build/intermediates/exploded-aar目录下看到jnimodule-release里面的文件。

在MainActivity中直接引用aar包里面类:

这种方式可以很方便的看到aar里面的jni、res、libs等文件

参考:AndroidStudio打包及引用aar - Android

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

推荐阅读更多精彩内容