docs(messaging, android): update inline documentation on behavior

firebase · Jun 12, 2024 · 58767ab · 58767ab
1 parent e298cb4
commit 58767ab
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 0 deletions.
diff --git a/packages/firebase_messaging/firebase_messaging/lib/src/messaging.dart b/packages/firebase_messaging/firebase_messaging/lib/src/messaging.dart
@@ -87,6 +87,9 @@ class FirebaseMessaging extends FirebasePluginPlatform {
   /// This should be used to determine whether specific notification interaction
   /// should open the app with a specific purpose (e.g. opening a chat message,
   /// specific screen etc).
+  /// 
+  /// on Android, if the message was received in the foreground, and the notification was 
+  /// pressed whilst the app is in a background/terminated state, this will return `null`.
   Future<RemoteMessage?> getInitialMessage() {
     return _delegate.getInitialMessage();
   }

diff --git a/...messaging_platform_interface/lib/src/platform_interface/platform_interface_messaging.dart b/...messaging_platform_interface/lib/src/platform_interface/platform_interface_messaging.dart
@@ -141,6 +141,9 @@ abstract class FirebaseMessagingPlatform extends PlatformInterface {
   /// This should be used to determine whether specific notification interaction
   /// should open the app with a specific purpose (e.g. opening a chat message,
   /// specific screen etc).
+  /// 
+  /// on Android, if the message was received in the foreground, and the notification was 
+  /// pressed whilst the app is in a background/terminated state, this will return `null`.
   Future<RemoteMessage?> getInitialMessage() {
     throw UnimplementedError('getInitialMessage() is not implemented');
   }