Android 模块化探索和实践(2):Dagger2实现模块化(组件化)

在上一篇文章中Android 模块化探索和实践(1):基本思路讲到模块化中使用Dagger2会有些特殊的坑,这篇文章我就争取把这个坑填上。

问题

在采用普通(非模块化)架构的项目中使用Dagger2,一般会通过ApplicationComponent、ActivityComponent、FragmentComponent等方式来控制所注入对象的生命周期,其生命周期分别是Application全局单例、Activity局部单例和Fragment局部单例,很自然的,只需要处理好Component之间的依赖关系,并在Application和Activity、Fragment中处理好Component的创建逻辑即可。
在模块化项目中,Dagger2却有不一样的使用,我还是以上一篇文章的架构设计为例,其问题主要表现在两点:

  1. 如何保证BaseCore中的某些类全局单例,比如那些存储管理、网络组件等;
  2. 同一个业务模块,其在Debug时是独立的Application,在Release时又是Library,如何让业务模块中的Dagger2管理不受Application变化的影响;
  3. 如何保证业务模块中的某些类模块内单例
模块化分层设计

解决方案

先来看一下模块化中的Dagger2注入需求图

模块化注入

无论BaseCore还是各个业务模块,都存在这样的单例类和非单例类,需要注入到上层应用层,其中BaseCore是全局注入,而业务模块中只注入该模块内,其他模块无法注入。
为满足这样的需求,我采用的解决方式是:

  1. 对Component进行分层设计,明确Component之间的依赖关系,控制不同层次Component的生命周期,以达到Component生命周期和Application、Activity、Fragment等一致;
  2. 不同层次的Component设计不同的scope进行标注,通过scope可以保证在本层次Component注入的实例是单例的

这个方案总结下来就是:合理控制Component的创建,使得Component和需要注入的对象(Application、Activity等)生命周期一致;不同层次Component采用scope标注,以实现Component内局部单例。

方案的架构图如下:

BaseCore中对单例类的处理如下:

@Module
public class SingletonModule {

    @Provides
    @Singleton
    RxBus provideRxBus() {
        return RxBus.getInstance();
    }

    ...
}

@Module(includes = SingletonModule.class)
public class AppModule {
    private final Application application;

    public AppModule(Application app) {
        application = app;
    }

    @Provides
    @Singleton
    Application provideApplication() {
        return application;
    }

    @Provides
    @Singleton
    Context provideContext() {
        return application;
    }
}

@Singleton
@Component(modules = {AppModule.class, SingletonModule.class})
public interface BaseAppComponent {

    RxBus rxBus();

    ...
}

对非单例类的处理如下:

@Module
public class BaseViewModule {

    private final Activity activity;

    public BaseViewModule(Activity activity) {
        this.activity = activity;
    }

    @Provides
    @PerView
    Activity provideActivity() {
        return this.activity;
    }

    @Provides @PerView
    JsInterface jsInterface() {
        return new JsInterface(activity);
    }
}

@PerView
@Component(modules = BaseViewModule.class)
public interface BaseViewComponent {

    Activity activity();

    ...
}

业务模块中对单例类的处理:

@Module
public class BusinessAModule {

    @Provides
    @AppScope
    BusinessAManager provideBusinessAManager(Applition app) {
        return BusinessAManager.getInstance(app);
    }

    ...
}

@AppScope
@Component(dependencies = BaseAppComponent.class, modules = {BusinessAModule.class})
public interface BusinessAAppComponent extends AppComponent {

 /* Note: 必须显式的提供BaseAppComponent所能提供的对象
  * 理由:BaseAppComponent中的对象对于BusinessAAppComponent是可见的,
  * 但是对于依赖于BusinessAAppComponent的上层ActivityComponent 是不可见的,所以需要再次显式的声明
  */
    RxBus rxBus();

    ...
}

业务模块中的非单例类可以在 BusinessAActivityModule 中提供。

经过以上的处理,问题来了,如何在业务层中的Activity等目标类中inject上述对象呢?我们来看业务模块中的 ActivityComponent:

@PerView
@Component(dependencies = {BusinessAAppComponent.class}, modules = BaseViewModule.class)
public interface ActivityComponent extends android.databinding.DataBindingComponent {

