Platform Setup

​

iOS Setup

​

1. Xcode Configuration

1. Open ios/Runner.xcworkspace in Xcode
2. Select your app target and go to “Signing & Capabilities”
3. Add “Push Notifications” capability
4. Add “Background Modes” capability and enable “Remote notifications”

Your ios/Runner/Info.plist should include:

<key>UIBackgroundModes</key>
<array>
    <string>remote-notification</string>
</array>

​

2. Plugin Integration

Automatic! The plugin integrates automatically when you run:

flutter pub get
cd ios && pod install

​

Android Setup

​

1. Firebase Configuration

1. Go to the Firebase Console
2. Create a new project or select an existing one
3. Register your Android app using your package name (e.g., com.example.your_app)
4. Download google-services.json and place it at android/app/google-services.json

​

2. Gradle Configuration

Project-level android/build.gradle: Add to the buildscript { dependencies { ... } } block:

classpath 'com.google.gms:google-services:4.3.15' // or latest version

App-level android/app/build.gradle: Add at the very bottom:

apply plugin: 'com.google.gms.google-services'

​

3. AndroidManifest.xml Updates (Optional)

Most configuration is handled automatically by the plugin! You only need to add the following if your app opens external URLs from notifications:

<!-- For opening external URLs (optional - only if your notifications contain links) -->
<queries>
  <intent>
    <action android:name="android.intent.action.VIEW" />
    <data android:scheme="http" />
  </intent>
  <intent>
    <action android:name="android.intent.action.VIEW" />
    <data android:scheme="https" />
  </intent>
</queries>