Gradle 起底 第一篇
亦余心之所善兮羡蛾,雖九死其猶未悔
Gradle 的源代碼地址 https://github.com/gradle/gradle ,可以看到Gradle的源碼里(基于 Gradle 大版本的 version 6)java 占比44% Groovy 占比46%昔逗,源碼里面大部分的核心代碼核心模塊都是java 語言編寫淹真,test 代碼主要是由Groovy語言編寫为障。
目錄結(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)用娶眷,沒圖沒真相似嗤, 上圖:
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(你)的(來)源(點)碼(亮)簡(星)單(星)多了亡资。