插件化知识梳理(1) Small 框架之如何引入应用插件

1、前言

上个星期，公司里有一个小的讲座，对插件化进行了简单的介绍，所以决定开始研究一下这方面的知识。

在网上查了一些相关的资料，发现了Small这个开源的插件化框架，所以打算从它入手，经过它的内部实现，学习一下插件化的相关原理。这篇文章是个开篇，先从一个简单的例子开始，把环境给搭建好。先给你们分享一些这几天查阅的资料，若是你们有比较好的文章也能够留言或者私信我：

Android博客周刊专题之＃插件化开发＃

Small Github 官网 Small Issues Small 快速入门

Android Small 源码分析 (一) 启动流程 Android Small 源码分析 (二) 插件加载过程

Android Small 插件化框架源码分析

Android Small 插件化框架 -- 启动插件 Activity 源码解析(上) Android Small 插件化框架 -- 启动插件 Activity 源码解析(下) Android Small 插件化框架 -- Android 应用类加载机制 Android Small 插件化框架 -- 类加载实现解析

2、基本示例

2.1 简要介绍

对于Small来讲，一个最简单的框架分为三个部分：

• 宿主
• 插件
• bundle.json，用于宿主和插件之间的路由。

本文所用的是一个最简单的例子，所以在代码上基本不会有什么问题，主要是环境上的区别，遇到编译不过的问题能够多多百度，下面是我所采用的环境：

• Android Studio 版本：Android Studio 3.0
• Gradle 版本：gradle-3.5-all.zip
• compileSdkVersion：24
• buildToolsVersion：24.0.2

完整的例子能够查看 github.com/imZeJun/Sma…

2.2 具体实现

整个具体的实现分为五步：

• 新建工程/宿主模块
• 修改项目根目录下的build.gradle文件，引入Small插件
• 新建插件模块
• 完善宿主模块
• 编译，安装

2.2.1 新建工程/宿主模块

这里比较关键的一点，是须要在新建工程/宿主模块的时候，将包名修正为com.demo.small，这是为了和之后的lib/app模块造成统一：

2.2.2 修改项目根目录下的 build.gradle 文件

对于项目的build.gradle，修改包含如下三个部分：

• 必选，在dependencies节点中引入远程依赖。
• 必选，经过apply plugin应用插件。
• 可选，配置Small代码库版本。

buildscript {

    repositories {
        maven { url 'https://maven.google.com' }
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.2.3'
        //1.引入Small依赖，必选。
        classpath 'net.wequick.tools.build:gradle-small:1.2.0-alpha3'
    }
}

allprojects {
    repositories {
        jcenter()
        maven { url 'https://maven.google.com' }
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

//2.应用插件，必选。
apply plugin: 'net.wequick.small'

//3.配置Small的代码库版本，须要放在第2步的下面，不然会报错，可选。
small {
    aarVersion = '1.2.0-alpha3'
}
复制代码

2.2.3 新建插件模块

这里用到的插件模块很简单，就是位于另外一个模块中的Activity，选择File -> New -> New Module：

插件模块中最最关键的一点，就是插件模块的包名，它的包名分为两个部分

• 第一部分和宿主模块相同
• 第二部分要根据插件的类型来决定：
• 若是是Phone & Tablet Module：那么要以app.xxx结尾
• 若是是Android Library，那么要以lib.xxx结尾

这里，咱们先演示第一种：

在插件模块中，咱们声明一个新的 PlugActivity，它的布局为：

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/white"
    tools:context="com.demo.small.app.main.PlugActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:textColor="@android:color/black"
        android:text="PlugActivity started success"/>

</FrameLayout>
复制代码

2.2.4 完善宿主模块

(a) 配置路由协议

接下来要在宿主模块中进行路由配置，咱们在宿主模块上单击右键，新建一个assets文件夹，以后在assets文件夹中，新建一个路由文件，bundle.json文件，注意assets文件夹从Project视图上所处的位置以下图所示，千万不要放错地方了：

在 bundle.json中，咱们声明插件模块：

{
  "version": "1.0.0",
  "bundles": [
    {
      "uri": "main",
      "pkg": "com.demo.small.app.main"
    }
  ]
}
复制代码

** (b) 在宿主模块的自定义 Application 中进行预加载**

public class SmallHostApp extends Application {

    public SmallHostApp() {
        //Small初始化。
        Small.preSetUp(this);
    }
}
复制代码

** (c) 将自定义的 Application 配置到宿主模块的 AndroidManifest.xml 中**

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.demo.small">

    <application
        android:name=".app.SmallHostApp"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".LaunchActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>
复制代码

** (d) 在启动 Activity 的 onCreate() 方法中加载插件，点击按钮后跳转到插件的Activity**

public class LaunchActivity extends AppCompatActivity {

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

    private void setUp() {
        Small.setUp(this, new net.wequick.small.Small.OnCompleteListener() {

            @Override
            public void onComplete() {
                Log.d("LaunchActivity", "onComplete");
            }
        });
    }

    public void startPlugActivity(View view) {
        Small.openUri("main", LaunchActivity.this);
    }
}
复制代码

2.2.5 编译&安装

最后一步，就是进行编译和安装，编译时：

• 准备基础库 & 打包全部组件

./gradlew buildLib -q && ./gradlew buildBundle -q
复制代码

• 安装：

./gradlew assembleDebug && adb install -r app/build/outputs/apk/app-debug.apk 
复制代码

• 清除基础库 & 清除全部组件：

./gradlew cleanLib -q && ./gradlew cleanBundle -q
复制代码

2.3 最终效果

---

更多文章，欢迎访问个人 Android 知识梳理系列：

• Android 知识梳理目录：www.jianshu.com/p/fd82d1899…
• 我的主页：lizejun.cn
• 我的知识总结目录：lizejun.cn/categories/