AndroidStudio封装SDK的那些事


首先SDK是提供给别人调用的工具。所以常见的SDK都是以jar包,so库,aar包等方式导入APP项目中。然后提供一些公开的API供接入方调用。所以在Androidstudio中如果需要生成jar或者aar,就需要将module变成library。

1、AndroidStudio生成library

在这里介绍AndroidStudio两种生成library的方式。

1.1、两种生成library的方式
新建library module。
  image.png

这种会直接生成可编译成jar和aar的module。

新建Android项目,然后修改app下的build.gradle
  image.png

apply plugin: 'com.android.application'修改成apply plugin: 'com.android.library'
然后去掉applicationId "com.mg.axe.helloworld"就把可运行的Android module变成了一个library module。
注意:这种方式在编译前一定要做以下事情

  • 删除自定义的Application和在AndroidManifest.xml的配置。
  • 去点入口的Activity,否则在Android Studio接入时会生成两个图标入口。
1.1、使用gradle所带的命令编译

这些命令可以自己在控制台使用,可以直接点开右上角的Gradle直接使用。


  image.png
  • assembleRelease&assembleDebug
  image.png

在build下的assembleRelease和assembleDebug都可以生成aar包。这边和APP开发很相似,可以在buildTypes下对release包做混淆等等操作。

如果编译的命令执行完毕,可以在当前module下的build文件下找到编译好的.aar文件。


  image.png

如果需要jar包,则只需将这个aar文件解压即可。


  image.png
classes.jar就是编译成jar的class文件。
1.2、aar和jar
  • .aar是适用于AndroidStudio的接入方式,不需要过多的考虑当SDK存在界面,图片等资源文件的情况。解压aar也可以看到,aar是一个将源码(jar)和资源文件都打包好的文件。当然也可以在eclipse中使用,前提是eclipse需要安装gradle编译环境。

  • jar只包含编译好的源代码,如果SDK包含资源文件,则需要额外导入,适用于eclipse导入;AndroidStudio也同样适用,不过当SDK包含资源文件时,导入aar将会更方便。

2、两种接入方式

一般情况接入方式为AndroidStudio和Eclipse。其他的接入方式就不考虑了,可能大同小异,最主要的是其他的接入方式我也不会。


  手动滑稽
2.1、AndroidStudio接入方式

这里只介绍.aar的接入方式,AndroidStudio接入jar方式就不做介绍。

  • 将.aar文件复制到项目的libs中。
  • 并在app下的build.gradle中的android中添加如下代码
  // implementation(name: 'aar包的名字', ext: 'aar')
  implementation(name: 'game_sdk', ext: 'aar')

然后点击同步(Sync Now),就成功的将.arr导入项目了。

可以在External Libraries中找到导入的aar依赖。


  image.png   image.png

点开aar,可以看(源代码)jar和(资源文件)res。

2.2、Eclipse接入方式

eclipse一般是接入jar包的方式接入SDK,当SDK存在界面、资源文件时,接入方式比AndroidStudio接入aar稍微麻烦点,需要将jar包和资源文件分开导入。

  • 解压aar文件。
  • 将jar包复制到libs文件加下,并添加依赖(add to path) 。
  • 如果有资源文件,则需要将res下的资源文件复制到项目对应的位置。
  • 如果SDK用到了Activity等组件,还需去注册等,这些都应在SDK接入文档中指明清楚。
2.3、两种接入方式都需要注意的问题

在SDK中声明的权限,制定的Android版本范围等都要在SDK接入文档中指明清楚。

3、可能踩的坑

3.1、资源文件无法获取的问题。

如果编译好的jar中使用了资源文件,然后使用了R.xx.xx这样的代码,可能会出现这样的异常。

public class GetResId {
    public static int getId(Context context, String paramString1, String paramString2) {
        return context.getResources().getIdentifier(paramString2, paramString1, context.getPackageName());
    }
}

加载布局和控件的方法:

compileOnly files('libs/gson-2.8.5.jar')

或者

 buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

在混淆的时候,如果使用了三方库,三方库混淆的要求同样需要加上混淆。
如果接入方需要做混淆,请记住加上SDK的混淆要求和三方库的混淆要求。免得SDK的代码混淆之后又被接入方混淆导致出错。

5、关于SDK的其他解决方案

实际上,用原生的界面做SDK并不是非常好的解决方案,主要是不利于SDK的更新和跨平台。最好的方式是加载H5,更新起来更方便,SDK实现起来更简单。

6、一些开源的SDK

https://github.com/typesdk/TypeSDK
https://github.com/zuowutan/ShareGameSdk

如果这篇文章对你有帮助,还请点个赞再走吧:)

 

相关