fix(fcm-guide): move PushNotificationService to Handle push notifications sub-step

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: maratal

src/pages/docs/push/getting-started/fcm.mdx

@@ -163,91 +163,7 @@ Register your `Application` class in `AndroidManifest.xml` inside the `<applicat
 
 ## Step 2: Set up push notifications <a id="step-2"/>
 
-To receive push notifications on Android, you need to integrate with FCM. Create a `PushNotificationService.kt` file that extends `FirebaseMessagingService`. This service handles new FCM tokens and incoming push messages:
-
-<Code>
-```kotlin
-import android.app.NotificationChannel
-import android.app.NotificationManager
-import android.os.Build
-import android.util.Log
-import androidx.core.app.NotificationCompat
-import com.google.firebase.messaging.FirebaseMessagingService
-import com.google.firebase.messaging.RemoteMessage
-import io.ably.lib.types.RegistrationToken
-
-class PushNotificationService : FirebaseMessagingService() {
-
-    companion object {
-        private const val TAG = "PushService"
-        private const val CHANNEL_ID = "push_tutorial_channel"
-    }
-
-    override fun onNewToken(token: String) {
-        super.onNewToken(token)
-        Log.d(TAG, "New FCM token received")
-        try {
-            // Update the FCM token on Ably server
-            AblyHelper.getInstance().push.getActivationContext().onNewRegistrationToken(RegistrationToken.Type.FCM, token)
-        } catch (e: Exception) {
-            Log.e(TAG, "Error updating FCM token with Ably", e)
-        }
-    }
-
-    override fun onMessageReceived(remoteMessage: RemoteMessage) {
-        super.onMessageReceived(remoteMessage)
-        Log.d(TAG, "Message received from: ${remoteMessage.from}")
-
-        // Display a notification when the app is in the foreground
-        remoteMessage.notification?.let { notification ->
-            showNotification(
-                notification.title ?: "Push Notification",
-                notification.body ?: "",
-                remoteMessage.data
-            )
-        }
-    }
-
-    private fun showNotification(title: String, body: String, data: Map<String, String>) {
-        val notificationManager = getSystemService(NOTIFICATION_SERVICE) as NotificationManager
-
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-            val channel = NotificationChannel(
-                CHANNEL_ID,
-                "Push Tutorial",
-                NotificationManager.IMPORTANCE_DEFAULT
-            )
-            notificationManager.createNotificationChannel(channel)
-        }
-
-        val notification = NotificationCompat.Builder(this, CHANNEL_ID)
-            .setSmallIcon(android.R.drawable.ic_dialog_info)
-            .setContentTitle(title)
-            .setContentText(body)
-            .setAutoCancel(true)
-            .build()
-
-        notificationManager.notify(System.currentTimeMillis().toInt(), notification)
-    }
-}
-```
-</Code>
-
-Register the service in `AndroidManifest.xml` inside the `<application>` element:
-
-<Code>
-```xml
-<service
-    android:name=".PushNotificationService"
-    android:exported="false">
-    <intent-filter>
-        <action android:name="com.google.firebase.MESSAGING_EVENT" />
-    </intent-filter>
-</service>
-```
-</Code>
-
-Now add push activation and deactivation to your `MainActivity.kt`. The Ably Android SDK activates push asynchronously and the result arrives via Android's broadcast system, so register a `BroadcastReceiver` to handle it (the following imports cover all steps in this guide):
+Add push activation and deactivation to your `MainActivity.kt`. The Ably Android SDK activates push asynchronously and the result arrives via Android's broadcast system, so register a `BroadcastReceiver` to handle it (the following imports cover all steps in this guide):
 
 <Code>
 ```kotlin
@@ -345,7 +261,91 @@ Your app is now configured to receive push notifications once activated.
 
 ### Handle push notifications <a id="step-2-handle"/>
 
-Push notifications delivered while your app is in the background are handled automatically by the FCM SDK and displayed as system notifications. For foreground handling, your `PushNotificationService.onMessageReceived()` method (from above) displays a notification via `NotificationManager`.
+Create a `PushNotificationService.kt` file that extends `FirebaseMessagingService`. This service handles new FCM tokens and incoming push messages:
+
+<Code>
+```kotlin
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.os.Build
+import android.util.Log
+import androidx.core.app.NotificationCompat
+import com.google.firebase.messaging.FirebaseMessagingService
+import com.google.firebase.messaging.RemoteMessage
+import io.ably.lib.types.RegistrationToken
+
+class PushNotificationService : FirebaseMessagingService() {
+
+    companion object {
+        private const val TAG = "PushService"
+        private const val CHANNEL_ID = "push_tutorial_channel"
+    }
+
+    override fun onNewToken(token: String) {
+        super.onNewToken(token)
+        Log.d(TAG, "New FCM token received")
+        try {
+            // Update the FCM token on Ably server
+            AblyHelper.getInstance().push.getActivationContext().onNewRegistrationToken(RegistrationToken.Type.FCM, token)
+        } catch (e: Exception) {
+            Log.e(TAG, "Error updating FCM token with Ably", e)
+        }
+    }
+
+    override fun onMessageReceived(remoteMessage: RemoteMessage) {
+        super.onMessageReceived(remoteMessage)
+        Log.d(TAG, "Message received from: ${remoteMessage.from}")
+
+        // Display a notification when the app is in the foreground
+        remoteMessage.notification?.let { notification ->
+            showNotification(
+                notification.title ?: "Push Notification",
+                notification.body ?: "",
+                remoteMessage.data
+            )
+        }
+    }
+
+    private fun showNotification(title: String, body: String, data: Map<String, String>) {
+        val notificationManager = getSystemService(NOTIFICATION_SERVICE) as NotificationManager
+
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            val channel = NotificationChannel(
+                CHANNEL_ID,
+                "Push Tutorial",
+                NotificationManager.IMPORTANCE_DEFAULT
+            )
+            notificationManager.createNotificationChannel(channel)
+        }
+
+        val notification = NotificationCompat.Builder(this, CHANNEL_ID)
+            .setSmallIcon(android.R.drawable.ic_dialog_info)
+            .setContentTitle(title)
+            .setContentText(body)
+            .setAutoCancel(true)
+            .build()
+
+        notificationManager.notify(System.currentTimeMillis().toInt(), notification)
+    }
+}
+```
+</Code>
+
+Register the service in `AndroidManifest.xml` inside the `<application>` element:
+
+<Code>
+```xml
+<service
+    android:name=".PushNotificationService"
+    android:exported="false">
+    <intent-filter>
+        <action android:name="com.google.firebase.MESSAGING_EVENT" />
+    </intent-filter>
+</service>
+```
+</Code>
+
+Push notifications delivered while your app is in the background are handled automatically by the FCM SDK and displayed as system notifications. The `onMessageReceived()` method handles foreground notifications via `NotificationManager`.
 
 ## Step 3: Subscribe to channel push notifications <a id="step-3"/>