IOS

前言 在 Day 1 的時候有提到，在我剛進公司時，公司正好在導入 Azure DevOps 作為專案管理工具。這讓我有機會從零開始學習如何使用這個工具，並且在實際的工作中應用它，也因此體會到了專案管理工具對於軟體開發的重要性與價值。例如，它能幫助團隊更清楚地了解專案進度、分配任務、追蹤 Bug 等等。在還沒有工具之前，我們可能常常用 Excel、Trello 或甚至是口頭溝通，結果就是「欸，那個功能上次是誰說要做的？」或是「這個 Bug 修好了嗎？」之類的對話層出不窮，資訊非常分散。每一個工作項目都能被清楚地記錄與追蹤，讓整個開發流程變得更有條理；每一個工作項目都能被清楚地記錄與追蹤，讓整個開發流程變得更有條理。而原本今年鐵人賽想單純撰寫 SwiftUI App 的計畫，但想了一下，或許我可以嘗試把我使用 Azure DevOps 的經驗也融入其中，也是個不錯的結合。 什麼是 Azure Boards? Azure Boards 是一個基於網頁的服務，讓團隊可以一起規劃、追蹤和討論整個開發過程的工作，並且支援敏捷式方法。它提供了可自訂的平台來管理各種工作項目，讓團隊能夠有效協作並簡化工作流程。 如果用更白話的方式來說，Azure Boards 就像是「專案進度白板」的進化版。想像你和同事要一起做一個 App，大家會把要做的事情（像是設計畫面、寫程式、修 bug）一條一條寫在便利貼上，貼在牆上，然後每天早上一起討論誰要負責什麼、做完了沒。Azure Boards 就是把這種「便利貼牆」搬到網路上，而且還加了很多自動化和追蹤功能。 舉個實際例子，假設你們團隊要開發一個新的功能，大家可以在 Azure Boards 上建立一個「Issue」，分配給負責的人，設定截止日期，還能隨時更新進度。如果有 bug，直接開一個新的工作項目，標記為「Bug」，讓大家都知道目前有什麼問題需要解決。你可以根據專案規模選擇不同的流程（像是 Basic 或 Agile），小型團隊可以用最簡單的方式管理，大型團隊則能用更細緻的分工。 總結來說，Azure Boards 就是幫助團隊把所有待辦事項、進度、問題都集中管理，讓大家不會漏掉重要的事，也能清楚看到專案的整體進展。 依據團隊與專案的不同，Azure Boards 提供四種流程選擇： Agile：使用敏捷式規劃方法時使用，適合追蹤 User Story，並可選擇性地在面板上追蹤 Bug。 Basic：適合小型團隊或個人專案，簡化工作項目結構，讓管理更直觀。 Scrum：適合正式執行 Scrum。 CMMI：當小組遵循更正式的專案方法時選擇。 詳細可參考微軟說明。 我們公司是使用 Agile 流程，但在這個專案中，我會使用 Basic 流程來進行管理。因為這個專案的規模較小，且我主要是個人開發，所以 Basic 流程就足夠了。如果用 Agile 或 Scrum，會多出像 User Story、Feature、等這些工作項目類型，對我一個人來說反而有點太複雜了，Basic 的三層架構（Epic → Issue → Task）對我來說最直覺。如果想要進一步了解差異，可以參考微軟官方文件。 ...

前言 在昨天的內容中，我們學會如何利用 Core Location 搭配 MapKit 即時取得並標記用戶的位置。今天，我們將實作地理圍欄（Geofencing）技術，它不僅能偵測使用者是否進入或離開特定區域，還能結合本地通知即時提醒，我們的 App 之後也會用到這個技術。 什麼是 Geofencing？ Geofencing（地理圍欄）是一種以座標為中心、半徑為範疇的虛擬區域，透過 Core Location 框架自動監控使用者是否進入或離開該範圍，並能觸發事件通知，例如打卡、到站提醒、商圈推播都跟這個技術相關。 實作 介面設計 首先在 ContentView.swift 設計一個簡單的輸入區，供使用者自訂要監控的目標緯度與經度。 @State private var latitudeText: String = "" @State private var longitudeText: String = "" @State private var isMonitoring = false // 依據是否監控中，UI 隨之改變 // ... // MARK: - Geofencing 輸入介面 private var geofenceInputSection: some View { VStack(spacing: 12) { Text("設定地理圍欄") .font(.headline) HStack { TextField("緯度 (例: 25.033964)", text: $latitudeText) .keyboardType(.decimalPad) .textFieldStyle(.roundedBorder) TextField("經度 (例: 121.564468)", text: $longitudeText) .keyboardType(.decimalPad) .textFieldStyle(.roundedBorder) } HStack(spacing: 12) { Button(isMonitoring ? "正在監控中" : "建立地理圍欄") { startGeofencing() // 開始監控，待後面實作 } .disabled(isMonitoring || latitudeText.isEmpty || longitudeText.isEmpty) .buttonStyle(.borderedProminent) if isMonitoring { Button("停止監控") { stopGeofencing() // 停止監控，待後面實作 } .buttonStyle(.bordered) .foregroundColor(.red) } } if isMonitoring { Text("正在監控半徑100公尺的地理圍欄") .font(.caption) .foregroundColor(.secondary) } } .padding() .background(Color(.systemGray6)) .cornerRadius(12) } 為了讓 body 不要太肥，我們把這個輸入區域包在一個 geofenceInputSection computed property 裡，之後再只要像用變數一樣取用geofenceInputSection，直接把它放在 body 裡。 ...

