Android 通用的組件自動注冊者甲、自動初始化解決方案

背景問題

我們在組件化的過程商佛,業(yè)務(wù)被拆分至獨立的Module中,一些公用組件會在各個Module中通過APT生成一些需要被注冊至組件中的信息類整葡,比如EventBus生成的Index類件余。我們這邊RN定制的Plugin是跟隨各自module,需要被注冊掘宪。還有蛾扇,各Module對外提供的api接口的話,也需要被注冊魏滚。

另外镀首,有些組件為某些Module特有,需要在App啟動的時候就要初始化鼠次,有些需要在主線程中初始化更哄,有些為不阻塞主線程可以在非主線程中初始化芋齿。

在組件化之前,我們是在Main Module通過硬編碼來進行注冊成翩,在Application中堆積各個組件的初始化邏輯觅捆。

有沒有更好的解決方式?

解決思路

首先麻敌,將問題分解抽象:

  • 把注冊行為進行抽象化栅炒,可以把一個類(需要被注冊的信息)看作方法函數(shù)的入?yún)ⅲ欠椒ê瘮?shù)就可以看作是對注冊相關(guān)邏輯的實現(xiàn)术羔。那注冊問題可以進一步轉(zhuǎn)化為各模塊如何把相關(guān)類(需要被注冊的信息)轉(zhuǎn)化為方法函數(shù)的入?yún)⒂蓿M件定義方法函數(shù),獲取入?yún)韺崿F(xiàn)注冊邏輯级历。比如:

      A a = new A()
      B b = new B()
      b.shoot(a.get())
    
      A為Module定義的一個類释移,通過get方法可以獲得被注冊的信息,B為組件定義的一個類寥殖,在shoot方法中實現(xiàn)注冊邏輯玩讳。
    
    
  • 接下來的問題是,AB分處不同模塊嚼贡,如何把AB按上述代碼邏輯組合起來熏纯?

    AB組合意味著需要代碼注入,代碼注入使用的技術(shù)方案是Gradle Transform + ASM编曼。AB分別實現(xiàn)約定的接口豆巨,再用注解標記。在編譯時掐场,通過Gradle Transform + ASM往扔,通過注解找到AB,生成上述格式的代碼并注入到合適的位置熊户。

  • 剩下的問題就是萍膛,在什么位置注入?

    采用的方式是預(yù)先定義一個空方法嚷堡,通過注解標記蝗罗,并在適當時機調(diào)用這個空方法。在編譯時通過注解找到AB和空方法蝌戒,生成上述格式的代碼并注入到這個空方法中串塑。

以上是有關(guān)組件注冊方面的解決思路,而模塊中的組件初始化有點不同北苟,因為其不需要入?yún)ⅰ?但可以直接在方法函數(shù)中實現(xiàn)初始化邏輯桩匪,比如:

    A a = new A()
    a.shoot()

    模塊定義一個類A,實現(xiàn)約定的接口友鼻,在shoot方法中做實現(xiàn)初始化邏輯傻昙。

其余和組件注冊方式相類似闺骚,主要在注入的代碼邏輯上有所不同。

設(shè)計模型

弓箭耙的模式

具體的實現(xiàn)方式其實是借鑒了弓箭耙的模式妆档。

弓箭耙模式:

  • 箭 Arrow:對應(yīng)一種型號

    提供模塊相關(guān)類(需要被注冊的信息)的載體僻爽。

  • 弓 Bow:適配一種型號的箭,射向唯一的耙贾惦。

    方法函數(shù)胸梆,即實現(xiàn)注冊邏輯的載體。

  • 耙 Target:位置

    將被注入的空方法须板。

介紹AutoInject

使用方式

在根項目的build.gradle中添加插件依賴:

buildscript {
    ... 
    dependencies {
        ...
        classpath 'com.eastwood.tools.plugins:auto-inject:1.0.0'
    }
}

在模塊的build.gradle中添加注解庫依賴:

