JCConf2015: groovy to gradle

info: https://github.com/qrtt1/JCConf2015_from_groovy_to_gradle

Transcript

1. 由 GROOVY 到 GRADLE qrtt1 #JCConf
2. 忙碌的開發者 ‧ 哪有時間看書呢！？看官網應該就夠了唄！ ‧ 換上 Android Studio 它就在了！什麼？你說那東西 叫 Gradle ？ ‧ 總是在網路上的茫茫大海找 Gradle 秘技 ‧ Gradle 文件看了，好像懂了，又好像沒懂
3. 試著學一下 Gradle
4. 簡單來說 ‧ 知道怎麼安裝（Android Studio User：竟然要安裝！） ‧ 知道怎麼寫 task ‧ 知道怎麼編譯 java 專案 ‧ 懂得相依管理 ‧ (那 Android Developer 咧！？) ‧ (那 Android Developer 咧！？) ‧ (那 Android Developer 咧！？)
5. CH6.1 基本 Script 教學 ‧ Gradle Script 由二個基本概念構成 ‧ project：含 1 個或多個 project ‧ task：每個 project 可以有 0 個或多個 task
6. CH6.2 Hello World task hello { doLast { println 'Hello world!' } } ͜
   task
   ᗫᒟοd່֛อٙ
   task
   
7. CH6.2 Hello World task hello { doLast { println 'Hello world!' } } Ύ׳ɓଡ଼
   {}
   Ύᄳࡈ
   doLast
   Ύɓࡈ
   {}
   n ଣ༆Ѣᗭ
   ©
8. CH6.3 Hello World task hello << { println 'Hello world!' } Νᅵ͜
   task
   ᗫᒟο
   n
   Ύ̋ɪ << ڛ৺lЫᒔ݊Ⴍʕ˖ыlk
9. CH6.4 Script are code task upper << { String someString = 'mY_nAmE' println "Original: " + someString println "Upper case: " + someString.toUpperCase() } task count << { 4.times { print "$it " } } ್ܝۤlk
10. CH6.5 Task Dependencies task hello << { println 'Hello world!' } task intro(dependsOn: hello) << { println "I'm Gradle" } ᐏ੻อҦঐdண֛
    task
    ޴Աᗫڷ
11. CH6.6 Dynamic Task 4.times { counter -> task "task$counter" << { println "I'm task number $counter" } } 《重新認識你的 int》Groovy 萬物皆物件 repeat method
    ၾ
    groovy closure ঐ઺ᓃྼٙ͜؇Г෗lk
12. CH6.7 Dynamic Task task hello << { println 'Hello Earth' } hello.doFirst { println 'Hello Venus' } hello.doLast { println 'Hello Mars' } hello << { println 'Hello Jupiter' } ڋኪ٫ࡁl
 ᒔᅟ੻ɨ̘෗k
13. CH6.9 Extra Task properties task myTask { ext.myProperty = "myValue" } task printTaskProperties << { println myTask.myProperty }
14. CH6.10 Using Ant Task task loadfile << { def files = file('../antLoadfileResources').listFiles().sort() files.each { File file -> if (file.isFile()) { ant.loadfile(srcFile: file, property: file.name) println " *** $file.name ***" println "${ant.properties[file.name]}" } } } ο˄ʃlఱ݊ʔࠠࠅ ତί
15. CH6.11 Using Methods task checksum << { fileList('../antLoadfileResources').each {File file -> ant.checksum(file: file, property: "cs_$file.name") println "$file.name Checksum: ${ant.properties["cs_$file.name"]}" } } task loadfile << { fileList('../antLoadfileResources').each {File file -> ant.loadfile(srcFile: file, property: file.name) println "I'm fond of $file.name" } } File[] fileList(String dir) { file(dir).listFiles({ file -> file.isFile() }as FileFilter).sort() } ࠅᄳ
    NFUIPE
    ɰБဈl
