Langsung ke konten

Membuat Aplikasi watchOS

GitHub

Panduan ini memandu Anda membuat watchOS companion app dari nol, termasuk setup proyek di Xcode, integrasi CapgoWatchSDK, dan membangun watch app fungsional dengan SwiftUI.

Untuk Wear OS, gunakan Membuat aplikasi Wear OS instead.

Sebelum memulai, pastikan Anda sudah memiliki:

  • Xcode 15 atau lebih baru (unduh dari Mac App Store)
  • macOS Sonoma atau lebih baru (untuk watchOS SDK terbaru)
  • Proyek iOS Capacitor yang sudah ada (jalankan npx cap add ios jika belum)
  • Akun Apple Developer (akun gratis cukup untuk development)

Setelah mengikuti panduan ini, struktur proyek Anda akan menjadi seperti ini:

  • Direktoriios/
    • DirektoriApp/
      • DirektoriApp/ (aplikasi iOS utama Anda)
        • …
      • App.xcodeproj
      • App.xcworkspace (gunakan ini untuk membuka proyek)
      • Podfile
    • DirektoriMyWatch/ (aplikasi jam baru)
      • DirektoriMyWatch/ (sumber aplikasi jam)
        • MyWatchApp.swift
        • ContentView.swift
        • DirektoriAssets.xcassets/
          • …
      • MyWatch.xcodeproj
  1. Buka proyek Capacitor Anda ios/App folder
  2. Buka App.xcworkspace (bukan .xcodeproj) dengan klik dua kali
  3. Tunggu hingga Xcode mengindeks proyek
  1. Di Xcode, buka File → New → Target…

  2. Di pemilih template:

    • Pilih watchOS tab di bagian atas
    • Pilih Aplikasi
    • Klik Berikutnya
  3. Konfigurasi aplikasi watch Anda:

    • Nama Produk: MyWatch (atau nama pilihan Anda)
    • Tim: Pilih tim Apple Developer Anda
    • Identifier Organisasi: Harus sama dengan aplikasi iOS Anda (mis., app.capgo)
    • Bundle Identifier: Akan dibuat otomatis (mis., app.capgo.myapp.watchkitapp)
    • Bahasa: Swift
    • Antarmuka Pengguna: SwiftUI
    • Tipe Watch App: App (bukan App untuk Existing iOS App)
    • Hapus centang Sertakan Notification Scene (kecuali Anda membutuhkannya)
    • Hapus centang Sertakan Complication (kecuali Anda membutuhkannya)
  4. Klik Selesai

  5. Saat muncul prompt “Activate ‘MyWatch’ scheme?”, klik Aktifkan

  1. Di Project Navigator (sidebar kiri), pilih proyek Anda (ikon biru di bagian atas)

  2. Pilih target watch Anda (misalnya, “MyWatch”) dari daftar target

  3. Buka halaman Umum tab:

    • Nama Tampilan: Nama yang ditampilkan di bawah ikon aplikasi (misalnya, “My App”)
    • Bundle Identifier: Harus diakhiri dengan .watchkitapp
    • Versi: Cocokkan versi aplikasi iOS Anda
    • Build: Cocokkan nomor build aplikasi iOS Anda
  4. Buka Signing & Capabilities tab:

    • Aktifkan Kelola signing secara otomatis
    • Pilih Tim
    • Xcode akan membuat profil provisioning secara otomatis
  5. Atur Info Deployment:

    • Deployment Minimum: watchOS 9.0 atau lebih baru

Langkah 4: Tambahkan CapgoWatchSDK via Swift Package Manager

Bagian berjudul “Langkah 4: Tambahkan CapgoWatchSDK via Swift Package Manager”

