blublusuny / jimu Goto Github PK

JIMU（积木）是一套Android组件化框架，支持组件的代码资源隔离、单独调试、集成调试、组件交互、UI跳转、生命周期等完整功能。

取名为JIMU（积木），其含义是应用这套框架可以做到组件之间的完全隔离，每个组件可以单独运行，同时又可以通过“接口”任意拼接成一个完成APP，这种能力就是我们实施组件化的最终目的。

release-note&change-logs 关注版本变更以及注意事项是个好习惯。

模块	build-gradle	componentlib	router-anno-compiler	router-annotation
最新版本

仓库2：

模块	build-gradle	componentlib	router-anno-compiler	router-annotation
最新版本

因为没有创建组织账号，可能会发布到不同的仓库，出现版本差异时请关注下release-note

• 组件可以单独调试
• 杜绝组件之前相互耦合，代码完全隔离，彻底解耦
• 组件之间通过接口+实现的方式进行数据传输
• 使用scheme和host路由的方式进行activity之间的跳转
• 自动生成路由跳转路由表
• 任意组件可以充当host，集成其他组件进行集成调试
• 可以动态对已集成的组件进行加载和卸载
• 支持kotlin组件
• 组件独立运行的Manifest可以基于“壳”和组件原始的Manifest合并生成（from version 1.3.4）
• 组件初始化支持按序（from version 1.3.4）这部分基于Maat, 参考博客

组件化设计思路 浅谈Android组件化

原理解释请参考文章Android彻底组件化方案实践

demo解读请参考文章Android彻底组件化demo发布

按序初始化业务组件请参考文章组件化：代码隔离也难不倒组件的按序初始化

在根目录的gradle.properties文件中，增加属性：

mainmodulename=app

其中mainmodulename是项目中的host工程，一般为app

在根目录的build.gradle中增加配置

buildscript {
    dependencies {
        classpath 'com.github.jimu:build-gradle:A.B.C'
    }
}

A.B.C是版本号，最新的版本号可以参考上面的jcenter外链

为每个组件引入依赖库，如果项目中存在basiclib等基础库，可以统一交给basiclib引入

compile 'com.github.jimu:componentlib:A.B.C'

在每个组件的工程目录下新建文件gradle.properties文件，增加以下配置：

isRunAlone=true
debugComponent=sharecomponent
compileComponent=sharecomponent

上面三个属性分别对应是否单独调试、debug模式下依赖的组件，release模式下依赖的组件。具体使用方式请解释请参见上文第二篇文章

在组件和host的build.gradle都增加配置：

apply plugin: 'com.dd.comgradle'

注意：不需要在引用com.android.application或者com.android.library

同时增加以下extension配置：

combuild {
    applicationName = 'com.luojilab.reader.runalone.application.ReaderApplication'
    isRegisterCompoAuto = true
}

组件注册还支持反射的方式，有关isRegisterCompoAuto的解释请参见上文第二篇文章

def projectRoot = project.getRootProject().rootDir.absolutePath

combuild {
    applicationName = 'com.luojilab.reader.runalone.application.ReaderApplication'
    isRegisterCompoAuto = false

    originalManifest = projectRoot + "/readercomponent/src/main/AndroidManifest.xml"

    runAloneManifest = projectRoot + "/readercomponent/src/main/runalone/AndroidManifest.xml"
    targetManifest = projectRoot + "/readercomponent/src/main/runalone/mergedManifest.xml"
    //如果不需要合并，改为false
    enableManifestMerge = true
}

增加了5个可配项目：

• useMaat 默认为true，本处没有写，如果你不打算使用Maat，务必改为false，否则会织入代码并发生ClassNotFoundException
• originalManifest 原始manifest文件路径
• runAloneManifest 一个壳manifest，用于指定独立运行时额外需要的权限、Application配置，启动Activity、额外的四大组件，metadata
• targetManifest 合并后输出的manifest，需要先创建文件，runalone使用的manifest；如不先创建会影响gradle任务，被认为是一个缺失manifest的Component！
• enableManifestMerge 如果是true，则会在合适的时机执行manifest合并功能，并且插件中增加的如：runaloneMergeDebugManifest等任务会执行合并，否则该任务并不会合并manifest文件

在混淆文件中增加如下配置

-keep interface * {
  <methods>;
}
-keep class com.luojilab.component.componentlib.** {*;}
-keep class com.luojilab.gen.router.** {*;}
-keep class * implements com.luojilab.component.componentlib.router.ISyringe {*;}
-keep class * implements com.luojilab.component.componentlib.applicationlike.IApplicationLike {*;}

注意：com.luojilab.component.componentlib和com.luojilab.gen.router包可能在项目迁移的过程中发生过或即将发生变化，文档更新不一定及时，请手工确认一下生成类的包路径。

关于如何进行组件之间数据交互和UI跳转，请参看 Wiki 关于消息中间件，请参考v1.3.3releaseNote

JIMU的讨论群，群号693097923，欢迎大家加入：

PS:最近千人群满了，建议一些基础性问题仔细琢磨下文章，比较麻烦的问题提issue求助。