前言 在前一天我們已經學會了如何使用 Core Location 來取得用戶位置，而今天我們要進一步將位置資訊反映在地圖上。我們可以使用 MapKit 此一蘋果提供的地圖框架，此框架提供了顯⽰、導覽地圖，在地圖上加上標記，覆蓋物等功能。 今天簡單三個目標： 顯示地圖 鏡頭定位在「目前位置」 在目前位置放一個大頭針（Marker） 將地圖 view 加入畫面將位置資訊顯示在地圖上 我們可以延續昨天使用 Core Location 的專案，使用我們已經建立好的 LoactionManager 來取得位置，並且將位置顯示在地圖上。 首先引入 MapKit: import MapKit 在 MapKit 當中，我們找到這個初始化方法： @MainActor @preconcurrency public init<C>( position: Binding<MapCameraPosition>, bounds: MapCameraBounds? = nil, interactionModes: MapInteractionModes = .all, scope: Namespace.ID? = nil, @MapContentBuilder content: () -> C ) where Content == MapContentView<Never, C>, C : MapContent 說明一下幾個參數： position: Binding Binding<MapCameraPosition>，作用是透過雙向綁定，允許程式碼與地圖之間都能改變相機位置，常用值有： .automatic - 自動決定相機位置 .userLocation(fallback: .automatic) - 跟隨使用者位置 .region(MKCoordinateRegion(...)) - 指定特定區域與縮放程度 .camera(MapCamera(...)) - 3D 相機控制（高度、俯仰角等） bounds: MapCameraBounds? = nil ...

前言 Core Location 是 iOS 開發中用於處理地理位置相關功能的框架。今天的目標是了解如何使用 Core Location 來管理權限以及獲取用戶的當前位置。 使用 CLLocationManager 管理權限與更新位置 首先我們先在專案資料夾建立一個新的 .swift 檔 LoactionManager.swift。 可以在專案資料夾按快捷鍵 cmd + N，選擇 iOS -> Swift File。 我們的目的是建立一個獨立的管理者 LocationManager，它會處理向使用者請求定位權限、接收座標更新、並將這些資訊即時「發布」給 SwiftUI 介面，讓畫面可以根據最新的位置或權限狀態自動更新。 import CoreLocation class LocationManager: NSObject, ObservableObject, CLLocationManagerDelegate { // .... } NSObject: 繼承自 NSObject。因為 Core Location 框架是基於早期 Objective-C 的設計模式。 ObservableObject: 遵循 ObservableObject 協定。這是一個來自 Combine 框架的宣告，表示這個物件可以被 SwiftUI 的 View 所「觀察」。一旦物件內被 @Published 標記的屬性發生改變，它會自動通知所有正在觀察它的 View 進行更新。 Combine 框架是用來在 Swift 中以聲明式方式處理資料流與非同步事件的工具，簡單說就是你不用自己到處寫通知、代理或 callback 處理資料或事件的一套工具。 CLLocationManagerDelegate: 必須遵循 CLLocationManagerDelegate 協定，LocationManager 才有能力處理「權限狀態改變」或「位置更新」等 delegate method。 接著我們需要： ...

前言 在 App 開發中，有時需要從專案內置的資源檔（如 CSV、JSON）讀取資料。CSV 是用逗點分隔值的檔案，我們可以將之轉化為 SwiftUI 列表。這項操作技能很實用，因為許多資料都是以這種簡單的格式儲存的，而我們這次要實作的 App 也會需要使用到這個功能，因此有必要先了解一下這個主題。 要完成這個任務，我們需要理解並掌握以下幾個核心概念： 讀取 App 內部檔案：學習如何使用 Bundle 來定位並讀取包含在我們 App 安裝包內的資源檔案，例如這次要用的 products.csv。 資料解析 (Parsing)：取得原始的文字資料後，我們需要將其一行一行地解析，並將每個欄位轉換成我們定義好的 Product 資料結構，這個過程稱為資料解析。 動態列表 List：這個我們在昨天有使用過了，今天也會用到它。 Identifiable 協定：我們的資料模型（Product struct）必須遵循 Identifiable 協定，告訴 SwiftUI 如何唯一識別每一個項目。 那我們就開始吧。 Step 1：將 products.csv 加入 Xcode 專案 我們先將 products.csv 檔案拖曳到 Xcode 左側的專案導覽器中，並確保在跳出的視窗中勾選了 “Copy files to destination” 以及您的 App Target。 按下 Finish 後，可以看到檔案成功被加入到專案裡頭。 Step 2：定義產品資料模型 我們需要建立一個 struct 來對應 CSV 中的每一行資料。為了讓 SwiftUI 的 List 能識別每個項目，這個 struct 必須遵循 Identifiable 協定。 ...