16. CH6.13 Configure by DAG gradle.taskGraph.whenReady {taskGraph -> if (taskGraph.hasTask(release)) { version = '1.0' } else { version = '1.0-SNAPSHOT' } }
17. 你會 Gradle 了！
18. 還有 Gradle DSL
19. 要繼續下一關嗎？ GOTO CH7
20. 我不想懂，它能動就好 ً࿒ᜑͪjඟʾʊ৬ɳ
21. ʔࠅ在官網上學 Gradle
22. 如果有時間...
23. 讀後心得 ‧ Groovy 真是個兼容各家懶人語法的語言 ‧ 理解 Gradle DSL 可以先由 Groovy Feature 開始
24. 基本認知 ‧Gradle Script 就是 Groovy Script ‧Gradle Script 即為 Groovy DSL ‧蝦毁！要學新的語言！？ ‧Groovy 相容於『大部分』Java 語法 ‧Groovy 能省略 () 與 ; ‧支援 Closure (Code Block)
25. Groovy 常用語法 In Gradle อ ‧ Bean 自動產生 setter/getter ‧ 常用容器 List 與 Map 直接在語法上支援 ‧ 具有 Closure 的設計，能取代匿名類別的常用情景 ‧ 配合 () 省略，讓 Closure 寫起來像 method body
26. Groovy 常用語法 In Gradle อ http://www.groovy-lang.org/syntax.html def colors = [ red: '#FF0000', green: '#00FF00', blue: '#0000FF'] def map = [:] optional typing 懶得寫 type 就用 def (其實就是 Object) 看到 [] 就是容器， 看到 : 就是 Map new HashMap()
27. Groovy 常用語法 In Gradle อ http://www.groovy-lang.org/syntax.html def numbers = [1, 2, 3] 看到 [] 就是容器，看到，又沒寫 type 就是 List String[] arrStr = ['Ananas', 'Banana', 'Kiwi'] new ArrayList()
28. Groovy 常用語法 In Gradle อ http://www.groovy-lang.org/syntax.html ["hello", "world"].each({ println it }) {} 放在參數列或被當成變數內容，就是 Closure 物件 it 是預設的參數名稱 ["hello", “world"].each({ elem -> println elem }) 可以變更參數名稱，用 -> 隔開就行了
29. Groovy 常用語法 In Gradle อ file("build.gradle").withReader { reader -> reader.eachWithIndex { it, line -> println "${line+1} $it" } } 語法省略 () 的效果，讓 Closure 看起來像 Method Body 所以，實作 DSL 時，常把 Closure 參數放在最後 1 個
30. Groovy 常用語法 In Gradle อ apply plugin: 'java' sourceSets { main { java { exclude 'some/unwanted/package/**' } } } 這是 Map sourceSets 調整是 Closure & Method Invoke
31. 《欣賞一下 Groovy Code》 001_bean.groovy 002_collection.groovy
32. ‧ Closure 支援 delegate 機制 task copyDocs(type: Copy) { from 'src/main/doc' into 'build/target/doc' } \^
    DMPTVSF
    ਗ਼ྼЪ
    EFMFHBUF
    ഗ
    $PQZ https://docs.gradle.org/current/javadoc/org/gradle/api/tasks/Copy.html Groovy DSL Features
33. 《欣賞一下 Groovy Code》 003_closure.groovy
34. ‧ Compiler 提供可客製化的 AST Transformations ‧ 對 gradle 來說 ‧ task 是 keyword 用來宣告新的 task ‧ helloworld 是 task 名稱 ‧ 對 groovy 來說 ‧ task 是個 method invoke (呼叫 Script 的 BaseClass) ‧ helloworld 是 method 的參數，也是未定義的變數 task helloworld << { println 'Hello World' } Groovy DSL Features
35. ‧ AST Transformations：處理 task method invoke task helloworld << { println 'Hello World' } 透過 AST Transformation 轉成 task("helloworld") https://github.com/gradle/gradle/blob/master/subprojects/core/src/main/groovy/org/gradle/groovy/scripts/internal/ TaskDefinitionScriptTransformer.java Groovy DSL Features
36. Groovy DSL Features ‧ 支援 Meta Programming (透過 MOP 的 method hooking 機制)。讓你在 build script 可以 access 到 plugin 新增的 method 或是 properties apply plugin: 'java' sourceCompatibility = 1.8 targetCompatibility = 1.8 manifest {} sourceSets {} Ϟซཀމʡჿவჿᄳঐਗ෗k https://docs.gradle.org/current/javadoc/org/gradle/api/ Project.html#property(java.lang.String) MetaObjectProtocol
37. 《欣賞一下 Groovy Code》 004_mop.groovy
38. ‧ Compiler 支援 DSL 設定 scriptBaseClass Groovy DSL Features build.gradle file(…) .scriptBaseClass = ProjectScript.class Project .file(…) (MOP Method Hooks)
39. 目前為止的新知 ‧ Gradle DSL 出現的 {} 大部分都是 Closure ‧ Closure 可透過指定 delegate 來委派實作 ‧ 看到 [] 就想到容器，看到 [] 內有 : 就是個 Map 容 器，單獨看到 : 也要想到是個 Map
40. 目前為止的新知 ‧ build script 的 scriptBaseClass 是 ProjectScript ‧ ProjectScript 透過 MOP 委派工作給 Project 物件 ‧ Project 提供常用 method 並透過 MOP 委派 method invoke 或 properties access 給其它物件 ‧ task 關鍵字會被轉換為 task method，而 task name 轉為字串傳入
41. 讓我們再重來一次 GOTO CH6
42. CH6.2 Hello World task hello { doLast { println 'Hello world!' } } ͜
    task
    ᗫᒟοd່֛อٙ
    task
    
