更新於 2022/11/10閱讀時間約 13 分鐘

APP誕生全紀錄 - 容易忽略的必要功能1:推播

一個APP在規劃的時候可能覺得主要功能就只有這一兩個,實作起來應該不難,卻忘了現代人的胃口已經越養越大,很多不在你預期內但對於使用者來說卻是很基本的功能;另一種是商店上架或是第三方要求的必要功能
如果你還沒有閱讀過「APP誕生全紀錄」,建議可以先看一下,至少知道哪些可能是容易忽略的必要功能,今天這篇文章內容會比較偏向技術層面,我們先來探討其中重要的一項:推播〔Push Notification〕

簡介

推播示意 - 聖經種子
推播現在已經是手機中不可或缺的一個功能,無論是用來接收新的通知或是提醒,甚至是開發者想要對使用者傳遞的任何即時消息,都可以使用推播,這是個提升APP存在感並且增加留存率的實用工具。如果你今天開發出一款APP,在某些使用情境下,使用者直覺認為應該要收到提醒推播,但實際卻沒有任何通知跳出的話,那對於APP的留存率可是一大硬傷。今天我們就來介紹一下這個舉足輕重的功能,在Android中叫FCM,在iOS裡叫APNs,這兩個都是遠端推播,另外有一種是本地推播 (補充在最後),以上所有項目在本文章內都統稱推播。

設定

我們來使用Flutter + Firebase Cloud Messaging (FCM)實作看看,如果你還沒設定過Firebase,可以上網找一下相關資訊,有許多初始設定和使用介紹的文章可以參考,我們這裡就不再多加贅述,只針對推播這個功能來做說明。

Android
在AndroidManifest.xml中加入service描述(如果使用的Flutter Version = 1.12可以不用設定這一部分)
<service
  android:name=".java.MyFirebaseMessagingService"
  android:exported="false">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT" />
  </intent-filter>
</service>
(Optional) 可選擇自訂的icon和顏色
<meta-data
  android:name="com.google.firebase.messaging.default_notification_icon"
  android:resource="@drawable/ic_stat_ic_notification" />

<meta-data
  android:name="com.google.firebase.messaging.default_notification_color"
  android:resource="@color/colorAccent" />

iOS
因為我們使用的套件統一接口都在FCM中,所以我們必須將你的 APNs 身份驗證密鑰上傳到 Firebase作串接。如果你還沒有 APNs 身份驗證密鑰,趕快去Apple Developer Member Center中啟動Push Notification功能並創建一個密鑰吧。
  1. 在 Firebase 控制台的項目中,選擇齒輪圖標,選擇Project Settings ,然後選擇Cloud Messaging選項卡。
  2. iOS app configuration下的APNs authentication key中,單擊Upload按鈕。
  3. 瀏覽到您保存密鑰的位置,選擇它,然後單擊打開。添加密鑰的密鑰 ID,然後單擊Upload 。。
  4. 在XCode中勾選Push Notification背景監聽
背景模式下獲取推播設定
開啟推播主要設定

安裝套件

在Flutter專案的pubspec.yaml中加入
dependencies:
  firebase_messaging: ^12.0.2

取得TOKEN

首先在啟動時我們需要先要求權限,並且儲存一下設備的Token,可以把這個token想成是使用者設備的地址,之後後台發送推播就是使用這組地址來發送指定的推播。
class PushNotification {
  init() async {
    //要求權限
    NotificationSettings settings = 
    await messaging.requestPermission(
     alert: true,
     announcement: false,
     badge: true,
     carPlay: false,
     criticalAlert: false,
     provisional: false,
     sound: true,
    );
    if (settings.authorizationStatus == AuthorizationStatus.authorized ||
       settings.authorizationStatus == AuthorizationStatus.provisional) {
       //如果權限有被使用者允許,拿一下Token地址吧!
       messaging.getToken().then((value) => _token = value);
    }
  }
}

推播監聽

