Gradle 生態(tài)系統(tǒng)源碼分析

Gradle 起底 第一篇

亦余心之所善兮羡蛾,雖九死其猶未悔

Gradle 的源代碼地址 https://github.com/gradle/gradle ,可以看到Gradle的源碼里(基于 Gradle 大版本的 version 6)java 占比44% Groovy 占比46%昔逗,源碼里面大部分的核心代碼核心模塊都是java 語言編寫淹真,test 代碼主要是由Groovy語言編寫为障。

language.PNG

目錄結(jié)構(gòu)

往往高端的代碼都以一種樸素的呈現(xiàn)方式齐莲,以gradle-6.3-all 為例亿鲜,解壓之后目錄結(jié)構(gòu)如下:


***bin

*****gradle(unix and linux 啟動腳本)

*****gradle.bat(windows 啟動腳本)

***docs

***init.d(自定義的init.gradle 位置)

***lib(編譯好的jar包)

***src(源碼)

**LICENSE

**NOTICE

**README

啟動Gradle就是從bin 目錄下的啟動腳本文件觸發(fā)到lib目錄下的jar里的某個java的main函數(shù)允蜈。以gradle.bat 為例,其中最終調(diào)用的位置如下:入口類是org.gradle.launcher.GradleMain蒿柳。

"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.launcher.GradleMain %CMD_LINE_ARGS%

如果這個時候繼續(xù)跟著這個GradleMain深入閱讀源碼的話饶套,很快就會陷入一堆細(xì)節(jié),所以在這里就不繼續(xù)深入了垒探。

Gradle 腳本文件

那我們換個方向來再去觀察 Gradle 妓蛮。".gradle" 文件是一個很好的入手點:


apply plugin: 'java'

...

dependencies {

    compile 'org.codehaus.groovy:groovy-all:2.3.11'

  ...

}

看到這個文件很熟悉但是肯定有很多疑問,比如 apply plugin: 'java' 干什么了圾叼,誰來編譯它或者解釋它給機(jī)器呢等等蛤克,為了能解答這個問題,需要好好了解一下Groovy夷蚊。".gradle" 文件其實就是Groovy的的腳本文件构挤。在這里我簡單的以java程序員可以理解的方式解釋一下apply plugin: 'java',在Gradle代碼中有一個java函數(shù)它的名字是apply惕鼓,它的參數(shù)是一個閉包:


  public void apply(Closure<?> closure){
    ....
  }

什么是閉包請找代駕:http://groovy-lang.org/closures.html

要強(qiáng)調(diào)一點哈筋现,Groovy 是基于JVM,所以呢箱歧, 這個腳本文件也是會像java文件一樣被編譯成.class 文件矾飞, 然后被加到j(luò)vm虛擬機(jī)里運(yùn)行。

所以就可以從網(wǎng)絡(luò)上繼續(xù)獲取Groovy 腳本的運(yùn)行原理呀邢, 以及Groovy 作為DSL的支柱: 元對象協(xié)議(Meta Object Protocol)簡稱MOP洒沦,基于這個協(xié)議就有了運(yùn)行時和編譯時的兩種 metaprogramming, 細(xì)節(jié)和干貨都在這個鏈接里面 http://groovy-lang.org/metaprogramming.html驼鹅。

如果上面的鏈接你都看完了微谓, 那你的英語應(yīng)該過了六級森篷。回正題豺型,要了解".gradle"文件的運(yùn)行仲智。先把腳本文件編譯出來的class 文件show 出來。


....

public class build_xxxx extends ProjectScript{

....

     public Object run()

    {

        CallSite acallsite[] = $getCallSiteArray();

        acallsite[0].callCurrent(this,ScriptBytecodeAdapter.createMap(new Object[] {

            "plugin", "java"

        }));

       ...

    }

    private static void $createCallSiteArray_1(String as[])

    {

        as[0] = "apply";

        ...

    }

    private static CallSite[] $getCallSiteArray()

