為我們的 App 加上 logo 在我們開始寫我們的 pipeline 之前，我突然想到有一件很重要的事情，那就是為我們的 App 加上一個看起來很讚的 icon。App icon 是使用者在 App Store 的第一個接觸點，某種程度上算是決定使用者有沒有興趣的關鍵。 蘋果對 icon 的格式有明確的要求，必須是一個 1024x1024 像素、方形、無圓角、無透明度的 PNG 檔案。當你圖片檔拖入 Xcode 的 Assets.xcassets 中對應的 AppIcon 位置時，Xcode 會自動根據這個圖檔，生成所有需要的尺寸，以適應 iPhone、iPad、通知、Spotlight 搜尋、設定頁面等各種顯示情境。 你也可以按照亮色或暗色主題提供不同的 icon 樣式。 接著我們要進入一個十分重要的部分。 蘋果的 Code sign 機制 為什麼要有這個機制？ 蘋果希望確保用戶從 App Store 下載或安裝的每一個 App，都來自於「已知的開發者」，且「未被竄改」。為了實現這個目標，蘋果建立了一套基於數位簽章的信任鏈。 為了達到這個目的，有以下幾個核心概念： 開發者憑證 (Certificate) 可以把它憑證想像為蘋果官方頒發給開發者的身份證，用來證明「該開發者為該開發者本身」。它保證了 App 是由一個已知的、經過蘋果驗證的開發者所建立的。 而憑證又可區分為開發憑證與分發憑證： 開發憑證 (Development Certificate): 此張憑證讓開發者可以在自己的測試裝置上安裝和測試 App。 分發憑證 (Distribution Certificate): 只有用此憑證簽署的 App，才能上傳到 App Store。 App ID 每個 App 具有獨一無二的的全球唯一識別碼，用來特定 App。 ...

前言 在上一篇文章中，我們完成了 iOS 專案的本地端準備工作。現在，我們將實際設定 Azure Pipelines，目標是讓專案能夠自動化建置並部署到 App Store Connect。 步驟一：Apple Connect 新增 API 金鑰 為了讓 Azure Pipelines 這類 CI/CD 工具能以自動化的方式將 App 上傳至 App Store Connect，我們必須先產生一組專用的 API 金鑰。這組金鑰將授權 Azure Pipelines 執行上傳等操作。 首先登入 App Store Connect 帳號。 登入後，點擊進入「使用者與存取權限」區塊。 選取「使用者與存取權限」，並要求存取權限。 接著，切換到「整合」頁籤，點擊「產生 API 金鑰」。 為這組金鑰設定一個好辨識的名稱，並在「存取權限」欄位選擇「App 管理」。這個權限足以讓 Pipeline 執行建置、上傳與發布等任務。 金鑰產生後，請下載 .p8 檔案並妥善保存，因為它只能下載一次。同時，將頁面上的 Key ID 和 Issuer ID 記錄下來，這些資訊在後續設定中都會用到。 步驟二：Azure Pipelines Connection 設定 有了 Apple 提供的憑證後，接下來我們回到 Azure DevOps，設定 Pipeline 與 App Store Connect 之間的橋樑。 ...

前言 時間來到了第 26 天，App「台灣公路 K 點通」(對，取名了XD) 核心功能已大致完成，是時候著手建立一套自動化的 CI/CD (持續整合/持續部署) 流程了。預想目標是，當推送一個新的 Git Tag 時，Azure DevOps 能自動幫我完成測試、建置、簽署，並將 App 上傳到 App Store Connect，以供後續提交審查。 但在開始處理 CI/CD 之前，有個前置作業必須先完成，那就是我們必須先在 Apple 的後台註冊我們的 App。 CI/CD 無法無中生有 在我們的情境當中，CI/CD 工具的角色是更新部署一個已經存在的 App 紀錄。它們無法替我們決定 App 的名稱、定價、隱私權政策等需要人工決策的資訊。因此，我們必須先手動完成 App 的註冊與設定，CI/CD 的自動化流程才能接著運作。 整個前置作業分為兩步驟： 在 Apple Developer 網站註冊 App ID 在 App Store Connect 新增 App 步驟一：在 Apple Developer 網站註冊 App ID App ID 是你的 App 在 Apple 生態系中獨一無二的識別碼，也稱之為Bundle Identifier。CI/CD 工具和 Xcode 都會用這個 ID 來識別你的專案。 登入 Apple Developer 網站 前往 developer.apple.com，使用你的開發者帳號登入。 ...