    void inject(MainActivity activity);

    ...
}

这样,你就可以在MainActivity中通过ActivityComponent 注入BaseAppComponent、BusinessAAppComponent、BaseViewModule暴露出来的对象了。这里有个细节,ActivityComponent继承自DataBindingComponent,之所以要这么做是为了满足在Databinding中使用Dagger2依赖注入。

最后,还有个关键问题:如何处理Debug和Release模式下AppComponent初始化问题?只有保证了AppComponent的单例,才能保证通过其注入对象的单例。

我在BaseCore上定义一个接口:

public interface AppComponent {}

不同模块中的BusinessAAppComponent、BusinessBAppComponent继承它

public interface BusinessAAppComponent extends AppComponent {}

public interface BusinessBAppComponent extends AppComponent {}

再定义一个接口:

public interface AppModuleComponentDelegate {    AppComponent initAppComponent();}

在BaseCore中定义一个BaseModuleKit,目的在于获取BaseAppComponent:

public class BaseModuleKit {

    private static BaseModuleKit instance;
    private BaseAppComponent component;

    public static BaseModuleKit getInstance() {
        if (instance == null) {
            synchronized (BaseModuleKit.class) {
                if (instance == null) {
                    instance = new BaseModuleKit();
                    Application application = BaseApplication.getInstance();
                    instance.component = DaggerBaseAppComponent.builder().appModule(new AppModule(application)).build();
                }
            }
        }
        return instance;
    }

    public BaseAppComponent getComponent() {
        return component;
    }
}

再定义一个BusinessModuleKit, 目的在于获取到BusinessAAppComponent:

public class BusinessAModuleKit {

    private static BusinessAModuleKit instance;

    private Application application;
    private AppComponent component;

    public static BusinessAModuleKit getInstance() {
        if (instance == null) {
            synchronized (BusinessAModuleKit.class) {
                if (instance == null) {
                    instance = new BusinessAModuleKit();
                }
            }
        }
        return instance;
    }

    public BusinessAModuleKit init(Application application, AppModuleComponentDelegate appModuleComponentDelegate) {
        this.application = application;
        this.component = appModuleComponentDelegate.initAppComponent();
        return this;
    }

    public Application getApplication() {
        return application;
    }

    public AppComponent getComponent() {
        return component;
    }
}

以上的思路就是:通过BaseModuleKit保证BaseAppComponent单例;通过BusinessAModuleKit保证BusinessAAppComponent单例;ActivityComponent的创建需要依赖于这两个,必须保证这两个是单例。

下面再讲述一下BusinessAAppComponent 和 ActivityComponent的创建。

在业务模块中的BusinessAApplication 中:

private AppModuleComponentDelegate aAppComponentDelegate = new AppModuleComponentDelegate() {
    @Override
    public AppComponent initAppComponent() {
        BusinessAAppComponent appComponent = DaggerBusinessAAppComponent.builder()
                    .baseAppComponent(BaseModuleKit.getInstance().getComponent())
                    .build();
        return appComponent;
    }
};

BusinessAModuleKit.getInstance().init(this, aAppComponentDelegate);

在MainActivity中:

private ActivityComponent activityComponent;

public ActivityComponent activityComponent() {
    if (activityComponent == null) {
        activityComponent = DaggerActivityComponent.builder()
                .businessAAppComponent((BusinessAAppComponent) BusinessAModuleKit.getInstance().getComponent())
                .baseViewModule(new BaseViewModule(this))
                .build();
    }
    return activityComponent;
}

// 注入
activityComponent().inject(this);

至此,Dagger2在模块化中的处理就介绍完了,讲的有点乱,希望没有把大家绕晕。

此外还有几个有意思的问题有待进一步的探究:

  1. 如果要进一步细化业务模块的生命周期,比如增加业务模块的注册、卸载,在这种情况下,业务模块中的Dagger2如何处理?
  2. 做成一个开源库,方便在模块化中直接引入

先挖个坑,后面有时间争取补上!





终于把Demo给大家补上了,Github: DaggerModules,Demo目前还比较简单,只具备基本功能,欢迎大家Star or Fork

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

推荐阅读更多精彩内容