watchOS & Wear OS Support
Complete guide to implementing OneSignal push notifications for standalone Apple watchOS and Android Wear OS applications, including setup instructions and API integration.
Apple watchOS Setup
OneSignal supports push notifications for Apple Watch apps in two ways: synced notifications from paired iOS apps and standalone watchOS app implementations.
Synced Notifications
When an iOS mobile app is synced to a watchOS app, notifications sent to the iPhone will automatically appear on the paired Apple Watch.
Standalone watchOS Implementation
For standalone watchOS apps, you can implement push notifications independently. While OneSignal doesn’t provide a dedicated SDK for standalone watchOS apps, you can integrate using the following approach:
Register for Remote Notifications
Implement the Apple WatchKit WKExtension
with the registerForRemoteNotifications
method. This generates the APNs push token specifically for the watch device.
Handle Token Registration
Set up the WKExtensionDelegate
to capture the APNs push token using the didRegisterForRemoteNotificationsWithDeviceToken
method.
Register Device with OneSignal
Create the subscription in OneSignal using the Add a device API with these required properties:
Required Parameters:
identifier
: The APNs push token generated by the watchdevice_type
: Set to0
for iOS devicesexternal_user_id
: Unique identifier for the user who owns this subscription
Optional Parameters:
test_type
: Required only when testing on development or ad-hoc builds- Additional properties as needed for your implementation
Send Notifications
Once the device is registered, you can send push notifications directly to the watch through OneSignal’s dashboard or API.
Android Wear OS Setup
The OneSignal Android Native SDK is fully compatible with Android Wear OS applications, providing seamless integration without additional configuration.
Custom Notifications
You can enhance the watch experience by building:
- Custom notification layouts optimized for wearable displays
- Wearable-specific actions and interactions
- Watch-only notification behaviors
Follow the official Android Developer Notifications on Wear OS documentation for detailed implementation guidance on creating rich, interactive notifications tailored for wearable devices.
Implementation Notes
- Use the same OneSignal Android SDK as mobile apps
- No additional setup required for basic functionality
- Custom layouts and actions require standard Android Wear OS development practices