43. task hello { doLast { println 'Hello world!' } } CH6.2 Hello World ͜
    task 關鍵字，會被 AST 轉為 task method。 hello 會被轉為字串，作為 task method 的參數
44. task hello { doLast { println 'Hello world!' } } CH6.2 Hello World ͜
    依據 build script 的 baseClass 最終將工作委派給 Project 物件，預期能在它上面找到相關 method
45. task hello { doLast { println 'Hello world!' } } CH6.2 Hello World ͜
    它應該對應到下面哪一個 task method 呢？
46. task hello { doLast { println 'Hello world!' } } CH6.2 Hello World ͜
    前 2 組有 Map<String, ?>，但在 Script 沒出現：
47. task hello { doLast { println 'Hello world!' } } CH6.2 Hello World ͜
    第 3 組只有唯一的 name 參數， 而第 4 組有 name, closure。
 符合看到 {} 幾乎是 closure
48. task hello { doLast { println 'Hello world!' } } CH6.2 Hello World ટഹdҢࡁԸพ֛வଡ଼
    DMPTVSF QSPKFDU
    ܔ
    
    ࡈ
    UBTL
    ي΁ܝdխ̣
    DPOGJHVSF
    ˙ج
49. task hello { doLast { println 'Hello world!' } } CH6.2 Hello World EP-BTU
    ݊ም࢕ٙ
    NFUIPE
    ճk
 Ϋซɓɨ
    DMPTVSF
    EFMFHBUF 《用 gradle 做個小實驗》 வ݊
    DPOGJHVSF
    DMPTVSF
50. CH6.3 Hello World task hello << { println 'Hello world!' } Νᅵ͜
    task
    ᗫᒟο
    n
    Ύ̋ɪ << 《繼續看 gradle 實作》
51. CH6.5 Task Dependencies task intro(dependsOn: hello) << { println "I'm Gradle" } 它應該對應到下面哪一個 task method 呢？ வ݊
    .BQ
52. ‧ build script 透過 baseClass 委派 ProjectScript ‧ ProjectScript 透過 MOP 委派 Project ‧ Project 透過 MOP 委派給「中介物件」 ‧ ExtensibleDynamicObject 重塑 Gradle 的世界觀 Project 物件中的 property 或 method 的 resolver
53. 《Property Scope：How gradle resolve property》 ExtensibleDynamicObject https://github.com/gradle/gradle/blob/master/subprojects/core/src/main/groovy/org/gradle/api/internal/ExtensibleDynamicObject.java Project 的 javadoc 有寫： ο˄ʃlఱ݊ʔࠠࠅ
    ᐼʘdʹഗ
    &YUFOTJCMF%ZOBNJD0CKFDU
    ఱ࿁əl ତί
54. CH7.2.3 Customizing the project Chapter 7. Java Quickstart sourceCompatibility = 1.5 version = '1.0' manifest { attributes 'Implementation-Title': 'Gradle Quickstart', 'Implementation-Version': version } ExtensibleDynamicObject java plugin class JavaPluginConvention { def sourceCompatibility def version def manifest(Closure) {} } 將 domain object 註冊為 convention 透過 project 的 extensible-dynamic-object 設定 domain object
55. 你會 Gradle 了！
56. 由 groovy 到 gradle ‧ 透過理解 groovy 語法與 DSL feature 培養另一種 看待 gradle 的「審美觀」（視角） ‧ 透過閱讀 gradle 程式碼取得比「文件」更直接的訊 息，而理解 gradle 的運作方式 ‧ gradle 內還有許多精巧的設計，是 groovy DSL 之 外的部分需深入研究，但只要把握著它最終會透過 groovy DSL 實現，就無需有太多的憂慮
57. Q&A