iPlayground - Scripting in Swift

根據 https://twitter.com/marcuswu0814/status/1053648917710008320 討論，此talk 命名為「Scripting in Swift」並不精確，其主要內容講述如何透過Swift Package 製作CLI tool。 🙇‍♂️

Transcript

1. Scripting in Swift iPlayground Session Marcus Wu, Senior iOS Engineer @ Golface
2. About Me ‣ 我是Marcus ‣ Golface @ 新⽵竹 ‣ 軟體架構、⾃自動化測試愛好者 ‣ 偶爾做⼀一點流程⾃自動化 ‣ GitHub、Twitter：marcuswu0814
3. Golface TV
6. Agenda ▸ Why ▸ Getting Started ▸ Make an Example ▸ Where to Go From Here? ▸ Q&A
7. Why 為何⽤用Swift 寫Script
8. Why ▸ 在2018 年年⼤大部分的iOS Developer 都會Swift ▸ 不需花費額外成本學習其他Script lang. ▸ Swift 很潮
9. My Swift Script ▸ RemineBot ▸ XCAssetsFactory ▸ ObjcImportSorter
10. Getting Started Swift Package ⼩小知識
11. Swift Package WWDC 2018 - Session 411 - macOS
12. Swift Package WWDC 2018 - Session 411 - macOS ▸ 由數個Targets 組成 ▸ Target 可能有數個Dependencies ▸ Dependencies ⽤用Git 管，並記載於Package.swift ▸ 每個Target 可Build 成Library 或Executable，稱為Product
13. Swift Package WWDC 2018 - Session 411 - macOS
14. Swift Package Manager ▸ Open Source ▸ 管理理相依、易易於發布 ▸ 可運⾏行行於macOS、Ubuntu（⽬目前）
16. Package.Swift（Manifest）
18. More Detail https://github.com/marcuswu0814/iPlayground-DemoSwiftPM https://swift.org/package-manager/
19. Make an Example 說這麼多還不如給點Code
20. 在開始之前想問問⼤家
21. ⼤家寫Script 時常需要實作什麼︖
22. 常⽤操作
23. 常⽤操作 ▸ 帶參參數 kylef/Commander
24. 常⽤操作 ▸ 帶參參數 ▸ 使⽤用路路徑 kylef/Commander kylef/PathKit
25. 常⽤操作 ▸ 帶參參數 ▸ 使⽤用路路徑 ▸ 輸出有⾊色字體 kylef/Commander kylef/PathKit onevcat/Rainbow
26. 常⽤操作 ▸ 帶參參數 ▸ 使⽤用路路徑 ▸ 輸出有⾊色字體 ▸ 網路路 kylef/Commander kylef/PathKit onevcat/Rainbow IBM-Swift/SwiftyRequest
27. 常⽤操作 ▸ 帶參參數 ▸ 使⽤用路路徑 ▸ 輸出有⾊色字體 ▸ 網路路 kylef/Commander kylef/PathKit onevcat/Rainbow IBM-Swift/SwiftyRequest Alamofire
28. 常⽤操作 ▸ 帶參參數 ▸ 使⽤用路路徑 ▸ 輸出有⾊色字體 ▸ 網路路 kylef/Commander kylef/PathKit onevcat/Rainbow IBM-Swift/SwiftyRequest Alamofire 參參考 Issue：Alamofire on Linux Status
29. 回歸主題
30. 我寫過不少個Swift Package
31. Build 的指令太長時...
34. 所以我需要Makefile
35. 我希望可以⽤⼀⾏指令產⽣ Makefile for Swift Package
37. Project name Binary name
38. 開發⽤用的指令
39. Homebrew ⽤用的指令
40. Demo Source Code https://github.com/marcuswu0814/SwiftPMGen
41. Step 1. 準備專案
42. 使⽤用swift package init 來來建立新專案
43. Step 2. 產⽣生Xcode project file，清理理不需要的檔案
44. 使⽤用swift package generate-xcodeproj 來來建立Xcode project file
45. Swift Package 專案的Targets
46. ⾃自動⽣生成的Functional test template
47. Step 3. 新增Core target
48. 為什麼需要︖
49. 允許@testable import 的選項
51. 新增MakefileGenerator.swift 檔案，重新製作xcodeproj
52. Step 4. 寫單元測試
53. ExceptedResult 差不多像這樣
55. Step 5. 實作
56. 直接透過Multiline string literals 將參參數帶進去並回傳字串串
57. MakefileGenerator.swift 的Unit test
58. Step 6. 寫功能測試
64. Step 7. 實作Command 輸入，產出Makefile
65. ⽤用 kylef/Commander 實作main.swift
66. Executable 的Functional test
67. Step 8. 幫⾃自⼰己產⼀一個Makefile
69. !
70. 試⽤看看
73. 應該要⽤用Tab ⽽而不是空⽩白
74. Step 9. 修改測試與實作
75. ⽤用`\t` 代替空⽩白
78. Step 10. Release、CI、code coverage、Lint
79. Release Homebrew
82. 使⽤用brew create 來來建立Formula
83. Homebrew 會產⽣生⼀一個Formula.rb檔案，編輯Formula 內容
84. 準備⼀一個Repo. 來來放taps
86. 透過指定的taps 來來尋找Formula 安裝
87. Travis-CI
92. Codecov
96. 將Test report 傳到Codecov 上
97. Codebeat
101. 編輯README.md
103. 成果!
105. ⼀點⼩坑
106. TravisCI & Codecov & Codebeat ▸ 本專案太簡單所以Codebeat 找不到要掃的檔案？ ▸ ⽬目前Xcode 10 build 出來來的coverage report 無法分析 ▸ Xcode 9.4 + Swift 4.1 ▸ Xcode 9.3 + Swift 4.0 ▸ Xcode 9 + Swift 4 （Functional test ❌）
108. Where To Go From Here?
109. Where To Go From Here? ▸ 參參考範例例程式製作屬於你的Product ▸ 透過Swift Package 改善你的⾃自動化流程 ▸ Server Side Swift ▸ VAPOR ▸ Swift@IBM
110. Reference - Swift Package ▸ Swift Scripting - Ayaka ▸ Package Manager - Apple ▸ Getting to Know Swift Package Manager - WWDC 2018 Session 411
111. Reference - Homebrew ▸ Swift Package Manager(SwiftPM)で作ったコマンドライン ツールをHomebrewに登録する⽅方法 ▸ Make your Go Binaries Homebrew Installable
112. 補充：雖然前⾯面⼤大部分都在講Swift Package，但其實Swift 是⽀支援如Shell Script 的⽤用法的
113. Scripting In Swift Writing A Script - Swift Screencast - raywenderlich.com
114. 謝謝⼤家
115. Q&A