https://github.com/kikuchy/notification_reactor

For DIY engineers! Define your own reaction by Push Notification (via APNs (iOS) / FirebaseCloudMessaging (Android)).
https://github.com/kikuchy/notification_reactor

apns fcm flutter notification

Last synced: 20 days ago
JSON representation

For DIY engineers! Define your own reaction by Push Notification (via APNs (iOS) / FirebaseCloudMessaging (Android)).

• Host: GitHub
• URL: https://github.com/kikuchy/notification_reactor
• Owner: kikuchy
• License: bsd-3-clause
• Created: 2019-07-01T02:44:50.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-03-04T11:17:21.000Z (almost 4 years ago)
• Last Synced: 2024-12-20T05:02:59.951Z (24 days ago)
• Topics: apns, fcm, flutter, notification
• Language: Dart
• Homepage: https://pub.dev/packages/notification_reactor
• Size: 180 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# notification_reactor ![pub package](https://img.shields.io/pub/v/notification_reactor.svg)

For DIY engineers! Define your own reaction by Push Notification (via APNs (iOS) / FirebaseCloudMessaging (Android)).

## Getting Started

### Android Integration

To integrate your plugin into the Android part of your app, setup Firebase:

1. Using the [Firebase Console](https://console.firebase.google.com/) add an Android app to your project:

Follow the assistant, download the generated `google-services.json` file and place it inside `android/app`.

2. Modify the `android/build.gradle` file and the `android/app/build.gradle` file to add the Google services plugin as described by the Firebase assistant.

3. Implement your original `FirebaseMessagingService` in Java/Kotlin. Recommending to create your [`NotificationCompat`](https://developer.android.com/reference/android/support/v4/app/NotificationCompat) using [`support-compat`](https://developer.android.com/topic/libraries/support-library/packages#v4-compat). When you make `Notification` with `PendingIntent`, you should contains `RemoteMessage` object you received with key `"EXTRA_PUSH_MESSAGE"`.

```java

@Override

public void onMessageReceived(RemoteMessage remoteMessage) {

    Intent launchApp = new Intent();

    launchApp.putExtra("EXTRA_PUSH_MESSAGE", remoteMessage);

    launchApp.setClass(this, MainActivity.class);

    PendingIntent onTapNotification = PendingIntent.getActivity(this, 0, launchApp, PendingIntent.FLAG_ONE_SHOT);

    ...

    NotificationBuilder builder = (new NotificationCompat.Builder(...))

            .setContentIntent(onTapNotification);

    ...

}

```

(Please see [this tutorial](https://firebase.google.com/docs/android/setup) if you want.)

### iOS Integration

To integrate your plugin into the iOS part of your app, follow these steps:

1. Generate the certificates from [Apple developer center](https://developer.apple.com/account) for receiving push notifications. (Please see [this article](https://medium.com/@ankushaggarwal/generate-apns-certificate-for-ios-push-notifications-85e4a917d522) if you want the tutorial.)

2. Enable `Push Notification` in `Capabilities` tab in Xcode opening your `ios/Runner.xcworkspace`. 

![Enabling Push Notification switch](art/enable_push_notification.png)

### Dart/Flutter Integration

From your Dart code, you need to import the plugin and instantiate it:

```dart

import 'package:notification_reactor/notification_reactor.dart';

final reactor = NotificationReactor();

```

To set handler for Push Notifications, call `setHandlers()` :

```dart

reactor.setHandlers(

  onLaunch: (Map message) { /* Called when your app launched by PushNotifications */ },

  onResume: (Map message) { /* Called when your app become foreground from background by PushNotifications */ },

  onMessage: (Map message) { /* Called when receive PushNotifications during your app is on foreground */ },

);

```

... and send pushes from your server!

When you send pushes, you need APNs/FCM push token. To get token, recommending to use [plain_notification_token](https://pub.dev/packages/plain_notification_token).