Troubleshooting for the Capacitor Plugin

This troubleshooting guide will help you resolve common issues with the Airship Capacitor plugin.

Common Issues

Below are solutions to common issues you may encounter when integrating the Airship Capacitor plugin.

Installation Errors

If you encounter errors during installation:

• Verify that you’re using a compatible version of Capacitor
• Ensure all native dependencies are properly synced with npx cap sync
• Check that your iOS and Android projects are correctly configured

Initialization Errors

If you encounter errors during SDK initialization:

• Verify your credentials in the Airship dashboard under Settings → APIs & Integrations → App Keys
• Check that takeOff is called correctly in your app or configured in capacitor.config.json
• Ensure both iOS and Android native modules are properly installed

Push Notifications Not Working

If push notifications are not being received:

• Verify that push notifications are enabled for both iOS and Android
• Check that APNs (iOS) and FCM (Android) are properly configured
• Ensure the app has notification permissions

Checking Push Notification Status

If you’re having trouble with push notifications, check the notification status to see the current state:

const status = await Airship.push.getNotificationStatus()

console.log('Are notifications allowed:', status.areNotificationsAllowed)
console.log('Is opted in:', status.isOptedIn)
console.log('Is user notifications enabled:', status.isUserNotificationsEnabled)
console.log('Is airship opted in:', status.isAirshipOptedIn)
console.log('Is user opted in:', status.isUserOptedIn)
console.log('Is pushable:', status.isPushable)
console.log('Is privacy manager enabled:', status.isPrivacyManagerEnabled)

You can also listen for status changes to debug permission issues:

const handle = await Airship.push.onNotificationStatusChanged(event => {
  console.log('Notification status changed:', event.status)
  
  if (!event.status.areNotificationsAllowed) {
    console.log('System-level notifications are disabled')
  }
  
  if (!event.status.isUserNotificationsEnabled) {
    console.log('User notifications are disabled in Airship')
  }
  
  if (!event.status.isPushable) {
    console.log('Device is not pushable')
  }
})