當好不容易把Watch OS App 寫好之後，開開心心按下 Run 然後就發現怎麼跑起來和我想像的不一樣? 就算是用實機也無法順利執行App，如果你也有這個煩惱(?) 這篇把我在開發過程中遇到的問題紀錄下來，也許可以幫助到你

Pair Watch with simulator

實機的話就比較不會有配對問題，若想要用Simulator 來跑的話，要怎麼樣才能配對Watch ?

首先，請記得下載 Watch Simulator，沒下載就什麼都不用說了

打開Xcode 之後請到 Window -> Devices and Simulators，選擇想要使用的Simulator在畫面上可以看到 Paired watches 這區，按下 +

接著就可以選取想要配對的Watch，要記得自己配對的機種，之後在跑程式的時候記得要跑有配對的Simulator 才行喔

明明沒有出現 Error 訊息，資料卻沒有互相傳遞?

這時候需要檢查二個地方

First

iOS App Target 中的 General -> Frameworks, Libraries and Embedded Content，是否有把 Watch OS App 給加進去

Second

Watch OS Target 中的 Info 裡 WKCompanionAppBundleIdentifier ，這個參數後面要帶上 iOS App 的Bundle id，Watch OS App 是用這個參數在找要連接的 iOS App 所以可不要寫錯了

打包失敗

在好不容易跑起來且測試沒有問題時，要打包卻發現打包失敗!?

這時候請檢查 iOS App 與 Watch OS App 的 Version & Build number 是否有一致，若沒有一致的話，會打包失敗的

以上皆是我自己遇到的問題，若有誤歡迎告知

最後祝大家 Coding 愉快!!

上篇利用了 Apple 的官方教學簡單了解要怎麼建立一個 Watch App，不過在教學裡的Watch 資料是可以獨立取得的，在多數的情況下，都是要從 iOS App 中取得資料，需要與 iOS App 溝通才行，而 Watch Connectivity 就是用來與WatchOS 溝通的Framework

本篇使用 Xcode 14.3 & SwiftUI

Watch Connectivity

它是負責Watch 與 App 之前的溝通，有提供幾種資料傳遞，也有提供背景傳遞方式，本篇內容是利用 Watch Connectivity 中的SendMessage 來進行簡單的資料傳遞，這種方式是必須在手錶不是在背景的情況下才可以進行資料傳送，算是比較即時的資料傳送方式

WatchConnectivity 就如它的名字是負責用來做為 WatchOS App 與 iOS App 之間的溝通，因此在 WatchOS 端與 iOS 端都需要寫相同的function 用來確認連結與傳遞資料，就如圖片所示

WCSection

WCSession 無論那種傳送方式都是使用這個 Class ，在 iOS App 與 WatchOS App 都要寫上 WCSession，它會進行檢查與傳送工作

import WatchConnectivity
if WCSession.isSupported() {
    let session = WCSession.defaultSession()
    session.delegate = self
    session.activateSession()
}

• 需要先使用 WCSession.isSupported()確認是否有支援互相傳送資料
• 建立一個Session基本上沒有什麼特別需求的話就直接使用Default 的就好
• 設定好 Delegate
• 最後就是 Activate session

WCSessionDelegate

這個Delegate 中有用來接收雙方資料的function 也有確認是否連線成功的 function，若使用 SwiftUI 來撰寫，接收會影響UI 更新的參數時，記得要使用 @Published var 來接，不然UI 就不會更新了

下面三個function 在 App 端一定要實作的，Watch 端的話只需要實作第一個，簡單說一下這三個的用途

func session(_ session: WCSession, activationDidCompleteWith activationState: WCSessionActivationState, error: Error?) {
}
    
func sessionDidBecomeInactive(_ session: WCSession) {
}

func sessionDidDeactivate(_ session: WCSession) {
}

• activationDidCompleteWith，就是當呼叫完 activateSession 之後會觸發
• sessionDidBecomeInactive，停止連線的時候會觸發
• sessionDidDeactivate，當所有資料傳送完成且停止連線的時候會觸發

本篇中在這三個時機點並沒有要特別處理什麼事情，所以並不會在這三個function 裡寫東西。

Send Message

用 Message 的方式傳送的 Data 是 Dictionary ，Key 可以自定，使用 Dictionary 就可以使用Decodable 的讓它變成 Data Object 這樣之後會比較好處理

func sendHiToWatch() {
    guard let wcSection = section, wcSection.isReachable else {
         return
    }
    
    let hiDic = ["Say": "Hi, Watch"]
    wcSection.sendMessage(hiDic) { result in
        print("Result : \(result)")
    }
}

在 sendHiToWatch 裡簡單建立一了個 Dictionary ，Key是 “Say”，Value是 “Hi, Watch”，因為 Message 的傳送方式 Watch App 必需要在前景，因此使用 isReachable 來確認是否可以傳送Message。

再來就是呼叫 sendMessage 這個func 將想要的資料傳送出去

Receive Message

在 WCSessionDelegate 中 didReceiveMessage 就是用來接收，可以寫在App 端與 Watch 端，接收完之後也可以依情況回傳 reply ，reply 的資訊會在 sendMessage 的Result中。

func session(_ session: WCSession, didReceiveMessage message: [String : Any], replyHandler: @escaping ([String : Any]) -> Void) {
        
     let hiMessage = message["Say"] as! String
        
     DispatchQueue.main.async {
         self.appMessage = hiMessage
     }
        
     let reply = ["Get": "Good"]
     replyHandler(reply)
}