    {

      ...

        callsitearray = $createCallSiteArray_1(s);

      ...

        return callsitearray.array;

    }

}

熟悉Groovy Script 腳本的同學(xué)大概就知道姻氨,這個腳本的run方法是運(yùn)行的入口, 通過上邊所提到過的MOP钓辆,就把腳本的編譯和方法的調(diào)用分開了(這里用到的是的運(yùn)行時的metaprogramming),簡單描述就是編譯的時候腳本文件只要符合Groovy 或者java語法要求肴焊,而函數(shù)的具體實現(xiàn)在編譯期是不需要知道的前联,只是記錄函數(shù)的名字和參數(shù),在運(yùn)行的時候根據(jù)特定的查找順序去尋找方法的調(diào)用娶眷,沒圖沒真相似嗤, 上圖:

groovyRTMOP.png

Gradle 腳本的編譯與調(diào)用時機(jī)

在上面的段落里簡單的過了一下腳本的一些信息吧, 現(xiàn)在肯定有同學(xué)會覺得更加疑問届宠, 這個腳本是誰去編程class的烁落,OK, 首先當(dāng)然是你的電腦豌注,并且也是你正在運(yùn)行的Gradle去編譯的伤塌,Gradle 運(yùn)行之后不久就會查找settings.gradle,然后通過settings.gradle 里的project的配置去一一查找并且編譯那些build.gradle 文件轧铁,對于'apply from : "xx.gradle"' 串聯(lián)的腳本文件每聪, 是在執(zhí)行到 apply 這個方法的時候去查找并且編譯的。這里我就直接先給出Gradle 源碼里的相關(guān)類:DefaultScriptCompilationHandler.java 以及一個代碼片段吧:當(dāng)然首先要澄清一下這里省略了很多邏輯齿风,比如buildscript{} 代碼塊里的代碼會先于普通代碼的編譯药薯,以及gradle的編譯緩存機(jī)制(就是沒改變的不會再次編譯)。


 private void compileScript(ScriptSource source, ClassLoader classLoader, CompilerConfiguration configuration, File metadataDir,

                               final CompileOperation<?> extractingTransformer, final Action<? super ClassNode> customVerifier) {

      ...

        GroovyClassLoader groovyClassLoader = new GroovyClassLoader(classLoader, configuration, false) ...

        groovyClassLoader.setResourceLoader(NO_OP_GROOVY_RESOURCE_LOADER);

        String scriptText = source.getResource().getText();

        String scriptName = source.getClassName();

        GroovyCodeSource codeSource = new GroovyCodeSource(scriptText == null ? "" : scriptText, scriptName, "/groovy/script");

        try {

            try {

                groovyClassLoader.parseClass(codeSource, false);

           ...

    }

groovyClassLoader.parseClass 這個怎么生成class, 不是本文的范疇救斑。編譯好的class文件會放在.gradle\caches\版本號\scripts-remapped 目錄下果善。

關(guān)于調(diào)用時機(jī),先關(guān)的類先放出來:DefaultScriptRunnerFactory.java系谐。


            ...

            T script = getScript();

            script.init(target, scriptServices);

            Thread.currentThread().setContextClassLoader(script.getContextClassloader());

            script.getStandardOutputCapture().start();

            try {

                script.run();

            } catch (Throwable e) {

            ...

邊(編)玩(完)就run巾陕,果然比較牛逼:如下圖。


 ...

            //Pass 2, compile everything except buildscript {}, pluginManagement{}, and plugin requests, then run

            final ScriptTarget scriptTarget = secondPassTarget(target);

            scriptType = scriptTarget.getScriptClass();

            CompileOperation<BuildScriptData> operation = compileOperationFactory.getScriptCompileOperation(scriptSource, scriptTarget);

            final ScriptRunner<? extends BasicScript, BuildScriptData> runner = compiler.compile(scriptType, operation, targetScope, ClosureCreationInterceptingVerifier.INSTANCE);

            if (scriptTarget.getSupportsMethodInheritance() && runner.getHasMethods()) {

                scriptTarget.attachScript(runner.getScript());

            }

            if (!runner.getRunDoesSomething()) {

                return;

            }

            Runnable buildScriptRunner = () -> runner.run(target, services);

Gradle 腳本的函數(shù)的調(diào)用

在上面的某個地方應(yīng)該提到過MOP纪他,Groovy 擁有一套查找機(jī)制鄙煤,當(dāng)然僅僅憑借這一點的靈活性完全無法滿足Gradle 那些優(yōu)(變)雅(態(tài))的需求。所以Gradle源碼又創(chuàng)建了DynamicObject所引申出來的一套函數(shù)和屬性的查找機(jī)制茶袒。有點復(fù)雜會在后面續(xù)的文章里講解梯刚。如果你等待不急的話也可以從我基于Gradle思想,所創(chuàng)建的一個log 分析項目的源代碼看看:https://github.com/tianxunaicaoke/LogSpin薪寓,畢竟我的代碼(需)比(要)Gradle(你)的(來)源(點)碼(亮)簡(星)單(星)多了亡资。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末澜共,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子锥腻,更是在濱河造成了極大的恐慌嗦董,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,402評論 6 499
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件瘦黑,死亡現(xiàn)場離奇詭異京革,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)幸斥,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,377評論 3 392
  • 文/潘曉璐 我一進(jìn)店門匹摇,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人甲葬,你說我怎么就攤上這事廊勃。” “怎么了经窖?”我有些...
    開封第一講書人閱讀 162,483評論 0 353
  • 文/不壞的土叔 我叫張陵供搀,是天一觀的道長。 經(jīng)常有香客問我钠至,道長,這世上最難降的妖魔是什么胎源? 我笑而不...
    開封第一講書人閱讀 58,165評論 1 292
  • 正文 為了忘掉前任棉钧,我火速辦了婚禮,結(jié)果婚禮上涕蚤,老公的妹妹穿的比我還像新娘宪卿。我一直安慰自己,他們只是感情好万栅,可當(dāng)我...
    茶點故事閱讀 67,176評論 6 388
  • 文/花漫 我一把揭開白布佑钾。 她就那樣靜靜地躺著,像睡著了一般烦粒。 火紅的嫁衣襯著肌膚如雪休溶。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,146評論 1 297
  • 那天扰她,我揣著相機(jī)與錄音兽掰,去河邊找鬼。 笑死徒役,一個胖子當(dāng)著我的面吹牛孽尽,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播忧勿,決...
    沈念sama閱讀 40,032評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼杉女,長吁一口氣:“原來是場噩夢啊……” “哼瞻讽!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起熏挎,我...
    開封第一講書人閱讀 38,896評論 0 274
  • 序言:老撾萬榮一對情侶失蹤速勇,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后婆瓜,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體快集,經(jīng)...
    沈念sama閱讀 45,311評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,536評論 2 332
  • 正文 我和宋清朗相戀三年廉白,在試婚紗的時候發(fā)現(xiàn)自己被綠了个初。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,696評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡猴蹂,死狀恐怖院溺,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情磅轻,我是刑警寧澤珍逸,帶...
    沈念sama閱讀 35,413評論 5 343
  • 正文 年R本政府宣布,位于F島的核電站聋溜,受9級特大地震影響谆膳,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜撮躁,卻給世界環(huán)境...
    茶點故事閱讀 41,008評論 3 325
  • 文/蒙蒙 一漱病、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧把曼,春花似錦杨帽、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至叙赚,卻和暖如春老客,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背震叮。 一陣腳步聲響...
    開封第一講書人閱讀 32,815評論 1 269
  • 我被黑心中介騙來泰國打工沿量, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人冤荆。 一個月前我還...
    沈念sama閱讀 47,698評論 2 368
  • 正文 我出身青樓朴则,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子乌妒,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,592評論 2 353

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