接下來我們要在啟動時加入各種情境的監聽函式,總共有四種情境要處理。
  1. 程式在前景模式運作中
  2. 程式在背景模式
  3. 程式在背景模式點擊推播打開後
  4. 程式被關閉的狀態點擊推播打開後
// 背景模式收到推播後的處理函式註冊
// 這裡要注意的是此callback必須是個top-level的static function
FirebaseMessaging.onBackgroundMessage(messageOnBackground);

// 關閉的狀態點擊推播打開後的處理函式註冊
messaging
   .getInitialMessage()
   .then((message) => messageOpenedOnTerminated(message));

// 前景模式收到推播後的處理函式註冊
FirebaseMessaging.onMessage
   
.listen((message) => messageOnForeground(message));

// 背景模式中使用者點擊推播後的處理函式註冊 
FirebaseMessaging.onMessageOpenedApp
   
.listen((message) => messageOpenedOnBackground(message));
註冊的callback函式都會傳入一個結構體RemoteMessage,這個就是推播的結構體,我們通常最主要處理的會有title、body、和data。title會是推播顯示中的主標題,body會是推播顯示中的描述文字,而data就會是設計者想要傳遞給使用端的自訂結構。
就是這麼簡單!
最後你只要把收到推播資料的處理寫在對應的callback內就可以囉!
這裡要注意一下前景模式收到推播時,不會再另外跳出預設的通知訊息視窗,如果你想要跟背景模式下收到時一樣會跳出推播的提示視窗,必須另外使用Local Notification來發佈自訂的通知。

進階本地通知

補充說明一下本地通知,在兩種情況下會需要用到。一種是前面提到過的,當收到遠端推播資料時,APP正在前景模式的狀況下,不會跳出推播視窗;另一種是APP內觸發的推播,例如定時鬧鐘。
我們使用flutter_local_notifications這個套件來實作,Android使用前需要先設定一個channel id供套件使用。
<meta-data
   android:name="com.google.firebase.messaging.default_notification_channel_id"
   android:value="bible_seed_channel" />
要使用前初始化一下
final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin =
   FlutterLocalNotificationsPlugin();

final AndroidNotificationChannel channel = AndroidNotificationChannel(
  'bible_seed_channel', // id
  'BibleSeed Notifications', // title
  description: 'This channel is used for important notifications.', // description
  importance: Importance.max,
);

final InitializationSettings initializationSettings =
   InitializationSettings(
  android: AndroidInitializationSettings("@mipmap/ic_launcher"),
  iOS: IOSInitializationSettings(),
);

await flutterLocalNotificationsPlugin.initialize(initializationSettings);
await flutterLocalNotificationsPlugin
   .resolvePlatformSpecificImplementation<
       AndroidFlutterLocalNotificationsPlugin>()
   ?.createNotificationChannel(channel);

//iOS前景顯示選項設定
await FirebaseMessaging.instance
   
.setForegroundNotificationPresentationOptions(
  alert: true,
  badge: true,
  sound: true,
);
需要推播時呼叫流程如下
final NotificationDetails notificationDetails = NotificationDetails(
  android: AndroidNotificationDetails(
    'bible_seed_channel', // id
    'High Importance Notifications', // name
    channelDescription: 'This channel is used for BibleSeed important notifications.',
    importance: Importance.max,
    priority: Priority.high,
    icon: '@mipmap/ic_launcher',
  ),
  iOS: IOSNotificationDetails(),
);

final id = DateTime.now().millisecondsSinceEpoch ~/ 1000;
flutterLocalNotificationsPlugin.show(id, title,
   body, notificationDetails);
在這個套件中,還可以設定各種定時的推播,詳細內容就請參閱相關文件囉。

結論

今天我們先介紹了第一種容易被忽略卻非常必要的一個APP功能,不知道你看完後是不是想要立馬加上這功能了呢?!期待後續有機會繼續介紹其他的重要功能,趕緊訂閱一下,不要錯過任何一篇精彩文章囉!!
分享至
成為作者繼續創作的動力吧!
© 2024 vocus All rights reserved.