Aller au contenu

Créer une app watchOS

GitHub

Ce guide vous guide dans la création d'un watchOS application compagnon de zéro, incluant la configuration du projet dans Xcode, l’intégration de CapgoWatchSDK et la création d’une application watch fonctionnelle avec SwiftUI.

Pour Wear OS, utilisez Créer une app Wear OS plutôt.

Avant de commencer, assurez-vous d'avoir :

  • Xcode 15 ou une version ultérieure (à télécharger sur le Mac App Store)
  • macOS Sonoma ou version ultérieure (pour la dernière version de watchOS SDK)
  • Un projet iOS Capacitor existant (exécutez npx cap add ios si ce n’est pas déjà fait)
  • Compte Apple Developer (un compte gratuit suffit pour le développement)

Une fois ce guide terminé, votre projet aura cette structure :

  • Répertoireios/
    • RépertoireApp/
      • RépertoireApp/ (votre application iOS principale)
        • …
      • App.xcodeproj
      • App.xcworkspace (utilisez-le pour ouvrir le projet)
      • Podfile
    • RépertoireMyWatch/ (nouvelle app watch)
      • RépertoireMyWatch/ (source de l'app watch)
        • MyWatchApp.swift
        • ContentView.swift
        • RépertoireAssets.xcassets/
          • …
      • MyWatch.xcodeproj
  1. Accédez à votre projet Capacitor ios/App dossier
  2. Ouvrez App.xcworkspace (pas .xcodeproj) en double-cliquant dessus
  3. Attendez que Xcode indexe le projet
  1. Dans Xcode, allez dans Fichier → Nouveau → Cible…

  2. Dans le sélecteur de template :

    • Sélectionnez watchOS onglet en haut
    • Choisissez cible
    • Cliquez Suivant
  3. Configurez votre application watch :

    • Nom du produit: MyWatch (ou le nom de votre choix)
    • Équipe: Sélectionnez votre équipe Apple Developer
    • Identifiant d'organisation: Doit correspondre à votre app iOS (ex. : app.capgo)
    • Identifiant du bundle: Sera généré automatiquement (ex. : app.capgo.myapp.watchkitapp)
    • Langue: Swift
    • Interface utilisateur: SwiftUI
    • Type d'application Watch: App (et non « App for Existing iOS App »)
    • Décocher Inclure la scène de notification (sauf si nécessaire)
    • Décocher Inclure la complication (sauf si nécessaire)
  4. Cliquez Terminer

  5. Lorsque le prompt « Activate ‘MyWatch’ scheme? » s’affiche, cliquez Activer

Étape 3 : Configurer les réglages de l'app Watch

Section intitulée « Étape 3 : Configurer les réglages de l'app Watch »
  1. Dans le Project Navigator (barre latérale gauche), sélectionnez votre projet (l'icône bleue en haut)

  2. Sélectionnez votre cible watch (ex : « MyWatch ») dans la liste des cibles

  3. Allez sur la Général onglet :

    • Nom d'affichage : nom affiché sous l'icône de l'app (ex : « Mon App »)
    • Identifiant du bundle : doit se terminer par .watchkitapp
    • Version : correspond à la version de votre app iOS
    • Build: Correspondre au n° de build de votre app iOS
  4. Accéder à Signature et capacités onglet :

    • Activer Gérer automatiquement la signature
    • Sélectionnez votre Équipe
    • Xcode créera automatiquement les profils de provisionnement
  5. Définissez Infos de déploiement:

    • Déploiements minimum: watchOS 9.0 ou version ultérieure

Étape 4 : Ajouter CapgoWatchSDK via Swift Package Manager

Section intitulée « Étape 4 : Ajouter CapgoWatchSDK via Swift Package Manager »

The CapgoWatchSDK provides a ready-to-use WatchConnector classe de communication.

  1. Dans Xcode, allez dans Fichier → Ajouter des dépendances de package…

  2. Dans le champ de recherche, saisissez :

    https://github.com/Cap-go/capacitor-watch.git
  3. Appuyez sur Entrée et attendez que Xcode récupère le package

  4. Configurez le package :

    • Règle de dépendance: « Jusqu'à la prochaine version majeure » avec « 8.0.0 »
    • Cliquez Ajouter un package
  5. Choisissez les produits à ajouter :

    • IMPORTANT: Sélectionnez uniquement CapgoWatchSDK
    • Assurez-vous qu'il est ajouté à votre cible watch (ex : « MyWatch »), et non à l'app iOS
    • Cliquez Ajouter un package

Créons maintenant l’application watch code. Remplacez les fichiers générés automatiquement par les suivants :

5.1 Créer le point d’entrée de l’application

Section intitulée « 5.1 Créer le point d’entrée de l’application »

Modifier 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()
}
}
}

