Freigeben über


Migrieren von Android SDK-Pushbenachrichtigungen zu Firebase Cloud Messaging HTTP v1

Dieser Artikel gilt für Telefonie- und Chatanwendungen, die das Android SDK mit FCM-Pushbenachrichtigungen (Firebase Cloud Messaging) verwenden. FCM wurde früher als Google Cloud Messaging (GCM/FCM) bezeichnet.

Am 20. Juni 2023 wurde von Google bekannt gegeben, dass das Senden von Nachrichten mit den Legacy-FCM-APIs eingestellt wurde. Google entfernt die Legacyimplementierung von FCM im Juni 2024 aus dem Dienst. Google empfiehlt die Migration von Legacy-FCM-APIs zu FCM HTTP v1.

Wenn Sie über eine neue Android-Anwendung verfügen oder nie Google FCM verwendet haben, lesen Sie den Artikel Registrieren für Pushbenachrichtigungen des Android SDK mithilfe von FCM v1.

Wenn Ihre Android-Anwendung die Pushbenachrichtigungsfunktion verwendet, führen Sie die folgenden Schritte aus, um Ihre Pushbenachrichtigung zu FCM HTTP v1 zu migrieren.

1. Generieren eines privaten Schlüssels in der Firebase-Konsole

  1. Öffnen Sie Ihr Projekt in der Firebase-Konsole.

  2. Öffnen Sie Project settings>Service accounts.

  3. Wählen Sie eine beliebige Programmiersprache aus.

  4. Klicken Sie auf Generate new private key, um eine JSON-Datei mit Ihrem neuen privaten Schlüssel herunterzuladen.

    Screenshot: Generieren eines neuen privaten Schlüssels für FMC v1 in der Firebase-Konsole

  5. Öffnen Sie die heruntergeladene JSON-Datei. Sie benötigen Werte aus dieser Datei für den nächsten Schritt.

2. Angeben der Anmeldeinformationen des privaten Schlüssels für Google (FCM v1)

  1. Öffnen Sie Ihre Notification Hub-Instanz von Azure Communication Services im Azure-Portal.

  2. Öffnen Sie Einstellungen>Google (FCM v1).

  3. Geben Sie die Werte aus der heruntergeladenen JSON-Datei in die Textfelder Privater Schlüssel, Client-E-Mail-Adresse und Projekt-ID ein.

    Screenshot: Angeben der neuen Anmeldeinformationen des privaten Schlüssels für FCM v1 in den Einstellungen im Azure-Portal

  4. Klicken Sie auf Speichern.

3. Entfernen der Legacyanmeldeinformationen für Google (GCM/FCM)

  1. Öffnen Sie Ihre Notification Hub-Instanz von Azure Communication Services im Azure-Portal.

  2. Öffnen Sie Einstellungen>Google (GCM/FCM).

  3. Deaktivieren Sie das Textfeld API-Schlüssel.

    Screenshot: Entfernen von Legacyanmeldeinformationen für GCM/FCM in den Einstellungen im Azure-Portal

  4. Klicken Sie auf Speichern.

4. Sicherstellen, dass die Anwendung Pushbenachrichtigungen empfängt

  1. Warten Sie einige Minuten, damit die Änderungen, die Sie für Notification Hub vorgenommen haben, wirksam werden können. Während dieser Zeit kann es in Ihrer Anwendung zu doppelten oder verpassten Pushbenachrichtigungen kommen.

  2. Stellen Sie sicher, dass Ihre Anwendung Pushbenachrichtigungen fehlerfrei empfängt.

Problembehandlung

Sollte Ihre Anwendung keine Pushbenachrichtigungen empfangen, vergewissern Sie sich, dass Ihre neuen FCM v1-Anmeldeinformationen korrekt sind. Wiederholen Sie die Schritte in diesem Dokument nach Bedarf, um einen privaten Schlüssel in der Firebase-Konsole zu generieren oder die Anmeldeinformationen des privaten Schlüssels für Google (FCM v1) anzugeben.

Sollte Ihre Anwendung weiterhin keine Pushbenachrichtigungen empfangen, wenden Sie sich unter Hilfe und Support an Azure Communication Services.

Aktivieren von Pushbenachrichtigungen in Ihrer Android-Chat-AppAktivieren von Pushbenachrichtigungen für Anrufe