メインコンテンツへスキップ

watchOS アプリの作成

GitHub

このガイドでは、 watchOS コンパニオンアプリをゼロから作成する方法を説明します。Xcodeでのプロジェクト設定、CapgoWatchSDKの統合、SwiftUIを使った機能するウォッチアプリの構築を含みます。

以下の Wear OS、 Wear OSアプリの作成 こちらを読んでください。

開始前に、以下が揃っていることを確認してください:

  • Xcode 15 以降 (Mac App Store からダウンロード)
  • macOS Sonoma 以降 (最新の watchOS SDK 用)
  • 既存の Capacitor iOS プロジェクト (実行 npx cap add ios していない場合)
  • Apple Developer アカウント (開発には無料アカウントで十分です)

このガイドを完了すると、プロジェクトは次の構造になります:

  • ディレクトリios/
    • ディレクトリApp/
      • ディレクトリApp/ (メインのiOSアプリ)
        • …
      • App.xcodeproj
      • App.xcworkspace (プロジェクトを開く際に使用)
      • Podfile
    • ディレクトリMyWatch/ (新しいウォッチアプリ)
      • ディレクトリMyWatch/ (ウォッチアプリのソース)
        • MyWatchApp.swift
        • ContentView.swift
        • ディレクトリAssets.xcassets/
          • …
      • MyWatch.xcodeproj
  1. Capacitor プロジェクトの ios/App フォルダ
  2. 開く App.xcworkspace (非 .xcodeproj) をダブルクリックして開きます
  3. Xcodeがプロジェクトをインデックス化するまで待ちます
  1. Xcodeで、次を開きます: ファイル → 新規 → ターゲット…

  2. テンプレート選択画面で:

    • 選択します watchOS 上部のタブ
    • 選択: アプリ
    • クリック 次へ
  3. ウォッチアプリを設定します:

    • 製品名: MyWatch (または任意の名前)
    • チーム: Apple Developer チームを選択してください
    • 組織識別子: iOS アプリと一致する必要があります (例: app.capgo)
    • バンドル識別子: 自動生成されます (例: app.capgo.myapp.watchkitapp)
    • 言語: Swift
    • ユーザーインターフェース: SwiftUI
    • Watch Appのタイプ: App(既存の iOS アプリ用の App ではありません)
    • チェックを外す Notification Scene を含める (必要な場合を除く)
    • チェックを外す Complication を含める (必要な場合を除く)
  4. クリック 完了

  5. 「“MyWatch” スキームを有効にしますか?」と表示されたら、 アクティブ化

  1. Project Navigator(左サイドバー)で、プロジェクト(一番上の青いアイコン)を選択します

  2. ターゲット一覧から Watch ターゲット(例: “MyWatch”)を選択します

  3. 以下にアクセスしてください: 一般 タブ:

    • 表示名: アプリアイコンの下に表示される名前(例: “My App”)
    • バンドル識別子: 末尾は以下で終わる必要があります .watchkitapp
    • バージョン: iOS アプリのバージョンと一致させてください
    • ビルド: iOS アプリのビルド番号を一致させる
  4. 以下に移動します: Signing & Capabilities タブ:

    • 有効にする 署名管理を自動化
    • 次を選択: チーム
    • Xcode がプロビジョニングプロファイルを自動的に作成します
  5. 設定 デプロイ情報:

    • 最小デプロイメント:watchOS 9.0以降

ステップ4: Swift Package ManagerでCapgoWatchSDKを追加

セクション「ステップ4: Swift Package ManagerでCapgoWatchSDKを追加」

CapgoWatchSDKは、すぐに使える WatchConnector 通信用のクラスを提供します。

  1. Xcodeで、次を開きます: ファイル → パッケージの依存関係を追加…

  2. 検索フィールドに以下を入力します:

    https://github.com/Cap-go/capacitor-watch.git
  3. Enterキーを押して、Xcodeがパッケージを取得するまで待ちます

  4. パッケージを設定します:

    • 依存関係ルール:「次のメジャーバージョンまで」を「8.0.0」で
    • クリック パッケージを追加
  5. 追加するプロダクトを選択:

    • 重要:選択するのは CapgoWatchSDK
    • 追加先が必ず watch ターゲット (例:「MyWatch」)であることを確認してください。iOS アプリではありません
    • クリック パッケージを追加