The CapgoWatchSDK provides a ready-to-use WatchConnector class siap pakai untuk komunikasi.

  1. Di Xcode, buka File → Tambahkan Dependensi Paket…

  2. Di kolom pencarian, masukkan:

    https://github.com/Cap-go/capacitor-watch.git
  3. Tekan Enter dan tunggu Xcode mengambil package

  4. Konfigurasi paket:

    • Aturan Dependensi: “Up to Next Major Version” dengan “8.0.0”
    • Klik Tambahkan Paket
  5. Pilih produk yang akan ditambahkan:

    • PENTING: Hanya pilih CapgoWatchSDK
    • Pastikan ditambahkan ke target watch (misalnya, “MyWatch”), bukan aplikasi iOS
    • Klik Tambahkan Paket

Sekarang, buat watch app code. Ganti file yang dibuat otomatis dengan berikut:

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

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

Langkah 6: Konfigurasi iOS App untuk WatchConnectivity

Bagian berjudul “Langkah 6: Konfigurasi Aplikasi iOS untuk WatchConnectivity”

Aplikasi iOS Anda juga memerlukan kemampuan WatchConnectivity.

  1. Di Project Navigator, pilih proyek Anda

  2. Pilih target Aplikasi iOS (bukan target watch)

  3. Buka Signing & Capabilities tab

  4. Klik + Kapabilitas

  5. Cari dan tambahkan WatchConnectivity (jika tersedia) atau mungkin ditambahkan secara otomatis

  6. Plugin Capacitor menangani sisi iOS secara otomatis, tetapi pastikan Info.plist Anda memiliki:

    <key>WKCompanionAppBundleIdentifier</key>
    <string>app.capgo.myapp.watchkitapp</string>
  1. Pilih skema watch Anda dari pemilih skema (bagian atas jendela Xcode)

  2. Pilih simulator watch:

    • Klik pemilih perangkat di sebelah skema
    • Pilih simulator Apple Watch (mis., “Apple Watch Series 9 (45mm)”)
  3. Klik Jalankan tombol (▶️) atau tekan Cmd + R

  4. iOS Simulator akan meluncurkan dengan iPhone dan Apple Watch

  1. Hubungkan iPhone Anda via USB

  2. Pastikan Apple Watch Anda sudah dipasangkan dengan iPhone tersebut

  3. Pilih scheme watch Anda

  4. Pilih Apple Watch fisik Anda dari daftar perangkat

  5. Klik Jalankan

  6. Pertama kali: Anda mungkin perlu mempercayai komputer Anda di kedua perangkat

Di aplikasi Capacitor Anda:

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

Aplikasi watch menggunakan 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'] }
});
});

Jika Anda membutuhkan kontrol lebih, implementasikan 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. Pastikan bundle ID terkait dengan benar (bundle ID watch app harus berupa bundle ID iOS app + .watchkitapp)
  2. Periksa bahwa kedua app ditandatangani dengan tim yang sama
  3. Di perangkat fisik: Buka Watch app di iPhone → My Watch → gulir untuk menemukan app Anda → aktifkan
  1. Pastikan WCSession sudah aktif di kedua aplikasi
  2. Periksa isReachable sebelum mengirim pesan
  3. Untuk pengiriman yang terjamin, gunakan transferUserInfo alih-alih sendMessage
  4. Pastikan listener sudah terdaftar sebelum perangkat lain mengirim pesan
  1. Panggil WatchConnector.shared.activate() di awal siklus hidup aplikasi
  2. Di iOS, plugin diaktifkan secara otomatis - pastikan plugin sudah diimpor
  3. Pastikan capability WatchConnectivity sudah ditambahkan ke target iOS
  1. Pastikan package sudah ditambahkan ke target watch, bukan target iOS
  2. Bersihkan build folder: Produk → Bersihkan Folder Build (Cmd + Shift + K)
  3. Reset cache package: File → Packages → Reset Package Caches
  1. Reset simulator: Perangkat → Hapus Semua Konten dan Pengaturan
  2. Pastikan simulator iOS dan watchOS adalah pasangan yang kompatibel
  3. Kedua simulator harus berjalan agar komunikasi dapat berfungsi

Jika Anda menggunakan Membuat Aplikasi watchOS untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan @capgo/capacitor-watch untuk fitur native di Menggunakan @capgo/capacitor-watch, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.