---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Push-Benachrichtigungen werden in eingerichtet AndroidAnwendung

# Push-Benachrichtigungen werden in eingerichtet AndroidAnwendung {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Zusätzlich zu den Aufgaben, die Sie für ausführen müssen ServiceNow®Instanz um eine Push-Benachrichtigung zu konfigurieren, müssen Sie auch bestimmten Code in Ihrem einschließen AndroidAnwendung.

## Erstellen Sie den NowSDK NowPushService {#mobsdk-and-setup-push-app__section_hyb_zxp_prb}

Eine der ersten Schritte, die in Ihrer Anwendung ausgeführt werden müssen, besteht darin, das Now SDK abzurufen Now PushService . Fügen Sie Code ähnlich dem folgenden Fragment früh in Ihrem Hauptcodetext hinzu.

    /**
     * Helper class used to handle different Now service instances.
     */
    @Singleton
    class SdkManager @Inject constructor() {

        private var nowPushService: NowPushService? = null

        /**
         * Create the NowPushService once in the lifetime of the application inside the Application
         * class or another manager class that will be injected into other classes via dagger/hilt.
         * NowPushService should be created after initializing the NowSDK
         */
        suspend fun getNowPushService(): NowPushService? {
            if (nowPushService != null) return nowPushService

            return NowPushSDK.makePushService(URL("https://instance-name.service-now.com")).getOrThrow()
                .also { this.nowPushService = it }
        }
    }

Für zusätzliche Informationen zu Jetzt PushSDK.makePushService() Methode, siehe [NowPushSDK -- makePushService(instanceURL: URL)](https://servicenow-prod.fluidtopics.net/4KOuUwetgPRz7lxI6O66LQ#NPushSDK-makePushService_S_O_O "Erstellt einen Now Push-Service.").

## Registrieren Sie das Push-Token {#mobsdk-and-setup-push-app__section_kyr_4cq_prb}

Google Firebase Stellt ein eindeutiges Push-Token bereit, das das Gerät und die Anwendung identifiziert, um Push-Benachrichtigungen zu erhalten. Damit eine Anwendung eine Push-Benachrichtigung erhält, müssen Sie dieses Token mit registrieren Now PushService . Fügen Sie eine Funktion hinzu, die dem folgenden Codefragment in Ihrem ähnelt AndroidAnwendung. Stellen Sie sicher, dass Sie sich ändern PushAppNameAn den Namen von AndroidAnwendung. Diese Anwendung muss bei registriert werden ServiceNow®Instanz.

    FirebaseMessaging.getInstance().token.addOnCompleteListener {task ->
      val token = task.result

      if (!task.isSuccessfull || token == null) {
        throw Exception("Unable to fetch token"))
      }

      pushService.registerPushToken(token, "PushAppName", {
          Log.v(TAF, "Successfully registered push token")
      }, { e ->
          Log.e(TAG, "Error registrating push", e)
      })
    }

Für zusätzliche Informationen zu RegisterPushToken() Methode, siehe [NowPushService -- registerPushToken(pushToken: Zeichenfolge, pushApp: Zeichenfolge, succCallback: Ausführbar, errorCallback: Consumer\<Throwable\>)](https://servicenow-prod.fluidtopics.net/3ySqDfwDfEWl~Hwk_oVEEw#NPushServ-registerPushToken_S_S_O_O "Registriert eine eindeutige FirebaseToken mit ServiceNowInstanz, die zum Identifizieren der Push-Benachrichtigungen für die aktuelle Instanz verwendet wird AndroidGerät und angegebene Anwendung.").

## Heben Sie die Registrierung des Push-Tokens auf

Sie müssen die Registrierung des Push-Tokens aufheben, wenn der Anwender Ihre Anwendung verlässt, z. B. wenn sich der Anwender abmeldet. Verwenden Sie Code, der dem folgenden Codefragment ähnelt, um die Registrierung des Push-Tokens aufzuheben. Stellen Sie sicher, dass Sie sich ändern PushAppNameAn den Namen von AndroidAnwendung.

    pushService.unregisterPushToken(token, "PushAppName", {
          Log.v(TAG, "Successfully unregistered push token")
    }, { e ->
          Log.e(TAG, "Error unregistering push", e)
    })

Für zusätzliche Informationen zu UnregisterPushToken() Methode, siehe [NowPushService -- unregisterPushToken(pushToken: Zeichenfolge, pushApp: Zeichenfolge, succCallback: Ausführbar, errorCallback: Consumer\<Throwable\>)](https://servicenow-prod.fluidtopics.net/3ySqDfwDfEWl~Hwk_oVEEw#NPushServ-unregPushToken_S_S_O_O "Hebt die Registrierung des angegebenen auf FirebasePush-Token mit zugehörigem ServiceNowInstanz.").

## Implementieren Sie den FirebaseMessagingService

Sie müssen implementieren `FirebaseMessagingService `In Ihrer Anwendung. Befolgen Sie zum Einrichten und Implementieren dieses Service die Anweisungen in [Android Firebase-Dokumentation](https://firebase.google.com/docs/cloud-messaging/android/receive).

Überschreiben Sie nach dem Setup OnMessageReceived() Methode und übergeben RemoteMessageBis zu `Now PushService `. Wenn `Now PushService `Erkennt die Benachrichtigung, verarbeitet sie und gibt das Benachrichtigungsobjekt zurück, das die Anwendung verarbeiten soll. Derzeit ist die einzige implementierte Benachrichtigung `Now PushVirtualAgent `. Eine unbekannte Benachrichtigung gibt einen zurück `Nicht SupportedPushError `Objekt.

    //Custom coroutineScope created in the Firebase service class
    private val serviceCoroutineScope = CoroutineScope(Dispatchers.IO)

    override fun onMessageReceived(remoteMessage: RemoteMessage) {
      serviceCoroutineScope.launch {
        val result = handleNowPush(remoteMessage)

        if (result.isSuccess) {
          when (val push = result.getOrNull()) {
            is NowPushVirtualAgent -> handleVirtualAgentPush(push)
          }
        } else {
          // Not a NowPush. Handle host app push notification message here
        }
      }
    }

    private suspend fun handleNowPush(remoteMessage: RemoteMessage): Result<NowPushPayload> {
      val nowPushService = sdkManager.getNowPushService()

      return suspendCoroutine { cont ->
        nowPushService?.handlePush(remoteMessage,
          { cont.resume(Result.success(it)) }, { cont.resumeWithException(it) })
      }
    }

Für zusätzliche Informationen zu HandlePush() Methode, siehe [NowPushService -- handlePush(remoteMessage: RemoteMessage, Success Callback: Consumer\<NowPushPayload\>, errorCallback: Consumer\<Throwable\>)](https://servicenow-prod.fluidtopics.net/3ySqDfwDfEWl~Hwk_oVEEw#NPushServ-handlePush_S_O_O "Verarbeitet eine Push-Benachrichtigungsanforderung.").

Außerdem müssen Sie überschreiben OnNewToken(Token: Zeichenfolge) . Stellen Sie sicher, dass Sie das Token an übergeben PushService.registerPushToken() , Ähnlich wie im Abschnitt „Push-Token registrieren".