では、watch app code を作成しましょう。自動生成されたファイルを以下に置き換えてください:

5.1 アプリのエントリポイントを作成

「5.1 アプリのエントリポイントを作成」セクション

編集 MyWatch/MyWatchApp.swift:

import SwiftUI
import CapgoWatchSDK
@main
struct MyWatchApp: App {
init() {
// Activate WatchConnectivity when app launches
WatchConnector.shared.activate()
}
var body: some Scene {
WindowGroup {
ContentView()
}
}
}

編集 MyWatch/ContentView.swift:

import SwiftUI
import CapgoWatchSDK
struct ContentView: View {
// Observe the WatchConnector for automatic UI updates
@ObservedObject var connector = WatchConnector.shared
// Local state
@State private var messageText = ""
@State private var statusMessage = "Ready"
var body: some View {
ScrollView {
VStack(spacing: 16) {
// Connection Status
ConnectionStatusView(connector: connector)
Divider()
// Message Input
TextField("Message", text: $messageText)
.textFieldStyle(.roundedBorder)
// Send Buttons
HStack {
Button("Send") {
sendMessage()
}
.disabled(!connector.isReachable || messageText.isEmpty)
Button("Request") {
sendWithReply()
}
.disabled(!connector.isReachable || messageText.isEmpty)
}
Divider()
// Status
Text(statusMessage)
.font(.caption)
.foregroundColor(.secondary)
// Last Received Message
if !connector.lastMessage.isEmpty {
VStack(alignment: .leading) {
Text("Last Message:")
.font(.caption)
.foregroundColor(.secondary)
Text(formatMessage(connector.lastMessage))
.font(.caption2)
}
.frame(maxWidth: .infinity, alignment: .leading)
}
}
.padding()
}
}
private func sendMessage() {
connector.sendMessage(["text": messageText, "timestamp": Date().timeIntervalSince1970])
statusMessage = "Message sent"
messageText = ""
}
private func sendWithReply() {
connector.sendMessage(["text": messageText, "needsReply": true]) { reply in
DispatchQueue.main.async {
statusMessage = "Reply: \(formatMessage(reply))"
}
}
messageText = ""
}
private func formatMessage(_ message: [String: Any]) -> String {
message.map { "\($0.key): \($0.value)" }.joined(separator: ", ")
}
}
// Separate view for connection status
struct ConnectionStatusView: View {
@ObservedObject var connector: WatchConnector
var body: some View {
HStack {
Circle()
.fill(connector.isReachable ? Color.green : Color.red)
.frame(width: 12, height: 12)
Text(connector.isReachable ? "Connected" : "Disconnected")
.font(.headline)
Spacer()
if connector.isActivated {
Image(systemName: "checkmark.circle.fill")
.foregroundColor(.green)
}
}
}
}
#Preview {
ContentView()
}

iOS アプリにも WatchConnectivity の capability が必要です。

  1. Project Navigator でプロジェクトを選択します

  2. 次を選択: iOS App ターゲット (watch ターゲットではありません)

  3. 以下に移動します: Signing & Capabilities タブ

  4. クリック + Capability

  5. 検索して追加 WatchConnectivity (利用可能な場合)または自動的に追加される場合があります

  6. Capacitor プラグインが iOS 側の処理を自動で行いますが、Info.plist に以下が含まれていることを確認してください:

    <key>WKCompanionAppBundleIdentifier</key>
    <string>app.capgo.myapp.watchkitapp</string>
  1. スキームセレクタ(Xcodeウィンドウ上部)からwatchのスキームを選択します

  2. Watchシミュレータを選択:

    • スキームの隣にあるデバイスセレクタをクリックします
    • Apple Watchシミュレータを選択します(例:「Apple Watch Series 9 (45mm)」)
  3. 次をクリックします: 実行 ボタン (▶️) をクリックするか、キーを押します Cmd + R

  4. iPhoneとApple Watchの両方が起動した状態でiOS Simulatorが立ち上がります

  1. iPhoneをUSBで接続します

  2. Apple Watch がその iPhone とペアリングされていることを確認してください

  3. Watch スキームを選択します

  4. デバイスリストから物理的な Apple Watch を選択します

  5. クリック 実行

  6. 初回: 両方のデバイスでコンピューターを信頼する必要がある場合があります

Capacitor アプリで:

