📕如何自製 Swift package

3️⃣6️⃣7️⃣8️⃣9️⃣

swift ⟩ type ⟩ custom ⟩ package ⟩ how to make

1️⃣ Xcode 設定好 GitHub 帳號 2️⃣ Xcode 開啟新的 Package 檔案 3️⃣ 設定套件所支援的 Swift 語言最低版本 (⭐️ 重要) 4️⃣ 編寫要分享的程式碼 5️⃣ 發佈到 GitHub

👥 相關

• 🎁 GeometryKit：支援向量、複數運算的套件。

📗 參考

• Git Tower ⟩ What is Version Control? ⭐️

• ChatGPT ⟩ 如何使用自製 Swift Package

• microsoft ⟩ What is Git?

• 伊恩的開發狂想 ⟩ 程式碼版控

📘 手冊

• Swift Playgrounds ⟩ Adding a Swift package to your app playground

步驟

1️⃣

• Xcode ⟩ Settings ⟩ Accounts (tab) ⟩ select GitHub and continue.

• try to sign in GitHub (you may have to create a token on GitHub)

• when successful, you'll see your GitHub account added.

• go to next step.

2️⃣

• 選擇功能表 Xcode ⟩ File ⟩ New ⟩ Package ... ，然後選 "Library" 然後跳下頁：

• "Testing System" (做 Unit Test 的系統) 選 Swift Testing (預設)即可，不用改，跳下頁：

• 設定好 package 的名稱，選一個儲存檔案的位置 (Xcode 會產生一個母資料夾，下面還有其他檔案與子資料夾)。如果以後要分享這個套件，建議 "Create Git repository on my Mac" 要打勾，以後透過 GitHub 的連結就可以匯入 Swift Playgrounds 或其他專案中。

3️⃣

• 新的 package 檔案開啟後，選擇 Package.swift 檔案，然後修改第一行的 swift-tools-version： 將畫面中的 // swift-tools-version: 6.0 改為 // swift-tools-version: 5.7。 這一行雖然是個備註 (comment) 行，但非常重要，因為這裡設定的是這個套件「所支援的 Swift 語言的最低版本」，因此如果設太高，將來要分享此套件到其他專案或 iPad 上的 Swift Playgrounds 時會出現問題，因為你的設備可能無法支援這麼新的 Swift 版本。 以後 Swift 版本會再更新，所以這裡支援的 Swift 的版本，請到時候依狀況自行斟酌。

• 到下一步驟。

4️⃣

• 再來，到 Sources 資料夾編寫程式碼，在這裏你可以新增資料夾、新增檔案，檔案結構可以自行決定：

• 如果要加一些測試檔案 (Unit Test)，也可以到 Tests 資料夾編寫測試檔，編寫方式請參考 Swift Testing：

5️⃣

• 到 Source Control navigator 中選 Branches ⟩ main，然後按右鍵選 New "YourPackageName" remote ... ，並完成其中的設定，在 GitHub 上成功新建一個 remote repo：

• 等編寫好套件的所有程式碼，測試完畢沒有任何問題時，到 Source Control navigator 中選 Branches ⟩ main，按右鍵選 "Tag main ..."，然後輸入版本號 1.0.0。

• 再來到功能表選 "Integrate ⟩ Push ..." 將所有檔案上傳到 GitHub：

• 最後到 GitHub 的 Tags 頁面發布一個新的 Release 就可以使用了：