dependencies {
    ...
    implementation 'com.eastwood.common:auto-inject:1.0.0'
}

在主模塊的build.gradle中引用插件:

apply plugin: 'auto-inject'

autoInject {
    showLog = true
    ignorePackages = ['android', 'com/google']  // 忽略一些包名乳绕,提升查詢效率
}

@AutoTarget

預(yù)先定義一個空方法并調(diào)用,在方法上標記@AutoTarget逼纸,例如:

public class App extends Application {

    public EventBusBuilder eventBusBuilder;

    @Override
    public void onCreate() {
        super.onCreate();

        eventBusBuilder = EventBus.builder();
        // add config to eventBusBuilder
        addIndex2EventBus();
        eventBusBuilder.build();

    }

    @AutoTarget
    void addIndex2EventBus() {}

}

addIndex2EventBus 方法將被注入代碼。

@AutoArrow

新建一個類济蝉,并實現(xiàn)IAutoArrow接口杰刽,在get方法中返回需要被注冊的信息類。例如:

@AutoArrow(model = "eventBusIndex")
public class ModuleBAutoArrow implements IAutoArrow<SubscriberInfoIndex> {

    @Override
    public SubscriberInfoIndex get() {
        return new ModuleBEventBusIndex();
    }

}

@AutoBow

新建一個類王滤,并實現(xiàn)IAutoBow接口贺嫂,在shoot方法中獲取入?yún)⒉?zhí)行具體的注冊邏輯。例如:

@AutoBow(target = "addIndex2EventBus", model = "eventBusIndex", context = true)
public class EventBusAutoBow implements IAutoBow<SubscriberInfoIndex> {

    private App app;

    EventBusAutoBow(Application application) {
        app = (App) application;
    }

    @Override
    public void shoot(SubscriberInfoIndex index) {
        app.eventBusBuilder.addIndex(index);
    }

}

其中 context 用于聲明EventBusAutoBow被實例化時是否需要上下文雁乡,這個上下文是被@AutoTarget標記的方法在運行時的上下文第喳。為 true時,該類需定義一個以上下文做為唯一入?yún)⒌臉?gòu)造函數(shù)踱稍。

@AutoBowArrow

新建一個類曲饱,并實現(xiàn)IAutoBowArrow接口,在shoot方法中執(zhí)行相關(guān)邏輯珠月。

@AutoBowArrow(target = "init")
public class InitAutoBowArrow implements IAutoBowArrow {

    @Override
    public void shoot() {
        // ...
    }

}

兩種組合方式

  • @AutoArrow + @AutoBow + @AutoTarget扩淀,三者關(guān)系為 n:1:1

  • @AutoBowArrow + @AutoTarget ,兩者比例關(guān)系為 1:1

編譯后啤挎,被注入的代碼樣式

打包成apk后驻谆,@AutoTarget標記的方法將會被注入具有固定結(jié)構(gòu)的代碼,例如:

// @AutoArrow + @AutoBow + @AutoTarget 組合

@AutoTarget
void addIndex2EventBus() {
    ModuleBAutoArrow moduleBAutoArrow = new ModuleBAutoArrow();
    EventBusAutoBow eventBusAutoBow = new EventBusAutoBow(this);
    eventBusAutoBow.shoot(moduleBAutoArrow.get());
    ...
    eventBusAutoBow.shoot(***.get());
}

// @AutoBowArrow + @AutoTarget 組合

@AutoTarget
void init() {
    InitAutoBowArrow initAutoBowArrow = new InitAutoBowArrow();
    initAutoBowArrow.shoot();
    ...
}

結(jié)語