import { CapgoWatch } from '@capgo/capacitor-watch';
// Check connection
const info = await CapgoWatch.getInfo();
console.log('Watch reachable:', info.isReachable);
// Send a message
if (info.isReachable) {
await CapgoWatch.sendMessage({
data: { action: 'update', value: 'Hello from iPhone!' }
});
}

watch アプリは次を使用します WatchConnector:

// Send message (fire and forget)
WatchConnector.shared.sendMessage(["action": "buttonTapped"])
// Send message with reply
WatchConnector.shared.sendMessage(["request": "getData"]) { reply in
print("Got reply: \(reply)")
}

iPhone でメッセージを処理する

セクション「iPhoneでのメッセージ処理」
// Listen for messages from watch
await CapgoWatch.addListener('messageReceived', (event) => {
console.log('Message from watch:', event.message);
// { action: 'buttonTapped' }
});
// Handle messages that need a reply
await CapgoWatch.addListener('messageReceivedWithReply', async (event) => {
console.log('Request from watch:', event.message);
// Send reply back
await CapgoWatch.replyToMessage({
callbackId: event.callbackId,
data: { status: 'success', items: ['item1', 'item2'] }
});
});

より詳細な制御が必要な場合は、 WatchConnectorDelegate:

import SwiftUI
import CapgoWatchSDK
class WatchHandler: WatchConnectorDelegate {
func didReceiveMessage(_ message: [String: Any]) {
print("Received: \(message)")
// Handle incoming message
}
func didReceiveMessageWithReply(_ message: [String: Any],
replyHandler: @escaping ([String: Any]) -> Void) {
print("Received request: \(message)")
// Process and send reply
replyHandler(["status": "processed"])
}
func didReceiveApplicationContext(_ context: [String: Any]) {
print("Context updated: \(context)")
}
func didReceiveUserInfo(_ userInfo: [String: Any]) {
print("User info received: \(userInfo)")
}
func reachabilityDidChange(_ isReachable: Bool) {
print("Reachability changed: \(isReachable)")
}
func activationDidComplete(with state: WCSessionActivationState) {
print("Activation completed: \(state.rawValue)")
}
}
// In your app setup:
let handler = WatchHandler()
WatchConnector.shared.delegate = handler
WatchConnector.shared.activate()
  1. Bundle IDが正しく関連付けられていることを確認してください(WatchアプリのBundle IDは、iOSアプリのBundle IDに .watchkitapp)
  2. 両方のアプリが同じチームで署名されていることを確認してください
  3. 実機での操作: iPhone の Watch アプリを開く → 「My Watch」→ アプリを検索して表示 → トグルを ON にする
  1. 両方のアプリでWCSessionが有効であることを確認してください
  2. 確認 isReachable メッセージを送信する前に
  3. 確実に配信するには、以下を使用してください transferUserInfo の代わりに sendMessage
  4. もう一方のデバイスがメッセージを送信する前に、リスナーが登録されていることを確認してください

“Session Not Activated” エラー

「Session Not Activated」エラーセクション
  1. 呼び出す WatchConnector.shared.activate() アプリのライフサイクル初期に
  2. iOSではプラグインが自動的に有効化されます。プラグインがインポートされていることを確認してください
  3. iOS ターゲットに WatchConnectivity 機能が追加されていることを確認してください
  1. パッケージが追加されていることを確認してください watch ターゲット、iOS ターゲットではありません
  2. ビルドフォルダをクリーンアップ: Product → Clean Build Folder (Cmd + Shift + K)
  3. パッケージキャッシュをリセット: ファイル → パッケージ → パッケージキャッシュをリセット
  1. シミュレータをリセット: デバイス → すべてのコンテンツと設定を消去
  2. iOS と watchOS のシミュレータが互換性のあるペアであることを確認してください
  3. 通信が機能するには、両方のシミュレータが起動している必要があります

「watchOS App の作成」の続きを読む

「watchOS アプリの作成」から続ける

使用している場合 watchOS アプリの作成 ネイティブプラグインの作業を計画するには、次と連携してください: @capgo/capacitor-watch の使用方法 @capgo/capacitor-watch を使う際のネイティブ機能については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、 プラグインの追加または更新 プラグインの追加または更新における実装詳細については、および Ionic Enterprise プラグインの代替案 Ionic Enterprise プラグインの代替案におけるプロダクトワークフローについては。