Android Transform API

上一章知道如何自定義 Gradle插件后邑时,我們到底可以用來做什么呢锚烦?難道只是用來定義一些簡(jiǎn)單的 Task牙言?本章給你答案跟匆!

什么是 Transform API

Android Gradle 工具從 1.5.0-beta1 版本開始赞赖,包含了 Transform API滚朵,它允許第三方插件在將編譯后的類文件轉(zhuǎn)換為 dex 文件之前對(duì) .class 文件進(jìn)行操作。

Transform 的工作原理

接下來看下它的工作原理:

Transform 工作原理
  • 很明顯它是一個(gè)鏈?zhǔn)浇Y(jié)構(gòu)前域,每個(gè) Transform 都是一個(gè) Gradle 的 Task辕近,Android 編譯器通過 TaskManager 將每個(gè) Transform 串聯(lián)起來。
  • 第一個(gè) Transform 接收 javac 編譯的結(jié)果匿垄,以及 jar 包依賴和 resource 資源移宅,這些編譯的中間產(chǎn)物在 Transform 鏈上流動(dòng)。其中椿疗,我們自定義的 Transform 會(huì)插入到最前面

Transform API 的使用

Transform API 其實(shí)就是繼承自 Transform 寫一個(gè)實(shí)現(xiàn)類漏峰,我們看下 Transform 需要實(shí)現(xiàn)的方法:

Transform 需要實(shí)現(xiàn)的方法

簡(jiǎn)單介紹下這幾個(gè)方法:

getName():用于指定 Transform 的名字,對(duì)應(yīng)了該 Transform 所代表的 Task 的名稱届榄,例如:

image

isIncremental():方法指明是否支持增量編譯浅乔。

getInputTypes():用于指定 Transform 的輸入類型,可以作為輸入過濾的一種手段痒蓬。在 TransformManager 中定義了很多類型:

  • CONTENT_CLASS // 代表 javac 編譯成的 class 文件(一般用它)
  • CONTENT_JARS
  • CONTENT_RESOURCES // 這里的 resources 單指 java 的資源
  • CONTENT_NATIVE_LIBS
  • CONTENT_DEX
  • CONTENT_DEX_WITH_RESOURCES
  • DATA_BINDING_BASE_CLASS_LOG_ARTIFACT

getScopes():用于指定 Transform 的作用域童擎。同樣在 TransformManager 中定義了很多類型,常用的是 SCOPE_FULL_PROJECT攻晒,即代表所有 Project顾复。

確定了 ContentType 和 Scope 后就確定了該自定義 Transform 需要處理的資源流。
例如鲁捏,上面提到的常用輸入類型(CONTENT_CLASS)和常用作用域(SCOPE_FULL_PROJECT)表示的就是 所有項(xiàng)目中 java 編譯成的 class 組成的資源流芯砸。

接下來我們來看需要復(fù)寫的核心方法:

image

TransformInvocation 接口定義如下:

image

看下 TransformInput 的接口定義:

所謂 Transform 就是對(duì)輸入的 class 文件轉(zhuǎn)變成目標(biāo)字節(jié)碼文件,TransformInput 就是這些輸入文件的抽象给梅。目前它包括兩部分:DirectoryInput 集合與 JarInput 集合假丧。

image

TransformOutputProvider 通過調(diào)用 getContentLocation 來獲取輸出目錄:

image

復(fù)寫完 Transform 的核心方法之后,我們需要通過插件注冊(cè)它才可使用:

image

整體看下 CustomTransform 類:

image

接下來看下讀取 class 文件的流程:

image

Demo 工程

Android 工程:https://github.com/changer0/ASMInjectDemo

以上就是本節(jié)內(nèi)容动羽,歡迎大家關(guān)注??????

長(zhǎng)按關(guān)注
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末包帚,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子运吓,更是在濱河造成了極大的恐慌渴邦,老刑警劉巖,帶你破解...
    沈念sama閱讀 219,188評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件拘哨,死亡現(xiàn)場(chǎng)離奇詭異谋梭,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)倦青,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,464評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門瓮床,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事隘庄√卟剑” “怎么了?”我有些...
    開封第一講書人閱讀 165,562評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵峭沦,是天一觀的道長(zhǎng)贾虽。 經(jīng)常有香客問我,道長(zhǎng)吼鱼,這世上最難降的妖魔是什么蓬豁? 我笑而不...
    開封第一講書人閱讀 58,893評(píng)論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮菇肃,結(jié)果婚禮上地粪,老公的妹妹穿的比我還像新娘。我一直安慰自己琐谤,他們只是感情好蟆技,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,917評(píng)論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著斗忌,像睡著了一般质礼。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上织阳,一...
    開封第一講書人閱讀 51,708評(píng)論 1 305
  • 那天眶蕉,我揣著相機(jī)與錄音,去河邊找鬼唧躲。 笑死造挽,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的弄痹。 我是一名探鬼主播饭入,決...
    沈念sama閱讀 40,430評(píng)論 3 420
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼肛真!你這毒婦竟也來了谐丢?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,342評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤蚓让,失蹤者是張志新(化名)和其女友劉穎乾忱,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體凭疮,經(jīng)...
    沈念sama閱讀 45,801評(píng)論 1 317
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,976評(píng)論 3 337
  • 正文 我和宋清朗相戀三年串述,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了执解。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,115評(píng)論 1 351
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖衰腌,靈堂內(nèi)的尸體忽然破棺而出新蟆,到底是詐尸還是另有隱情,我是刑警寧澤右蕊,帶...
    沈念sama閱讀 35,804評(píng)論 5 346
  • 正文 年R本政府宣布琼稻,位于F島的核電站,受9級(jí)特大地震影響饶囚,放射性物質(zhì)發(fā)生泄漏帕翻。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,458評(píng)論 3 331
  • 文/蒙蒙 一萝风、第九天 我趴在偏房一處隱蔽的房頂上張望嘀掸。 院中可真熱鬧,春花似錦规惰、人聲如沸睬塌。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,008評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽揩晴。三九已至,卻和暖如春贪磺,著一層夾襖步出監(jiān)牢的瞬間硫兰,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,135評(píng)論 1 272
  • 我被黑心中介騙來泰國(guó)打工缘挽, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留瞄崇,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,365評(píng)論 3 373
  • 正文 我出身青樓壕曼,卻偏偏與公主長(zhǎng)得像苏研,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子腮郊,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,055評(píng)論 2 355