Deprecate additional FCM upstream messaging methods. #6411
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
gsakakihara
commented
Oct 24, 2024
gsakakihara
commented
- Also removed references to upstream in documentation.
Javadoc Changes:--- /home/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/messaging/FirebaseMessaging.html 2024-10-24 20:32:38.431339800 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/messaging/FirebaseMessaging.html 2024-10-24 20:30:43.370846537 +0000
@@ -11,7 +11,7 @@
<pre>public class <a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessaging.html">FirebaseMessaging</a></pre>
</p>
<hr>
- <p>Top level <a href="https://firebase.google.com/docs/cloud-messaging/">Firebase Cloud Messaging</a> singleton that provides methods for subscribing to topics and sending upstream messages. </p>
+ <p>Top level <a href="https://firebase.google.com/docs/cloud-messaging/">Firebase Cloud Messaging</a> singleton that provides methods for generating tokens and subscribing to topics. </p>
<p>In order to receive messages, declare an implementation of <code><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html">FirebaseMessagingService</a></code> in the app manifest. To process messages, override base class methods to handle any events required by the application.</p>
<h2>Summary</h2>
<div class="devsite-table-wrapper">
@@ -96,7 +96,7 @@
<td>
<div><code><span><del><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessaging.html#send(com.google.firebase.messaging.RemoteMessage)">send</a></del></span>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/messaging/RemoteMessage.html">RemoteMessage</a> message)</code></div>
<p><strong>This method is deprecated.</strong>
- <p>FCM upstream messaging is deprecated and will be decommissioned in June 2024.</p>
+ <p>FCM upstream messaging is decommissioned.</p>
</p>
</td>
</tr>
@@ -272,7 +272,7 @@
<h3 class="api-name" id="send(com.google.firebase.messaging.RemoteMessage)">send</h3>
<pre class="api-signature no-pretty-print">public void <span><del><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessaging.html#send(com.google.firebase.messaging.RemoteMessage)">send</a></del></span>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/messaging/RemoteMessage.html">RemoteMessage</a> message)</pre>
<aside class="caution"><strong>This method is deprecated.</strong><br>
- <p>FCM upstream messaging is deprecated and will be decommissioned in June 2024. Learn more in the <a href="https://firebase.google.com/support/faq#fcm-23-deprecation">FAQ about FCM features deprecated in June 2023</a>.</p>
+ <p>FCM upstream messaging is decommissioned. Learn more in the <a href="https://firebase.google.com/support/faq#fcm-23-deprecation">FAQ about FCM features deprecated in June 2023</a>.</p>
</aside>
<p>Sends <code>message</code> upstream to your app server. </p>
<p>When there is an active connection the message will be sent immediately, otherwise the message will be queued up to the time to live (TTL) set in the message.</p>--- /home/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/messaging/FirebaseMessagingService.html 2024-10-24 20:32:38.431339800 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/messaging/FirebaseMessagingService.html 2024-10-24 20:30:43.370846537 +0000
@@ -43,7 +43,7 @@
</div>
<hr>
<p>Base class for receiving messages from Firebase Cloud Messaging. </p>
- <p>Extending this class is required to be able to handle downstream messages. It also provides functionality to automatically display notifications, and has methods that are invoked to give the status of upstream messages. </p>
+ <p>Extending this class is required to be able to handle downstream messages. It also provides functionality to automatically display notifications. </p>
<p>Override base class methods to handle any events required by the application. All methods are invoked on a background thread, and <em>may be called when the app is in the background or not open</em>. </p>
<p>Include the following in the manifest: </p>
<pre class="prettyprint"><service
@@ -110,8 +110,10 @@
<tr>
<td><code>void</code></td>
<td>
- <div><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageSent(java.lang.String)">onMessageSent</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a> msgId)</code></div>
- <p>Called when an upstream message has been successfully sent to the GCM connection server.</p>
+ <div><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br><span><del><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageSent(java.lang.String)">onMessageSent</a></del></span>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a> msgId)</code></div>
+ <p><strong>This method is deprecated.</strong>
+ <p>FCM upstream messaging is decommissioned.</p>
+ </p>
</td>
</tr>
<tr>
@@ -124,8 +126,10 @@
<tr>
<td><code>void</code></td>
<td>
- <div><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html#onSendError(java.lang.String,java.lang.Exception)">onSendError</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a> msgId, @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/Exception.html">Exception</a> exception)</code></div>
- <p>Called when there was an error sending an upstream message.</p>
+ <div><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br><span><del><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html#onSendError(java.lang.String,java.lang.Exception)">onSendError</a></del></span>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a> msgId, @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/Exception.html">Exception</a> exception)</code></div>
+ <p><strong>This method is deprecated.</strong>
+ <p>FCM upstream messaging is decommissioned.</p>
+ </p>
</td>
</tr>
</tbody>
@@ -1996,7 +2000,10 @@
</div>
<div class="api-item"><a name="onMessageSent-java.lang.String-"></a><a name="onmessagesent"></a>
<h3 class="api-name" id="onMessageSent(java.lang.String)">onMessageSent</h3>
- <pre class="api-signature no-pretty-print">@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br>public void <a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageSent(java.lang.String)">onMessageSent</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a> msgId)</pre>
+ <pre class="api-signature no-pretty-print">@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br>public void <span><del><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageSent(java.lang.String)">onMessageSent</a></del></span>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a> msgId)</pre>
+ <aside class="caution"><strong>This method is deprecated.</strong><br>
+ <p>FCM upstream messaging is decommissioned. Learn more in the <a href="https://firebase.google.com/support/faq#fcm-23-deprecation">FAQ about FCM features deprecated in June 2023</a>.</p>
+ </aside>
<p>Called when an upstream message has been successfully sent to the GCM connection server.</p>
<div class="devsite-table-wrapper">
<table class="responsive">
@@ -2049,7 +2056,10 @@
</div>
<div class="api-item"><a name="onSendError(java.lang.String, java.lang.Exception)"></a><a name="onSendError-java.lang.String-java.lang.Exception-"></a><a name="onsenderror"></a>
<h3 class="api-name" id="onSendError(java.lang.String,java.lang.Exception)">onSendError</h3>
- <pre class="api-signature no-pretty-print">@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br>public void <a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html#onSendError(java.lang.String,java.lang.Exception)">onSendError</a>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a> msgId, @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/Exception.html">Exception</a> exception)</pre>
+ <pre class="api-signature no-pretty-print">@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br>public void <span><del><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html#onSendError(java.lang.String,java.lang.Exception)">onSendError</a></del></span>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a> msgId, @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="https://developer.android.com/reference/kotlin/java/lang/Exception.html">Exception</a> exception)</pre>
+ <aside class="caution"><strong>This method is deprecated.</strong><br>
+ <p>FCM upstream messaging is decommissioned. Learn more in the <a href="https://firebase.google.com/support/faq#fcm-23-deprecation">FAQ about FCM features deprecated in June 2023</a>.</p>
+ </aside>
<p>Called when there was an error sending an upstream message.</p>
<div class="devsite-table-wrapper">
<table class="responsive">--- /home/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/messaging/RemoteMessage.html 2024-10-24 20:32:38.431339800 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/messaging/RemoteMessage.html 2024-10-24 20:30:43.366846520 +0000
@@ -30,9 +30,8 @@
</div>
<hr>
<p>A remote Firebase Message. </p>
- <p>Messages will be received via <code><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageReceived(com.google.firebase.messaging.RemoteMessage)">onMessageReceived</a></code> and can be sent via <code><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessaging.html#send(com.google.firebase.messaging.RemoteMessage)">send</a></code>. </p>
+ <p>Messages will be received via <code><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageReceived(com.google.firebase.messaging.RemoteMessage)">onMessageReceived</a></code>. </p>
<p>Messages may have a <code><a href="/docs/reference/android/com/google/firebase/messaging/RemoteMessage.Notification.html">Notification</a></code> instance if they are received while the application is in the foreground, otherwise they will be automatically posted to the notification tray. </p>
- <p>Use the <code><a href="/docs/reference/android/com/google/firebase/messaging/RemoteMessage.Builder.html">Builder</a></code> class for building message instances to send via <code><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessaging.html#send(com.google.firebase.messaging.RemoteMessage)">send</a></code>.</p>
<h2>Summary</h2>
<div class="devsite-table-wrapper">
<table class="responsive">
@@ -212,8 +211,10 @@
<tr>
<td><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/Nullable.html">Nullable</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a></code></td>
<td>
- <div><code><a href="/docs/reference/android/com/google/firebase/messaging/RemoteMessage.html#getTo()">getTo</a>()</code></div>
- <p>Gets the message destination.</p>
+ <div><code><span><del><a href="/docs/reference/android/com/google/firebase/messaging/RemoteMessage.html#getTo()">getTo</a></del></span>()</code></div>
+ <p><strong>This method is deprecated.</strong>
+ <p>FCM upstream messaging is decommissioned.</p>
+ </p>
</td>
</tr>
<tr>
@@ -613,12 +614,11 @@
</div>
<div class="api-item"><a name="getTo--"></a><a name="getto"></a>
<h3 class="api-name" id="getTo()">getTo</h3>
- <pre class="api-signature no-pretty-print">public @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/Nullable.html">Nullable</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a> <a href="/docs/reference/android/com/google/firebase/messaging/RemoteMessage.html#getTo()">getTo</a>()</pre>
+ <pre class="api-signature no-pretty-print">public @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/Nullable.html">Nullable</a> <a href="https://developer.android.com/reference/kotlin/java/lang/String.html">String</a> <span><del><a href="/docs/reference/android/com/google/firebase/messaging/RemoteMessage.html#getTo()">getTo</a></del></span>()</pre>
+ <aside class="caution"><strong>This method is deprecated.</strong><br>
+ <p>FCM upstream messaging is decommissioned. Learn more in the <a href="https://firebase.google.com/support/faq#fcm-23-deprecation">FAQ about FCM features deprecated in June 2023</a>.</p>
+ </aside>
<p>Gets the message destination. </p>
- <ul>
- <li>For upstream messages, this will be of the form <code>[email protected]</code>. </li>
- <li>For downstream messages, this will be the Firebase installations ID (FID). </li>
- </ul>
</div>
<div class="api-item"><a name="getTtl--"></a><a name="getttl"></a>
<h3 class="api-name" id="getTtl()">getTtl</h3>--- /home/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/messaging/package-summary.html 2024-10-24 20:32:38.431339800 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/messaging/package-summary.html 2024-10-24 20:30:43.366846520 +0000
@@ -35,7 +35,7 @@
<tr>
<td><code><a href="/docs/reference/android/com/google/firebase/messaging/FirebaseMessaging.html">FirebaseMessaging</a></code></td>
<td>
- <p>Top level <a href="https://firebase.google.com/docs/cloud-messaging/">Firebase Cloud Messaging</a> singleton that provides methods for subscribing to topics and sending upstream messages.</p>
+ <p>Top level <a href="https://firebase.google.com/docs/cloud-messaging/">Firebase Cloud Messaging</a> singleton that provides methods for generating tokens and subscribing to topics.</p>
</td>
</tr>
<tr>--- /home/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/messaging/FirebaseMessaging.html 2024-10-24 20:32:38.431339800 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/messaging/FirebaseMessaging.html 2024-10-24 20:30:43.350846452 +0000
@@ -11,7 +11,7 @@
<pre>class <a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessaging.html">FirebaseMessaging</a></pre>
</p>
<hr>
- <p>Top level <a href="https://firebase.google.com/docs/cloud-messaging/">Firebase Cloud Messaging</a> singleton that provides methods for subscribing to topics and sending upstream messages. </p>
+ <p>Top level <a href="https://firebase.google.com/docs/cloud-messaging/">Firebase Cloud Messaging</a> singleton that provides methods for generating tokens and subscribing to topics. </p>
<p>In order to receive messages, declare an implementation of <code><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html">FirebaseMessagingService</a></code> in the app manifest. To process messages, override base class methods to handle any events required by the application.</p>
<h2>Summary</h2>
<div class="devsite-table-wrapper">
@@ -96,7 +96,7 @@
<td>
<div><code><span><del><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessaging.html#send(com.google.firebase.messaging.RemoteMessage)">send</a></del></span>(message: <a href="/docs/reference/kotlin/com/google/firebase/messaging/RemoteMessage.html">RemoteMessage</a>)</code></div>
<p><strong>This function is deprecated.</strong>
- <p>FCM upstream messaging is deprecated and will be decommissioned in June 2024.</p>
+ <p>FCM upstream messaging is decommissioned.</p>
</p>
</td>
</tr>
@@ -272,7 +272,7 @@
<h3 class="api-name" id="send(com.google.firebase.messaging.RemoteMessage)">send</h3>
<pre class="api-signature no-pretty-print">fun <span><del><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessaging.html#send(com.google.firebase.messaging.RemoteMessage)">send</a></del></span>(message: <a href="/docs/reference/kotlin/com/google/firebase/messaging/RemoteMessage.html">RemoteMessage</a>): <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html">Unit</a></pre>
<aside class="caution"><strong>This function is deprecated.</strong><br>
- <p>FCM upstream messaging is deprecated and will be decommissioned in June 2024. Learn more in the <a href="https://firebase.google.com/support/faq#fcm-23-deprecation">FAQ about FCM features deprecated in June 2023</a>.</p>
+ <p>FCM upstream messaging is decommissioned. Learn more in the <a href="https://firebase.google.com/support/faq#fcm-23-deprecation">FAQ about FCM features deprecated in June 2023</a>.</p>
</aside>
<p>Sends <code>message</code> upstream to your app server. </p>
<p>When there is an active connection the message will be sent immediately, otherwise the message will be queued up to the time to live (TTL) set in the message.</p>--- /home/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html 2024-10-24 20:32:38.431339800 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html 2024-10-24 20:30:43.350846452 +0000
@@ -43,7 +43,7 @@
</div>
<hr>
<p>Base class for receiving messages from Firebase Cloud Messaging. </p>
- <p>Extending this class is required to be able to handle downstream messages. It also provides functionality to automatically display notifications, and has methods that are invoked to give the status of upstream messages. </p>
+ <p>Extending this class is required to be able to handle downstream messages. It also provides functionality to automatically display notifications. </p>
<p>Override base class methods to handle any events required by the application. All methods are invoked on a background thread, and <em>may be called when the app is in the background or not open</em>. </p>
<p>Include the following in the manifest: </p>
<pre class="prettyprint"><service
@@ -110,8 +110,10 @@
<tr>
<td><code><a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html">Unit</a></code></td>
<td>
- <div><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageSent(java.lang.String)">onMessageSent</a>(msgId: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>)</code></div>
- <p>Called when an upstream message has been successfully sent to the GCM connection server.</p>
+ <div><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br><span><del><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageSent(java.lang.String)">onMessageSent</a></del></span>(msgId: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>)</code></div>
+ <p><strong>This function is deprecated.</strong>
+ <p>FCM upstream messaging is decommissioned.</p>
+ </p>
</td>
</tr>
<tr>
@@ -124,8 +126,10 @@
<tr>
<td><code><a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html">Unit</a></code></td>
<td>
- <div><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html#onSendError(java.lang.String,java.lang.Exception)">onSendError</a>(msgId: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>, exception: <a href="https://developer.android.com/reference/kotlin/java/lang/Exception.html">Exception</a>)</code></div>
- <p>Called when there was an error sending an upstream message.</p>
+ <div><code>@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br><span><del><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html#onSendError(java.lang.String,java.lang.Exception)">onSendError</a></del></span>(msgId: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>, exception: <a href="https://developer.android.com/reference/kotlin/java/lang/Exception.html">Exception</a>)</code></div>
+ <p><strong>This function is deprecated.</strong>
+ <p>FCM upstream messaging is decommissioned.</p>
+ </p>
</td>
</tr>
</tbody>
@@ -1996,7 +2000,10 @@
</div>
<div class="api-item"><a name="onMessageSent-java.lang.String-"></a><a name="onmessagesent"></a>
<h3 class="api-name" id="onMessageSent(java.lang.String)">onMessageSent</h3>
- <pre class="api-signature no-pretty-print">@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br>fun <a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageSent(java.lang.String)">onMessageSent</a>(msgId: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>): <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html">Unit</a></pre>
+ <pre class="api-signature no-pretty-print">@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br>fun <span><del><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageSent(java.lang.String)">onMessageSent</a></del></span>(msgId: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>): <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html">Unit</a></pre>
+ <aside class="caution"><strong>This function is deprecated.</strong><br>
+ <p>FCM upstream messaging is decommissioned. Learn more in the <a href="https://firebase.google.com/support/faq#fcm-23-deprecation">FAQ about FCM features deprecated in June 2023</a>.</p>
+ </aside>
<p>Called when an upstream message has been successfully sent to the GCM connection server.</p>
<div class="devsite-table-wrapper">
<table class="responsive">
@@ -2049,7 +2056,10 @@
</div>
<div class="api-item"><a name="onSendError(java.lang.String, java.lang.Exception)"></a><a name="onSendError-java.lang.String-java.lang.Exception-"></a><a name="onsenderror"></a>
<h3 class="api-name" id="onSendError(java.lang.String,java.lang.Exception)">onSendError</h3>
- <pre class="api-signature no-pretty-print">@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br>fun <a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html#onSendError(java.lang.String,java.lang.Exception)">onSendError</a>(msgId: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>, exception: <a href="https://developer.android.com/reference/kotlin/java/lang/Exception.html">Exception</a>): <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html">Unit</a></pre>
+ <pre class="api-signature no-pretty-print">@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/WorkerThread.html">WorkerThread</a><br>fun <span><del><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html#onSendError(java.lang.String,java.lang.Exception)">onSendError</a></del></span>(msgId: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>, exception: <a href="https://developer.android.com/reference/kotlin/java/lang/Exception.html">Exception</a>): <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html">Unit</a></pre>
+ <aside class="caution"><strong>This function is deprecated.</strong><br>
+ <p>FCM upstream messaging is decommissioned. Learn more in the <a href="https://firebase.google.com/support/faq#fcm-23-deprecation">FAQ about FCM features deprecated in June 2023</a>.</p>
+ </aside>
<p>Called when there was an error sending an upstream message.</p>
<div class="devsite-table-wrapper">
<table class="responsive">--- /home/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/messaging/RemoteMessage.html 2024-10-24 20:32:38.419339749 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/messaging/RemoteMessage.html 2024-10-24 20:30:43.350846452 +0000
@@ -30,9 +30,8 @@
</div>
<hr>
<p>A remote Firebase Message. </p>
- <p>Messages will be received via <code><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageReceived(com.google.firebase.messaging.RemoteMessage)">onMessageReceived</a></code> and can be sent via <code><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessaging.html#send(com.google.firebase.messaging.RemoteMessage)">send</a></code>. </p>
+ <p>Messages will be received via <code><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessagingService.html#onMessageReceived(com.google.firebase.messaging.RemoteMessage)">onMessageReceived</a></code>. </p>
<p>Messages may have a <code><a href="/docs/reference/kotlin/com/google/firebase/messaging/RemoteMessage.Notification.html">Notification</a></code> instance if they are received while the application is in the foreground, otherwise they will be automatically posted to the notification tray. </p>
- <p>Use the <code><a href="/docs/reference/kotlin/com/google/firebase/messaging/RemoteMessage.Builder.html">Builder</a></code> class for building message instances to send via <code><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessaging.html#send(com.google.firebase.messaging.RemoteMessage)">send</a></code>.</p>
<h2>Summary</h2>
<div class="devsite-table-wrapper">
<table class="responsive">
@@ -171,8 +170,10 @@
<tr>
<td><code><a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>?</code></td>
<td>
- <div><code><a href="/docs/reference/kotlin/com/google/firebase/messaging/RemoteMessage.html#getTo()">getTo</a>()</code></div>
- <p>Gets the message destination.</p>
+ <div><code><span><del><a href="/docs/reference/kotlin/com/google/firebase/messaging/RemoteMessage.html#getTo()">getTo</a></del></span>()</code></div>
+ <p><strong>This function is deprecated.</strong>
+ <p>FCM upstream messaging is decommissioned.</p>
+ </p>
</td>
</tr>
<tr>
@@ -535,12 +536,11 @@
</div>
<div class="api-item"><a name="getTo--"></a><a name="getto"></a>
<h3 class="api-name" id="getTo()">getTo</h3>
- <pre class="api-signature no-pretty-print">fun <a href="/docs/reference/kotlin/com/google/firebase/messaging/RemoteMessage.html#getTo()">getTo</a>(): <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>?</pre>
+ <pre class="api-signature no-pretty-print">fun <span><del><a href="/docs/reference/kotlin/com/google/firebase/messaging/RemoteMessage.html#getTo()">getTo</a></del></span>(): <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>?</pre>
+ <aside class="caution"><strong>This function is deprecated.</strong><br>
+ <p>FCM upstream messaging is decommissioned. Learn more in the <a href="https://firebase.google.com/support/faq#fcm-23-deprecation">FAQ about FCM features deprecated in June 2023</a>.</p>
+ </aside>
<p>Gets the message destination. </p>
- <ul>
- <li>For upstream messages, this will be of the form <code>[email protected]</code>. </li>
- <li>For downstream messages, this will be the Firebase installations ID (FID). </li>
- </ul>
</div>
<div class="api-item"><a name="getTtl--"></a><a name="getttl"></a>
<h3 class="api-name" id="getTtl()">getTtl</h3>--- /home/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/messaging/package-summary.html 2024-10-24 20:32:38.431339800 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/messaging/package-summary.html 2024-10-24 20:30:43.350846452 +0000
@@ -18,7 +18,7 @@
<tr>
<td><code><a href="/docs/reference/kotlin/com/google/firebase/messaging/FirebaseMessaging.html">FirebaseMessaging</a></code></td>
<td>
- <p>Top level <a href="https://firebase.google.com/docs/cloud-messaging/">Firebase Cloud Messaging</a> singleton that provides methods for subscribing to topics and sending upstream messages.</p>
+ <p>Top level <a href="https://firebase.google.com/docs/cloud-messaging/">Firebase Cloud Messaging</a> singleton that provides methods for generating tokens and subscribing to topics.</p>
</td>
</tr>
<tr> |
Vertex AI Mock Responses Check
|
Test Results 64 files - 958 64 suites - 958 6m 15s ⏱️ - 30m 23s Results for commit dd2b033. ± Comparison against base commit 0697dd3. This pull request removes 5322 tests.♻️ This comment has been updated with latest results. |
Doris-Ge
approved these changes
Oct 24, 2024
* Also removed references to upstream in documentation.
gsakakihara
force-pushed
the
gsakakihara/deprecate_upstream
branch
from
28e0c7a
to
dd2b033
Compare
welishr
reviewed
Nov 1, 2024
firebase-messaging/src/main/java/com/google/firebase/messaging/RemoteMessage.java
Show resolved
Hide resolved
welishr
approved these changes
Nov 1, 2024
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.