Modifier 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()
}

Étape 6 : Configurer l’app iOS pour WatchConnectivity

Section intitulée « Étape 6 : Configurer l’app iOS pour WatchConnectivity »

Votre app iOS a également besoin de la capacité WatchConnectivity.

  1. Sélectionnez votre projet dans le Project Navigator

  2. Sélectionnez votre Cible iOS App (et non la cible watch)

  3. Accéder à Signature et capacités onglet

  4. Cliquez + Capacité

  5. Rechercher et ajouter WatchConnectivity (si disponible) ou il peut être ajouté automatiquement

  6. Le plugin Capacitor gère le côté iOS automatiquement, mais assurez-vous que votre Info.plist contient :

    <key>WKCompanionAppBundleIdentifier</key>
    <string>app.capgo.myapp.watchkitapp</string>
  1. Sélectionnez votre schéma watch depuis le sélecteur de schéma (en haut de la fenêtre Xcode)

  2. Choisissez un simulateur watch :

    • Cliquez sur le sélecteur d’appareil à côté du schéma
    • Sélectionnez un simulateur Apple Watch (par ex. « Apple Watch Series 9 (45 mm) »)
  3. Cliquez sur les Exécutez bouton (▶️) ou appuyez sur Cmd + R

  4. Le simulateur iOS se lancera avec l’iPhone et l’Apple Watch

  1. Connectez votre iPhone via USB

  2. Assurez-vous que votre Apple Watch est appairée avec cet iPhone

  3. Sélectionnez le schéma de votre montre

  4. Sélectionnez votre Apple Watch physique dans la liste des appareils

  5. Cliquez Exécutez

  6. First time: You may need to trust your computer on both devices

Dans votre application 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!' }
});
}

L'application Watch utilise 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)")
}
// 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'] }
});
});

Avancé : delegate personnalisé pour plus de contrôle

Section intitulée « Avancé : délégué personnalisé pour plus de contrôle »

Si vous avez besoin de plus de contrôle, implémentez 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. Vérifiez que les bundle IDs sont correctement liés (le bundle ID de l’app Watch doit être le bundle ID de l’app iOS + .watchkitapp)
  2. Vérifiez que les deux apps sont signées avec la même équipe
  3. Sur un appareil physique : ouvrez l’app Watch sur l’iPhone → Ma montre → faites défiler pour trouver votre app → activez

Les messages ne sont pas reçus

Section intitulée « Messages non reçus »
  1. Vérifiez que les deux applications ont activé WCSession
  2. Vérifier isReachable avant d’envoyer des messages
  3. Pour une livraison garantie, utilisez transferUserInfo au lieu de sendMessage
  4. Assurez-vous que les listeners sont enregistrés avant que l’autre appareil n’envoie des messages
  1. Appelez WatchConnector.shared.activate() tôt dans le cycle de vie de l’app
  2. Sur iOS, le plugin s’active automatiquement – assurez-vous qu’il est importé
  3. Vérifiez que la capacité WatchConnectivity est ajoutée à la cible iOS
  1. Vérifiez que le package est ajouté à cible watch, et non à la cible iOS
  2. Nettoyer le dossier de build : Produit → Nettoyer le dossier de build (Cmd + Shift + K)
  3. Réinitialiser les caches de packages : Fichier → Packages → Réinitialiser les caches de packages
  1. Réinitialisez les simulateurs : Appareil → Effacer tout le contenu et les réglages
  2. Assurez-vous que les simulateurs iOS et watchOS sont des paires compatibles
  3. Les deux simulateurs doivent être lancés pour que la communication fonctionne

Continuer depuis « Créer une application watchOS »

Section intitulée « Continuer depuis Créer une application watchOS »

Si vous utilisez Créer une app watchOS pour planifier le travail sur les plugins natifs, connectez-l’à Utiliser @capgo/capacitor-watch pour la fonctionnalité native dans « Utiliser @capgo/capacitor-watch », Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Ajout ou mise à jour de plugins, et Alternatives aux plugins Ionic Enterprise pour le workflow produit dans Alternatives aux plugins Ionic Enterprise.