前言 CSV 資料的讀取與解析，這項功能是 App 的核心之一。然而，隨著專案越來越複雜，我們很可能會在未來的某個時候不小心改動到相關程式碼，或是 CSV 檔案有異動，導致這個功能壞掉。為了確保它能一直穩定運作，我們需要為它建立一道防線——單元測試。 單元測試可以幫助我們驗證一小段程式碼（一個「單元」）的行為是否符合預期。今天，我們將使用 Apple 官方的測試框架 XCTest 來為 RoadDataManager 撰寫測試，確保它在面對正常與異常資料時，都能做出正確的反應。 將 XCTest 加入專案 如果你的專案一開始建立時沒有勾選 Include Tests，我們需要手動將其加入。 首先，在 Xcode 專案導覽器中點擊最上層的專案檔案，進入設定頁面。在「TARGETS」區域點擊左下角的「+」按鈕，選擇新增「Unit Testing Bundle」。你可以為這個測試目標命名，例如 RoadMileLocatorTests，Xcode 便會為你建立好測試所需的環境。 撰寫你的測試案例 建立測試目標後，Xcode 會自動生成一個樣板檔案。雖然可以直接使用，但更好的做法是為特定的類別建立專屬的測試檔案。這樣一來，當 RoadDataManager 的功能需要擴充或修改時，我們就能立刻找到對應的測試案例來進行驗證。 import XCTest final class RoadMileLocatorTests: XCTestCase { override func setUpWithError() throws { // Put setup code here. This method is called before the invocation of each test method in the class. } override func tearDownWithError() throws { // Put teardown code here. This method is called after the invocation of each test method in the class. } func testExample() throws { // This is an example of a functional test case. // Use XCTAssert and related functions to verify your tests produce the correct results. // Any test you write for XCTest can be annotated as throws and async. // Mark your test throws to produce an unexpected failure when your test encounters an uncaught error. // Mark your test async to allow awaiting for asynchronous code to complete. Check the results with assertions afterwards. } func testPerformanceExample() throws { // This is an example of a performance test case. measure { // Put the code you want to measure the time of here. } } } 這個是由 Xcode 自動產生的單元測試的 Template： ...

前言 首先簡要回顧前幾天的進度： Day 11：我們實作了地理圍欄的核心功能，讓 App 能夠在用戶進入或離開特定區域時觸發事件 。 Day 21 & 22：我們優化了地圖互動，實現了點擊圖釘後彈出詳細資訊視窗（Sheet），並加入了跳轉至 Apple Maps 或 Google Maps 的功能 。 Day 23：我們導入了 UserDefaults 和 Codable，實現了追蹤狀態的持久化。現在 App 即使關閉重啟，也能記得正在追蹤的地點 。 但程式碼跑起來是一回事，但在真實世界中是否可運作又是另一回事，所以今天的核心任務是驗證。我們將設計一系列的測試情境，徹底檢驗地理圍欄通知的穩定性與準確性，並記錄測試過程與結果。 測試準備 使用 GPX 檔案進行定位模擬 新增 GPX 檔案 為了確保測試的準確性與可重複性，我們需要一個可靠的方法來模擬使用者的移動。在 Day 11 測試地理圍欄功能時，我們是透過直接修改模擬器定位座標的方式來進行，雖然可行，但操作上較為繁瑣且不易模擬連續的路徑。今天我們將採用另一種方式，那就是在 Xcode 專案中匯入 GPX 檔案，用它來模擬「進入區域」與「離開區域」的完整行為。 GPX（GPS Exchange Format）是一種標準的 XML 格式，可以用來記錄 GPS 座標點。你可以在 Xcode 裡面直接新增一個 GPX 檔案，Xcode 會提供一個標出蘋果總部的座標預設的模板。 <?xml version="1.0"?> <gpx version="1.1" creator="Xcode"> <!-- Provide one or more waypoints containing a latitude/longitude pair. If you provide one waypoint, Xcode will simulate that specific location. If you provide multiple waypoints, Xcode will simulate a route visiting each waypoint. --> <wpt lat="37.331705" lon="-122.030237"> <name>Cupertino</name> <!-- Optionally provide a time element for each waypoint. Xcode will interpolate movement at a rate of speed based on the time elapsed between each waypoint. If you do not provide a time element, then Xcode will use a fixed rate of speed. Waypoints must be sorted by time in ascending order. --> <time>2014-09-24T14:55:37Z</time> </wpt> </gpx> 這個模板讓我們可以直接修改 <wpt> 標籤中的 lat 和 lon數值，將其變更為我們需要的任何地點。不過，若要模擬一條完整的路線，手動輸入每個路徑點的座標顯然不切實際。因此，這裡我們不打算自己逐點加入，而是借助第三方工具來更快速地產出包含連續路徑的 GPX 檔案。 ...