GISHelperKit

goodideas-studio-HelperKit~

👨🏻‍💻 關於 HelperKit~：

這邊是好想工作室 iOS Camp 共同建立的 HelperKit。你可以在這邊找到 iOS 開發相關的項目，無論是功能、框架、技術文章或工具。若是你也有想要分享的功能或技術，無論功能規模大小，也歡迎列在下方 HelperKit 表格中。

🚨 分享須知：

[🛠功能區]：

• 若是想要單純分享程式碼，請把程式碼上傳至 Github 或 Gist 方便其他人閱讀。之後其他讀者也可以透過 issue 與 comment 的方式交流。
• 若是想要分享某個效果／功能，也請把該專案上傳至 Github，並且透過 Readme 簡單描述專案功能。也可以附上專案 Demo 的圖片、影片、Gif 等等。

[📦框架＆工具] & [📝技術文章]：

• 分享他人的框架、工具以及技術文章時，記得要附上來源。
• 分享文章之前記得要看看有沒有一模一樣的文章，小心發到重複的文章。

[🙇🏻‍♂️許願池]：

• 如果你對某個功能有興趣，但不知道怎麼編寫時，也歡迎在下面許願區許願。
• 如果你對某個議題或技術有興趣，也歡迎在下面許願。

---

🛠 功能

日期	名稱	描述	提供者
12/23	DismissToRootVC	單行程式碼，輕鬆 dismiss 到 rootVC	Jeremy
1/9	DissmissThenPresent	在 ViewController dismiss 自己後，可以馬上 present 出另一個 ViewController	Jeremy

---

📦 框架＆工具

日期	主題	描述	提供者
12/28	Kingfisher	使用 KingFisher 框架輕鬆處理圖片 cache	Jeremy
1/2	Realm		Lacie

---

📝 技術文章

日期	主題	描述	提供者
12/28	UIStackView 教學	活用 UIStackView：讓 APP 畫面佈局更方便快捷	Jeremy

---

🙇🏻‍♂️ 許願池

日期	許願內容	許願者	解答
12/23	有沒有 dismiss 到 rootVC 的方法？	Jeremy	DismissToRootVC

如何在你的專案中使用 HelperKit

1. XCode Project

XCode 11 (含以上) 可用 XCode 內建的功能加入 SPM, 詳細內容可以至 Apple - adding package dependencies to your app

1. 至 XCode > File > Swift Packages > Add Package Dependency
2. 搜尋 https://github.com/goodideas-studio/iOS-HelperKit
3. 點選 Next 加入成功
4. import GISHelperKit 之後便可使用 HelperKit

2. Package.swift

在 Package.swift 檔案內找到相對應的參數加入

import PackageDescription

let package = Package(
    ...
    dependencies: [
      ...
        .Package(url: "https://github.com/goodideas-studio/iOS-HelperKit", from: "1.0.0"),
    ],
    targets: [
    .target(
        name: "...",
        dependencies: ["GISHelperKit"])
)

import GISHelperKit 之後便可使用 HelperKit

如何貢獻 HelperKit

1. fork 一份 repo 至 你的 GitHub 賬號

經過一段等待之後, 你會看到網頁會跳轉至以下畫面的 repo 主頁

2. 將這份 Fork 的 repo clone 至本機

可以使用 git clone 指令

git clone https://github.com/<你的 GitHub 賬號>/iOS-HelperKit

3. 增加 upstream remote (可選的) 接下來的部分是推薦的做法, 透過 remote 的方式, 將原本的 repo 設為 upstream, 可以仔細區分專案.

cd iOS-HelperKit
git remote add upstream https://github.com/goodideas-studio/iOS-HelperKit

4. 撰寫更動, 並發起 Pull Request

在 fork 的專案中作更動, 簡易使用 新的 Branch, 如此 master 可以模擬 upstream.

完成更動後, 確認 GitHub 下 fork 的專案保有你所做的更動, 就可以發起 Pull Request (PR).

下圖是 fork 的專案主頁, 切換至指定 Branch 可以看到 New pull request 的按鈕. 點擊按鈕可以發起 PR.

真正發起 PR 之前, 請確認 PR 的箭頭左邊(目標 Branch) 是 goodideas-studio/iOS-HelperKit, 填寫必要資訊, 即可完成 PR.