這是我...第一次寫blog...
總感覺做開發(fā)的還是要寫點(diǎn)這種分享,之前一直沒有付出行動,嗯,因?yàn)閼校际亲约和低得淈c(diǎn)小筆記。年底剛換了個(gè)新環(huán)境,也不能總是搞業(yè)務(wù)吧,還是要有點(diǎn)規(guī)劃和方向的。于是在主管的開導(dǎo)下,開始接觸自定義gradle插件開發(fā)。因?yàn)榻裉焓谴汗?jié)放假前最后一天呀,還是我生日.. 在這么個(gè)特殊的日子的,決定開始我的blog,先劃一波水...
進(jìn)入主題:
首先,插件可以以三種方式存在:
在我們構(gòu)建的app項(xiàng)目下的build.gradle腳本中直接編寫
在我們構(gòu)建項(xiàng)目的rootProjectDir/buildSrc/src/main/groovy目錄下
以單獨(dú)的project存在
這里我采用第三種,單獨(dú)創(chuàng)建Gradle Plugin 工程,這種方式的好處在于可以將插件打包發(fā)布,并很好的分享給使用者。
?創(chuàng)建Gradle Module
1.首先,file? ---> new module創(chuàng)建一個(gè)module, 這里用android library
2.刪除不必要的包/文件,只保留build.gradle文件和src/main目錄。 圖2 -> 圖3的過程
3.由于gradle是基于groovy,因此,我們開發(fā)的gradle插件相當(dāng)于一個(gè)groovy項(xiàng)目。所以需要在main目錄下新建groovy目錄,在groovy目錄下新建包名,在該包下新建groovy文件,通過new->file->JbzPlugin.groovy來新建名為JbzPlugin的groovy文件。
這里對我來說有個(gè)巨坑,Plugin類的創(chuàng)建一定要是通過new->file->JbzPlugin.groovy來新建名為JbzPlugin的groovy文件,注意:要直接在命名的時(shí)候就輸入后綴.groovy!!!如果通過輸入JbzPlugin再在選擇文件類型的時(shí)候選groovy模版,這樣不行,會一直報(bào)圖5的error
然后我在網(wǎng)上查了各種資料,什么刪除項(xiàng)目的.gradle和本地的.gradle,各種clean,降低gradle版本(因?yàn)榈谝淮蝿?chuàng)建出來的自定義gradle插件是可行的,但是后來可能看到了選擇類型這種創(chuàng)建方式,忘記第一次怎么創(chuàng)建出來的,正好這兩天發(fā)現(xiàn)自己gradle版本升到了4.1,以為是gradle版本升高了的關(guān)系,(關(guān)于gradle降版本要將gradle包下的整個(gè)wrapper都替換掉,不僅僅是修改gradle-wrapper.properties里面的版本號, gradle-wrapper.jar這個(gè)包也要替換掉)),結(jié)果都不行,郁悶了我好幾天。。
奇怪的是通過new->file->JbzPlugin.groovy這種正確的創(chuàng)建方式創(chuàng)建出來的類底部會有報(bào)錯(cuò)的紅線,提示class xxx(類名) already exites in xxx(包路徑)? 雖然不影響程序的運(yùn)行。。。 最后解決之后我看了下本地的文件,打開文件所在地址,可以看到正確的創(chuàng)建方式文件名是JbzPlugin.groovy,而通過選擇類型創(chuàng)建的文件名是JbzPlugin。 所以雖然在IDE中看不出兩個(gè)類的區(qū)別,但是在本地還是有區(qū)別的。
4.新建JbzPlugin這個(gè)plugin類之后先不要在里面寫class JbzPlugin implements Plugin等等代碼,因?yàn)榇藭r(shí)你還無法導(dǎo)入Plugin類,你要先去配置build.gradle文件,將默認(rèn)的android的build.gradle替換成如下內(nèi)容
uploadArchives代碼是將已經(jīng)自定義好了插件打包到本地Maven庫里面去了,你也可以選擇打包到遠(yuǎn)程服務(wù)器中。其中,group和version是我們之后配置插件地址時(shí)要用到的。
5.好了,先將build.gradle配置好后我們回到JbzPlugin類中,這時(shí)候你已經(jīng)引用apply plugin:'groovy'了(這個(gè)就是你自定義插件的開發(fā)語言,其中包含了各種功能類)。代碼如下:
6.現(xiàn)在,我們已經(jīng)定義好了自己的gradle插件的plugin類,接下來就是告訴gradle,哪一個(gè)是我們自定義的plugin插件類,因此,需要在main目錄下新建resources目錄,然后在resources目錄里面再新建META-INF目錄,再在META-INF里面新建gradle-plugins目錄。最后在gradle-plugins目錄里面新建properties文件,注意這個(gè)文件的命名,你可以隨意取名,但是后面使用這個(gè)插件的時(shí)候,會用到這個(gè)名字。比如,你取名為com.jbz.gradle.properties,在里面關(guān)聯(lián)你的插件plugin類。代碼如下:
? ??????????????????????????????????implementation-class=com.jbz.JbzPlugin
其中com.jbz是你的路徑。
至此,你已經(jīng)初步完成了你的自定義gradle插件。
7.點(diǎn)擊AndroidStudio右側(cè)的gradle工具,如下圖所示:
可以看到有uploadArchives這個(gè)Task,雙擊uploadArchives就會執(zhí)行打包上傳到你的本地倉庫!執(zhí)行完成后,你會發(fā)現(xiàn)root目錄下多了一個(gè)repo文件,這就是你本地的Maven倉庫,其中,com/jbz這幾層目錄是由我們的group指定,gradlelibrary是模塊的名稱,1.0.0是版本號(version指定)。
8.使用自定義gradle插件
在app 的build.gradle 中添加apply plugin:'com.jbz.gradle', 這里的com.jbz.gradle就是resources包下的那個(gè)文件名前綴(這千萬別寫錯(cuò)了),然后再添加如下buildscript,你只需添加repo, repos是我自己測試時(shí)寫的另一個(gè)maven倉庫,依賴只需要寫你自己的classpath,如:classpath'com.jbz.test:jbzlibrary:1.0.0'
這里先寫buildscript,然后sync now,再添加apply plugin:'com.jbz.gradle',再sync now,否則會報(bào)錯(cuò)。此時(shí)你已經(jīng)完成所以工作了,然后你會在app的other目錄下找到一個(gè)名叫jbzTask的,這個(gè)就是你在plugin類中定義的jbzTask
雙擊jbzTask,你可以在控制臺上看到輸入的內(nèi)容
好了,以上就是基本所有流程了。
寫的時(shí)候自己都覺得亂。。感覺在攪一坨屎。。。知識點(diǎn)都在腦子里,個(gè)人表達(dá)能力實(shí)在有限。 還有就是重點(diǎn)。。。我要放假啦!!! 有緣再見~
其他1:如果因?yàn)樾薷牧瞬寮鴮?dǎo)致app的build.gradle中報(bào)錯(cuò),要先注釋掉
其他1:記住,所有在插件上的更新操作,都要uploadArchives才能跑,如果你在插件中新寫的代碼有問題,而你已經(jīng)uploadArchives導(dǎo)致app的build.gradle中報(bào)錯(cuò),要先注釋掉自定義的apply plugin: 'xxx',否則即使你修改正確,sync now還是無法成功。? ? ?例如一個(gè)gradle插件中已經(jīng)有一個(gè)testTask, 當(dāng)你在另一個(gè)gradle插件中再創(chuàng)建一個(gè)testTask時(shí),第一次uploadArchives可以通過,但你再uploadArchives或者進(jìn)行功能測試時(shí)會提示你testTask在xxxgradle中已經(jīng)存在,此時(shí)如果你直接修改testtask命名再點(diǎn)sync now是無法通過的,因?yàn)榈谝淮蝩ploadArchives已經(jīng)將代碼編譯進(jìn)去了,你要先注釋掉apply plugin: 'com.jbz.boom'(不編譯這個(gè)gradle),再去修改task命名,然后uploadArchives更新編譯,最后把注釋消除,sync now。
其他2:
allprojects {
? ? afterEvaluate { project ->
? ? ? ? project.task('testTask') << {
? ? ? ? ? ? System.out.println("========================")
? ? ? ? ? ? println "Running tests for $project"
? ? ? ? ? ? System.out.println("========================")
? ? ? ? }
? ? }
}
這段代碼寫在rootproject的bulid.gradle中,當(dāng)你執(zhí)行testktask時(shí)就會打印出每個(gè)project的名稱,右側(cè)每個(gè)gradle的other下都會出現(xiàn)一個(gè)testTask表示當(dāng)前的任務(wù);寫在某個(gè)subproject下時(shí)只代表當(dāng)前gradle下的任務(wù)
還有其他一些高級點(diǎn)的比如Extension等東西,因?yàn)榇汗?jié)回家的心情已經(jīng)快要按耐不住了,在此附加幾個(gè)鏈接,我就不再重復(fù)了。。
http://www.lxweimin.com/p/d53399cd507b
http://www.lxweimin.com/p/af2b0a43133f
http://www.lxweimin.com/p/bcaf9a269d96