mpush 1.1.2
mpush: ^1.1.2 copied to clipboard
MPush client for Flutter, you can use this plugin to interact with MPush.
MPush-Flutter #
MPush client for Flutter, you can use this plugin to interact with the MPush platform.
Installation #
You can install the MPush SDK using pub, add this to your pubspec.yaml
file:
dependencies:
mpush: ^1.0.7
And then install packages from the command line with:
$ flutter pub get
Setup #
Android #
To integrate your plugin into the Android part of your app, follow these steps (from the firebase messaging plugin):
-
Using the Firebase Console add an Android app to your project: Follow the assistant, download the generated
google-services.json
file and place it insideandroid/app
. -
Add the classpath to the
[project]/android/build.gradle
file.
dependencies {
// Example existing classpath
classpath 'com.android.tools.build:gradle:3.5.3'
// Add the google services classpath
classpath 'com.google.gms:google-services:4.3.2'
}
- Add the apply plugin to the
[project]/android/app/build.gradle
file.
// ADD THIS AT THE BOTTOM
apply plugin: 'com.google.gms.google-services'
Note: If this section is not completed you will get an error like this:
java.lang.IllegalStateException:
Default FirebaseApp is not initialized in this process [package name].
Make sure to call FirebaseApp.initializeApp(Context) first.
Note: When you are debugging on Android, use a device or AVD with Google Play services. Otherwise you will not be able to authenticate.
iOS #
The first thing you have to do is to setup the iOS project is to enable the push notification capability to your project. Open the project in Xcode going in ios -> Runner.xcworkspace, then in the Signing & Capabilities tab click on the + Capability button and select "Push Notifications"
Note: you will have to use a provisoning profile created for this app, you will not be able to test and receive push notification using a wildcard provisioning profile.
Then yu have to modify the AppDelegate class of your application, open AppDelegate.swift
file and add this line in the didFinishLaunchingWithOptions
function.
UNUserNotificationCenter.current().delegate = self
The app delegate should look like this.
import UIKit
import Flutter
@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
UNUserNotificationCenter.current().delegate = self
GeneratedPluginRegistrant.register(with: self)
return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}
}
Rich Notifications #
If you want to include images and videos in your push notifications you will need to create a new target. The link of the media will be sent in the payload of the notifications in the media_url
field. To view the media sent in the notifications follow tihs steps.
1. Create a Notification Service target
In Xcode go to File -> New Target and choose Notification Service Extension.
This will create a class that will intercept all push notification sent to the app, you will be able to change its content from this class.
2. Download the media
In the notification service class use this code to download the media and attach to the push notification.
class NotificationService: UNNotificationServiceExtension {
var contentHandler: ((UNNotificationContent) -> Void)?
var bestAttemptContent: UNMutableNotificationContent?
override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
self.contentHandler = contentHandler
bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
if let bestAttemptContent = bestAttemptContent {
if let mediaUrl = request.content.userInfo["media_url"] as? String, let fileUrl = URL(string: mediaUrl) {
let type = request.content.userInfo["media_type"] as? String
downloadMedia(fileUrl: fileUrl, type: type, request: request, bestAttemptContent: bestAttemptContent) {
contentHandler(bestAttemptContent)
}
} else {
contentHandler(bestAttemptContent)
}
}
}
func downloadMedia(fileUrl: URL, type: String?, request: UNNotificationRequest, bestAttemptContent: UNMutableNotificationContent, completion: @escaping () -> Void) {
let task = URLSession.shared.downloadTask(with: fileUrl) { (location, _, _) in
if let location = location {
let tmpDirectory = NSTemporaryDirectory()
let tmpFile = "file://".appending(tmpDirectory).appending(fileUrl.lastPathComponent)
let tmpUrl = URL(string: tmpFile)!
do {
try FileManager.default.moveItem(at: location, to: tmpUrl)
var options: [String: String]? = nil
if let type = type {
options = [String: String]()
options?[UNNotificationAttachmentOptionsTypeHintKey] = type
}
if let attachment = try? UNNotificationAttachment(identifier: "media." + fileUrl.pathExtension, url: tmpUrl, options: options) {
bestAttemptContent.attachments = [attachment]
}
completion()
} catch {
completion()
}
}
}
task.resume()
}
override func serviceExtensionTimeWillExpire() {
if let contentHandler = contentHandler, let bestAttemptContent = bestAttemptContent {
contentHandler(bestAttemptContent)
}
}
}
Usage #
The first thing you need to do is to set your apiToken
:
MPush.apiToken = 'YOUR_API_TOKEN';
Then you need to configure MPush with the callbacks that will be called when a notifcation arrives or is tapped and the android notification settings.
MPush.configure(
onNotificationArrival: (notification) {
print("Notification arrived: $notification");
},
onNotificationTap: (notification) {
print("Notification tapped: $notification");
},
androidNotificationsSettings: MPAndroidNotificationsSettings(
channelId: 'mpush_example',
channelName: 'MPush Notifications',
channelDescription: 'Push notification channel',
icon: '@mipmap/icon_notif',
),
);
To configure the Android part you need to pass a MPAndroidNotificationsSettings
to the configure sections, it has 2 parameters:
channelId
: the id of the channelchannelName
: the name for the channelchannelDescription
: the description for the channelicon
: the default icon for the notification, in the example application the icon is in the res folder as a mipmap, so it's adressed as@mipmap/icon_notif
, iff the icon is a drawable use@drawable/icon_notif
.
Request a token #
To request a notification token you need to do the following things:
- Set a callback that will be called once the token is received correctly from APNS/FCM
MPush.onToken = (token) {
print("Token retrieved: $token");
}
- Request the token using MPush:
MPush.requestToken();
Register to topics #
Once you have a notification token you can register this device to push notifications and register to topics:
MPush.onToken = (token) async {
print("Token received $token");
await MPush.registerDevice(token).catchError(
(error) => print(error),
);
await MPush.registerToTopic(MPTopic(code: 'Topic')).catchError(
(error) => print(error),
);
print('Registered');
};
The topic are instances of the MPTopic
class which has 3 properties:
code
: the id of the topic- [Optional]
title
: the readable title of the topic that will be displayed in the dashboard, if this is not set it will be equal tocode
. - [Optional]
single
: if this topic represents a single device or a group of devices, by defaultfalse
.
Launch notification #
If the application was launched from a notification you can retrieve the data of the notification like this, this will be null
if the application was launched normally:
Map<String, dynamic>? launchNotification = await MPush.launchNotification();
print(launchNotification);