watchOS アプリの作成
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
このガイドでは、 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: Xcode で iOS プロジェクトを開く
「ステップ 1: Xcode で iOS プロジェクトを開く」というセクション- Capacitor プロジェクトの
ios/Appフォルダ - 開く
App.xcworkspace(非.xcodeproj) をダブルクリックして開きます - Xcodeがプロジェクトをインデックス化するまで待ちます
ステップ 2: watchOS ターゲットの追加
「ステップ 2: watchOS ターゲットの追加」というセクション-
Xcodeで、次を開きます: ファイル → 新規 → ターゲット…
-
テンプレート選択画面で:
- 選択します watchOS 上部のタブ
- 選択: アプリ
- クリック 次へ
-
ウォッチアプリを設定します:
- 製品名:
MyWatch(または任意の名前) - チーム: Apple Developer チームを選択してください
- 組織識別子: iOS アプリと一致する必要があります (例:
app.capgo) - バンドル識別子: 自動生成されます (例:
app.capgo.myapp.watchkitapp) - 言語: Swift
- ユーザーインターフェース: SwiftUI
- Watch Appのタイプ: App(既存の iOS アプリ用の App ではありません)
- チェックを外す Notification Scene を含める (必要な場合を除く)
- チェックを外す Complication を含める (必要な場合を除く)
- 製品名:
-
クリック 完了
-
「“MyWatch” スキームを有効にしますか?」と表示されたら、 アクティブ化
ステップ 3: Watch App の設定
「ステップ 3: Watch App の設定」セクション-
Project Navigator(左サイドバー)で、プロジェクト(一番上の青いアイコン)を選択します
-
ターゲット一覧から Watch ターゲット(例: “MyWatch”)を選択します
-
以下にアクセスしてください: 一般 タブ:
- 表示名: アプリアイコンの下に表示される名前(例: “My App”)
- バンドル識別子: 末尾は以下で終わる必要があります
.watchkitapp - バージョン: iOS アプリのバージョンと一致させてください
- ビルド: iOS アプリのビルド番号を一致させる
-
以下に移動します: Signing & Capabilities タブ:
- 有効にする 署名管理を自動化
- 次を選択: チーム
- Xcode がプロビジョニングプロファイルを自動的に作成します
-
設定 デプロイ情報:
- 最小デプロイメント:watchOS 9.0以降
ステップ4: Swift Package ManagerでCapgoWatchSDKを追加
セクション「ステップ4: Swift Package ManagerでCapgoWatchSDKを追加」CapgoWatchSDKは、すぐに使える WatchConnector 通信用のクラスを提供します。
-
Xcodeで、次を開きます: ファイル → パッケージの依存関係を追加…
-
検索フィールドに以下を入力します:
https://github.com/Cap-go/capacitor-watch.git -
Enterキーを押して、Xcodeがパッケージを取得するまで待ちます
-
パッケージを設定します:
- 依存関係ルール:「次のメジャーバージョンまで」を「8.0.0」で
- クリック パッケージを追加
-
追加するプロダクトを選択:
- 重要:選択するのは
CapgoWatchSDK - 追加先が必ず watch ターゲット (例:「MyWatch」)であることを確認してください。iOS アプリではありません
- クリック パッケージを追加
- 重要:選択するのは
ステップ5: Watch Appの実装
「ステップ 5: Watch アプリの実装」セクションでは、watch app code を作成しましょう。自動生成されたファイルを以下に置き換えてください:
5.1 アプリのエントリポイントを作成
「5.1 アプリのエントリポイントを作成」セクション編集 MyWatch/MyWatchApp.swift:
import SwiftUIimport CapgoWatchSDK
@mainstruct MyWatchApp: App { init() { // Activate WatchConnectivity when app launches WatchConnector.shared.activate() }
var body: some Scene { WindowGroup { ContentView() } }}5.2 メインビューの作成
「5.2 メインビューの作成」というタイトルのセクション編集 MyWatch/ContentView.swift:
import SwiftUIimport 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 statusstruct 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()}ステップ 6: WatchConnectivity 用の iOS アプリ設定
「ステップ 6: WatchConnectivity 用の iOS アプリ設定」というタイトルのセクションiOS アプリにも WatchConnectivity の capability が必要です。
-
Project Navigator でプロジェクトを選択します
-
次を選択: iOS App ターゲット (watch ターゲットではありません)
-
以下に移動します: Signing & Capabilities タブ
-
クリック + Capability
-
検索して追加 WatchConnectivity (利用可能な場合)または自動的に追加される場合があります
-
Capacitor プラグインが iOS 側の処理を自動で行いますが、Info.plist に以下が含まれていることを確認してください:
<key>WKCompanionAppBundleIdentifier</key><string>app.capgo.myapp.watchkitapp</string>
ステップ 7: ビルドと実行
「ステップ7:ビルドと実行」セクションシミュレーターで実行
「シミュレータで実行」セクション-
スキームセレクタ(Xcodeウィンドウ上部)からwatchのスキームを選択します
-
Watchシミュレータを選択:
- スキームの隣にあるデバイスセレクタをクリックします
- Apple Watchシミュレータを選択します(例:「Apple Watch Series 9 (45mm)」)
-
次をクリックします: 実行 ボタン (▶️) をクリックするか、キーを押します
Cmd + R -
iPhoneとApple Watchの両方が起動した状態でiOS Simulatorが立ち上がります
実機で実行
「実機で実行」セクション-
iPhoneをUSBで接続します
-
Apple Watch がその iPhone とペアリングされていることを確認してください
-
Watch スキームを選択します
-
デバイスリストから物理的な Apple Watch を選択します
-
クリック 実行
-
初回: 両方のデバイスでコンピューターを信頼する必要がある場合があります
ステップ 8: 通信テスト
「ステップ 8: 通信のテスト」セクションiPhone (Capacitor) から Watch へ
「iPhone (Capacitor) から Watch へ」セクションCapacitor アプリで:
import { CapgoWatch } from '@capgo/capacitor-watch';
// Check connectionconst info = await CapgoWatch.getInfo();console.log('Watch reachable:', info.isReachable);
// Send a messageif (info.isReachable) { await CapgoWatch.sendMessage({ data: { action: 'update', value: 'Hello from iPhone!' } });}Watch から iPhone へ
「Watch から iPhone へ」セクションwatch アプリは次を使用します WatchConnector:
// Send message (fire and forget)WatchConnector.shared.sendMessage(["action": "buttonTapped"])
// Send message with replyWatchConnector.shared.sendMessage(["request": "getData"]) { reply in print("Got reply: \(reply)")}iPhone でメッセージを処理する
セクション「iPhoneでのメッセージ処理」// Listen for messages from watchawait CapgoWatch.addListener('messageReceived', (event) => { console.log('Message from watch:', event.message); // { action: 'buttonTapped' }});
// Handle messages that need a replyawait 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'] } });});上級: カスタム Delegate でより細かく制御
セクション「高度な設定: より詳細な制御のためのカスタムデリゲート」より詳細な制御が必要な場合は、 WatchConnectorDelegate:
import SwiftUIimport 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 = handlerWatchConnector.shared.activate()トラブルシューティング
「トラブルシューティング」セクションWatch に Watch App が表示されない
セクション「WatchにWatchアプリが表示されない場合」- Bundle IDが正しく関連付けられていることを確認してください(WatchアプリのBundle IDは、iOSアプリのBundle IDに
.watchkitapp) - 両方のアプリが同じチームで署名されていることを確認してください
- 実機での操作: iPhone の Watch アプリを開く → 「My Watch」→ アプリを検索して表示 → トグルを ON にする
メッセージを受信できない
「メッセージが受信できない」セクション- 両方のアプリでWCSessionが有効であることを確認してください
- 確認
isReachableメッセージを送信する前に - 確実に配信するには、以下を使用してください
transferUserInfoの代わりにsendMessage - もう一方のデバイスがメッセージを送信する前に、リスナーが登録されていることを確認してください
“Session Not Activated” エラー
「Session Not Activated」エラーセクション- 呼び出す
WatchConnector.shared.activate()アプリのライフサイクル初期に - iOSではプラグインが自動的に有効化されます。プラグインがインポートされていることを確認してください
- iOS ターゲットに WatchConnectivity 機能が追加されていることを確認してください
CapgoWatchSDK のビルドエラー
「CapgoWatchSDK でのビルドエラー」セクション- パッケージが追加されていることを確認してください watch ターゲット、iOS ターゲットではありません
- ビルドフォルダをクリーンアップ: Product → Clean Build Folder (Cmd + Shift + K)
- パッケージキャッシュをリセット: ファイル → パッケージ → パッケージキャッシュをリセット
シミュレータの問題
セクション「シミュレータの問題」- シミュレータをリセット: デバイス → すべてのコンテンツと設定を消去
- iOS と watchOS のシミュレータが互換性のあるペアであることを確認してください
- 通信が機能するには、両方のシミュレータが起動している必要があります
次のステップ
「次のステップ」セクション- Wear OSアプリの作成 Android ウォッチの場合
- API リファレンス - API のドキュメントを完了する
- 通信パターン - 各メソッドの使い分け
- サンプルアプリ - 動作する完全な例
「watchOS App の作成」の続きを読む
「watchOS アプリの作成」から続ける使用している場合 watchOS アプリの作成 ネイティブプラグインの作業を計画するには、次と連携してください: @capgo/capacitor-watch の使用方法 @capgo/capacitor-watch を使う際のネイティブ機能については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、 プラグインの追加または更新 プラグインの追加または更新における実装詳細については、および Ionic Enterprise プラグインの代替案 Ionic Enterprise プラグインの代替案におけるプロダクトワークフローについては。