本文并沒有詳細深入解釋Gradle Transform + ASM如何查找到類和方法并注入庆聘,源碼已上傳至github胜臊,方便自行研究。 github地址:https://github.com/EastWoodYang/AutoInject

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末伙判,一起剝皮案震驚了整個濱河市象对,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌澳腹,老刑警劉巖织盼,帶你破解...
    沈念sama閱讀 219,589評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件杨何,死亡現(xiàn)場離奇詭異,居然都是意外死亡沥邻,警方通過查閱死者的電腦和手機危虱,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,615評論 3 396
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來唐全,“玉大人埃跷,你說我怎么就攤上這事∮世” “怎么了弥雹?”我有些...
    開封第一講書人閱讀 165,933評論 0 356
  • 文/不壞的土叔 我叫張陵,是天一觀的道長延届。 經(jīng)常有香客問我剪勿,道長,這世上最難降的妖魔是什么方庭? 我笑而不...
    開封第一講書人閱讀 58,976評論 1 295
  • 正文 為了忘掉前任厕吉,我火速辦了婚禮,結(jié)果婚禮上械念,老公的妹妹穿的比我還像新娘头朱。我一直安慰自己,他們只是感情好龄减,可當我...
    茶點故事閱讀 67,999評論 6 393
  • 文/花漫 我一把揭開白布项钮。 她就那樣靜靜地躺著,像睡著了一般希停。 火紅的嫁衣襯著肌膚如雪烁巫。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,775評論 1 307
  • 那天脖苏,我揣著相機與錄音程拭,去河邊找鬼。 笑死棍潘,一個胖子當著我的面吹牛恃鞋,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播亦歉,決...
    沈念sama閱讀 40,474評論 3 420
  • 文/蒼蘭香墨 我猛地睜開眼恤浪,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了肴楷?” 一聲冷哼從身側(cè)響起水由,我...
    開封第一講書人閱讀 39,359評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎赛蔫,沒想到半個月后砂客,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體泥张,經(jīng)...
    沈念sama閱讀 45,854評論 1 317
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,007評論 3 338
  • 正文 我和宋清朗相戀三年鞠值,在試婚紗的時候發(fā)現(xiàn)自己被綠了媚创。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,146評論 1 351
  • 序言:一個原本活蹦亂跳的男人離奇死亡彤恶,死狀恐怖钞钙,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情声离,我是刑警寧澤芒炼,帶...
    沈念sama閱讀 35,826評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站术徊,受9級特大地震影響本刽,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜赠涮,卻給世界環(huán)境...
    茶點故事閱讀 41,484評論 3 331
  • 文/蒙蒙 一盅安、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧世囊,春花似錦、人聲如沸窿祥。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,029評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽晒衩。三九已至嗤瞎,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間听系,已是汗流浹背贝奇。 一陣腳步聲響...
    開封第一講書人閱讀 33,153評論 1 272
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留靠胜,地道東北人掉瞳。 一個月前我還...
    沈念sama閱讀 48,420評論 3 373
  • 正文 我出身青樓,卻偏偏與公主長得像浪漠,于是被迫代替她去往敵國和親陕习。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 45,107評論 2 356

推薦閱讀更多精彩內(nèi)容

  • Android組件化項目地址:Android組件化項目AndroidModulePattern Android組件...
    半灬邊灬天閱讀 2,922評論 4 37
  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 172,192評論 25 707
  • 這幾天科技圈已經(jīng)被iOS 的XcodeGhost 病毒事件刷屏址愿。目前已經(jīng)有多款應(yīng)用被證實感染了XcodeGhost...
    好讀書不求甚解閱讀 827評論 0 2
  • 幼年時 常纏著你講故事 無知而任性 青春期 總?cè)堑媚愫軅?驕縱而冷漠 但現(xiàn)在 愿為你做一桌晚餐 快樂而深情 你感...
    長安微雨閱讀 215評論 0 0
  • 小瑜在老家的一個服裝廠工作该镣,經(jīng)媒人介紹相親,認識了小海响谓,沒過多久兩人就領(lǐng)證結(jié)婚了损合。這事兒在老家是很普遍的省艳,家里老人...
    愛玩毛線的喵閱讀 219評論 1 0