Membuat Aplikasi watchOS
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
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.
Prerequisites
Bagian berjudul “Prasyarat”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 iosjika belum) - Akun Apple Developer (akun gratis cukup untuk development)
Ringkasan Struktur Proyek
Bagian berjudul “Ringkasan Struktur Proyek”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
Langkah 1: Buka Proyek iOS di Xcode
Bagian berjudul “Langkah 1: Buka Proyek iOS Anda di Xcode”- Buka proyek Capacitor Anda
ios/Appfolder - Buka
App.xcworkspace(bukan.xcodeproj) dengan klik dua kali - Tunggu hingga Xcode mengindeks proyek
Langkah 2: Tambahkan Target watchOS
Bagian berjudul “Langkah 2: Tambahkan Target watchOS”-
Di Xcode, buka File → New → Target…
-
Di pemilih template:
- Pilih watchOS tab di bagian atas
- Pilih Aplikasi
- Klik Berikutnya
-
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)
- Nama Produk:
-
Klik Selesai
-
Saat muncul prompt “Activate ‘MyWatch’ scheme?”, klik Aktifkan
Langkah 3: Konfigurasi Pengaturan Watch App
Bagian berjudul “Langkah 3: Konfigurasi Pengaturan Watch App”-
Di Project Navigator (sidebar kiri), pilih proyek Anda (ikon biru di bagian atas)
-
Pilih target watch Anda (misalnya, “MyWatch”) dari daftar target
-
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
-
Buka Signing & Capabilities tab:
- Aktifkan Kelola signing secara otomatis
- Pilih Tim
- Xcode akan membuat profil provisioning secara otomatis
-
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.
-
Di Xcode, buka File → Tambahkan Dependensi Paket…
-
Di kolom pencarian, masukkan:
https://github.com/Cap-go/capacitor-watch.git -
Tekan Enter dan tunggu Xcode mengambil package
-
Konfigurasi paket:
- Aturan Dependensi: “Up to Next Major Version” dengan “8.0.0”
- Klik Tambahkan Paket
-
Pilih produk yang akan ditambahkan:
- PENTING: Hanya pilih
CapgoWatchSDK - Pastikan ditambahkan ke target watch (misalnya, “MyWatch”), bukan aplikasi iOS
- Klik Tambahkan Paket
- PENTING: Hanya pilih
Langkah 5: Implementasi Watch App
Bagian berjudul “Langkah 5: Implementasikan Watch App”Sekarang, buat watch app code. Ganti file yang dibuat otomatis dengan berikut:
5.1 Buat Entry Point App
Bagian berjudul “5.1 Buat Titik Masuk Aplikasi”Edit 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 Buat Main View
Bagian berjudul “5.2 Buat Tampilan Utama”Edit 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()}Langkah 6: Konfigurasi iOS App untuk WatchConnectivity
Bagian berjudul “Langkah 6: Konfigurasi Aplikasi iOS untuk WatchConnectivity”Aplikasi iOS Anda juga memerlukan kemampuan WatchConnectivity.
-
Di Project Navigator, pilih proyek Anda
-
Pilih target Aplikasi iOS (bukan target watch)
-
Buka Signing & Capabilities tab
-
Klik + Kapabilitas
-
Cari dan tambahkan WatchConnectivity (jika tersedia) atau mungkin ditambahkan secara otomatis
-
Plugin Capacitor menangani sisi iOS secara otomatis, tetapi pastikan Info.plist Anda memiliki:
<key>WKCompanionAppBundleIdentifier</key><string>app.capgo.myapp.watchkitapp</string>
Langkah 7: Build dan Run
Bagian berjudul “Step 7: Build and Run”Jalankan di Simulator
Bagian berjudul “Jalankan di Simulator”-
Pilih skema watch Anda dari pemilih skema (bagian atas jendela Xcode)
-
Pilih simulator watch:
- Klik pemilih perangkat di sebelah skema
- Pilih simulator Apple Watch (mis., “Apple Watch Series 9 (45mm)”)
-
Klik Jalankan tombol (▶️) atau tekan
Cmd + R -
iOS Simulator akan meluncurkan dengan iPhone dan Apple Watch
Jalankan di Perangkat Fisik
Bagian berjudul “Jalankan di Perangkat Fisik”-
Hubungkan iPhone Anda via USB
-
Pastikan Apple Watch Anda sudah dipasangkan dengan iPhone tersebut
-
Pilih scheme watch Anda
-
Pilih Apple Watch fisik Anda dari daftar perangkat
-
Klik Jalankan
-
Pertama kali: Anda mungkin perlu mempercayai komputer Anda di kedua perangkat
Langkah 8: Uji Komunikasi
Bagian berjudul “Langkah 8: Uji Komunikasi”Dari iPhone (Capacitor) ke Watch
Bagian berjudul “Dari iPhone (Capacitor) ke Watch”Di aplikasi Capacitor Anda:
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!' } });}Dari Watch ke iPhone
Bagian berjudul “Dari Watch ke iPhone”Aplikasi watch menggunakan 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)")}Menangani Pesan di iPhone
Bagian berjudul “Proses Pesan di 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'] } });});Lanjutan: Custom Delegate untuk Kontrol Lebih
Bagian berjudul “Lanjutan: Custom Delegate untuk Kontrol Lebih Lanjut”Jika Anda membutuhkan kontrol lebih, implementasikan 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()Pemecahan Masalah
Bagian berjudul “Troubleshooting”Watch App Tidak Muncul di Watch
Bagian berjudul “Watch App Tidak Muncul di Watch”- Pastikan bundle ID terkait dengan benar (bundle ID watch app harus berupa bundle ID iOS app +
.watchkitapp) - Periksa bahwa kedua app ditandatangani dengan tim yang sama
- Di perangkat fisik: Buka Watch app di iPhone → My Watch → gulir untuk menemukan app Anda → aktifkan
Pesan Tidak Diterima
Bagian berjudul “Pesan Tidak Diterima”- Pastikan WCSession sudah aktif di kedua aplikasi
- Periksa
isReachablesebelum mengirim pesan - Untuk pengiriman yang terjamin, gunakan
transferUserInfoalih-alihsendMessage - Pastikan listener sudah terdaftar sebelum perangkat lain mengirim pesan
Error “Session Not Activated”
Bagian berjudul “Error “Session Not Activated””- Panggil
WatchConnector.shared.activate()di awal siklus hidup aplikasi - Di iOS, plugin diaktifkan secara otomatis - pastikan plugin sudah diimpor
- Pastikan capability WatchConnectivity sudah ditambahkan ke target iOS
Error Build dengan CapgoWatchSDK
Bagian berjudul “Error Build dengan CapgoWatchSDK”- Pastikan package sudah ditambahkan ke target watch, bukan target iOS
- Bersihkan build folder: Produk → Bersihkan Folder Build (Cmd + Shift + K)
- Reset cache package: File → Packages → Reset Package Caches
Masalah Simulator
Bagian berjudul “Masalah Simulator”- Reset simulator: Perangkat → Hapus Semua Konten dan Pengaturan
- Pastikan simulator iOS dan watchOS adalah pasangan yang kompatibel
- Kedua simulator harus berjalan agar komunikasi dapat berfungsi
Langkah Berikutnya
Bagian berjudul “Langkah Selanjutnya”- Membuat aplikasi Wear OS untuk jam Android
- Referensi API - Dokumentasi lengkap API
- Communication Patterns - Kapan menggunakan masing-masing metode
- Aplikasi Contoh - Contoh lengkap yang berfungsi
Lanjutkan dari Membuat watchOS App
Bagian berjudul “Lanjut dari Membuat Aplikasi watchOS”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.