iOS 開源專案使用指南：從 GitHub 下載到本地運行

從 GitHub 下載 iOS 開源專案後，面對眾多檔案不知從何下手？大多數專案結構都包含 Example 或 Demo 目錄，這是快速上手的關鍵。

標準專案結構解析

• Example/Demo：包含可直接運行的範例專案（.xcodeproj 或 .xcworkspace），雙擊即可在 Xcode 中打開預覽效果。
• Source/Classes：核心原始碼，供整合到自己的專案中。
• README.md：通常說明安裝方式（CocoaPods、Carthage、Swift Package Manager 或手動導入）。
• LICENSE：授權協議，使用前必讀。

快速運行步驟

1. 解壓下載的 ZIP 或 git clone 專案。
2. 進入 Example 目錄，打開 .xcworkspace（若用 CocoaPods）或 .xcodeproj。
3. 選擇模擬器或真機，按 Cmd+R 運行。

整合到自己專案

若專案支援 CocoaPods，在 Podfile 中添加 pod 'LibraryName' 並執行 pod install；手動導入則將 Source 資料夾拖入 Xcode 專案，勾選 Copy items if needed。

掌握這套流程，即可高效利用開源生態加速 iOS 開發。