之所以使用 DispatchQueue.main.async{} 是因為 appMessage 這個參數是要用來更新UI 的，更新UI 的參數一定要在main thread 上才行喔。

Run

寫完之後就可以跑跑看啦~ 若是要用Simulator 的話，記得要下載Watch Simulator 並且與 iPhone Simulator 配對，此外還有一些設定要做，不然就會發現App 都可以跑起來但是就是無法傳送資料

下一篇會整理一下我在這個中間遇到的一些問題，並說明要 Simulator要如何配對

最後祝大家 Coding 愉快!!

Reference

Video

There and back again: Data transfer on Apple Watch

Introducing Watch Connectivity

Document

Watch Connectivity

此篇主要是我看 Apple SwiftUI Tutorials 中的 Creating a watchOS App 學習 watchOS 時，因為使用 Xcode 14撰寫有些不同的地方，就想記錄下來，在 Xcode 14 之後建立 watchOS 已經不會出現Extension Folder 了，主因是現在可以建立獨立的watchOS ，不過目前多數 watchOS App 還是屬於輔助 iOS App 的角色

本篇使用 Xcode 14.2 & SwiftUI

從Creating a watchOS App 中下載專用的Project，解壓縮之後可以看到有 “Complete” & “StartingPoint” Folders，Complete 是已經完成的App，即然是要學習寫 watchOS 當然是開啟 StartingPoint 中的專案，開啟專案之後，會發現這個專案其實是延續先前的教學，若你有SwiftUI Tutorials第一章開始練習的話，應該不陌生。

建立 Target

教學的第一步就是建立 Target ，在開啟 add Target 之後就發現畫面不一樣了，若沒有下載任何watchOS Simulator 的話，Xcode 會提配你要下載，下載Simulator 大概要3G記得確認一下容量。

切到watchOS 的頁籤還是可以看到 App Intents Extension，實際上選它建立出來的就和先前的有87%像，不過少了watchApp這個Target，感覺上怪怪的? 後來看了WWDC的Video 才發現應該要選擇 Application 中的App

按下 Next 之後會發現有幾個選項

• Watch-only App，是建立獨立App 用的
• Watch App with New Companion iOS App，選這個會再幫你建立一個 iOS App
• Watch App for Existing iOS App，在已存在的App 中建立Watch App

前二個選項應該是給建立新專案時選的，當你直接建立 WatchOS project 的時候，前二個選項使用起來比較合理，若在已經存在的專案加入WatchOS target 前二個選項反而比較不太適用，總之以這個教學App來說就是要選用第三個選項來建立Watch App

再來就照著教學指示，輸入名字再按下Next 後 Activate Watch scheme 就可以了。

Supports Running Without iOS App Installation 這個選項可以在Watch App 的 Target 裡找到

共享資料

教學一開始就要求你把Watch 裡的 Assets 刪除，我試過之後發現刪除之後Build 會告知找不到 Watch App Icon，幾次嘗試之後，我決定不把 Watch 的 Assets，直接把icon 圖放上去，在 Xcode 更新之後 App icon 可以只給 1024*1024 的圖，其他尺寸的icon 全都由Xcode 自動處理，說真的這功能很棒且早就應該要這麼做了啊!! icon尺寸真的很多…遇到設計師不是很用心，想請對方出圖的時候就很痛苦，追圖也很痛苦……

另一個就是 LandmarksApp.swift 這個檔案可以不用與Watch App 共享，因為Watch App 有自己的入口點了，若命名是照教學取名的話，就是WatchLandmarksApp.swift 這個檔案。記得將原本寫在 LandmarksApp.swift 裡的內容也Copy 到WatchLandmarksApp.swift，主要是這個Watch App 所用的資料並沒有需要從 iOS App 這裡取得，直接Copy 寫法就可以了。

剩下的就可以依照教學選取需要共享的檔案，並在Target Membership 把 WatchLandmarks Watch App 這個打勾

建立Detail View & 加上 List

這二段照著教學做就可以了，基本上沒有什麼需要特別留意的地方，只要記得是直接新增檔案在 Watch App

建立 Custom Notification Interface

先前建立 Watch Extension 的時候會自動建立 NotificationView & NotificationController ，但後來就不會自動建立了，所以若是要建立 Custom Notification Interface 的話，上面二個檔案需要自行建立，所以就先到 New -> File 建立這二個檔案之後再照著教學做吧~

當想要Run 起來試試的時候，發現不能測試，這時候需要新增一個 Scheme，並把Watch Interface 選為 Dynamic Notification，需要用這個 Scheme 去Run 才可以試 Notification

另外還要記得 Payload 要加上 Simulator Target Bundle 這個 Key，就樣就可以像iPhone 一樣，直接將Payload 文件拖拉到Simulator 上測試啦~

一開始有說到下載的檔案裡有Complete 的 Folder ，若真的不知道要怎麼寫的話，可以從這裡去對照看，我自己是覺得看教學還是要自己親自去打過一遍會比較有印象。

這個教學並沒有教到要如何和 iOS App 做資料傳遞，只是建立簡單的 Watch App，若想要和iOS App 進行資料傳遞是要使用到 Watch Connectivity 這個 Framework，它提供了雙向溝通的方式，之後有機會再寫一篇來實作這個。

最後祝大家 Coding 愉快!!