Google Cloud Messaging Firebase Cloud Messaging (FCM) ist die neue Version von GCM. Es erbt die zuverlässige und skalierbare GCM-Infrastruktur sowie neue Funktionen. Wenn Sie Messaging in eine neue App integrieren, starten Sie mit FCM. GCM-Benutzer werden dringend empfohlen, auf FCM zu aktualisieren, um von neuen FCM-Funktionen heute und in Zukunft profitieren zu können. Aktivieren Sie Ihre Benutzer über Android, iOS und Chrome Senden Sie Daten von Ihrem Server an Ihre Benutzergeräte und empfangen Sie Nachrichten von Geräten auf derselben Verbindung. Der GCM-Dienst behandelt alle Aspekte der Warteschlangen von Nachrichten und der Zustellung an Clientanwendungen, die auf Zielgeräten ausgeführt werden, und ist vollständig kostenlos. Vielseitige Messaging-Ziele Verteilen Sie Nachrichten an Ihre Client-App auf drei Arten, die auf einzelne Geräte, auf Gruppen von Geräten oder auf Geräte, die Themen abonniert sind, übertragen werden. Downstream Messaging Für Zwecke wie das Warnen von Benutzern, Chat-Messaging oder das Starten der Hintergrundverarbeitung, bevor der Benutzer die Client-App öffnet, stellt GCM eine zuverlässige und batterieeffiziente Verbindung zwischen Ihrem Server und Geräten her. Upstream Messaging Senden von Bestätigungen, Chats und anderen Meldungen von Geräten zurück zu Ihrem Server über GCMs zuverlässigen und batterieeffizienten Verbindungskanal. Senden von Nachrichten aus der Cloud Senden Sie eine Nachricht mit dem GCM HTTP-Verbindungsserverprotokoll: Behandeln Sie eine nachgeschaltete Nachricht auf einem Android-Gerät: Überprüfen Sie GCM-Videos auf YouTube Entdecken Sie unsere Beispielanwendungen oder forcieren Sie sie, um eigene Fragen zu stellen Fragen Sie mit dem Google-Cloud-Messaging TagFirebase Cloud Messaging (FCM) ist die neue Version von GCM. Es erbt die zuverlässige und skalierbare GCM-Infrastruktur sowie neue Funktionen. Wenn Sie Messaging in eine neue App integrieren, starten Sie mit FCM. GCM-Benutzer werden dringend empfohlen, auf FCM zu aktualisieren, um von neuen FCM-Funktionen heute und in Zukunft profitieren zu können. GCM-Client-App auf Android Ein Google Cloud Messaging (GCM) Android-Client ist eine Client-App, die auf einem Android-Gerät ausgeführt wird. Um Ihren Client-Code zu schreiben, empfehlen wir Ihnen, die GoogleCloudMessaging API und das Android Studio mit Gradle zu verwenden. Hier sind die Voraussetzungen für das Ausführen eines GCM-Android-Clients: GCM erfordert Geräte mit Android 2.2 oder höher, auf denen auch die Google Play Store-Anwendung installiert ist, oder ein Emulator mit Android 2.2 mit Google-APIs. Beachten Sie, dass Sie nicht auf die Bereitstellung Ihrer Android-Anwendungen über Google Play Store beschränkt sind. Wenn Sie jedoch weiterhin neue GCM-Funktionen verwenden möchten, die über Google Play Services verteilt werden, muss das Gerät Android 2.3 oder höher verwenden, oder Sie können einen Emulator mit Android 2.3 mit Google-APIs verwenden. Auf Android-Geräten verwendet GCM eine bestehende Verbindung für Google-Dienste. Für Pre-3.0-Geräte müssen Benutzer ihre Google-Konten auf ihren mobilen Geräten einrichten. Ein Google-Konto ist keine Voraussetzung für Geräte mit Android 4.0.4 oder höher. Eine vollständige GCM-Implementierung erfordert sowohl eine Clientimplementierung als auch eine Serverimplementierung. Weitere Informationen zur Implementierung der Serverseite finden Sie unter Über GCM Connection Server. In den folgenden Abschnitten werden Sie durch die Schritte zum Schreiben einer GCM-Client-seitigen Anwendung auf Android geleitet. Mindestens muss eine GCM-Client-App Code enthalten, der registriert werden soll (und damit ein Registrierungs-Token erhält) und einen Empfänger, der von GCM gesendete Nachrichten empfängt. Für bestehende Apps, die einen WakefulBroadcastReceiver erweitern. Google empfiehlt die Migration zu GCMReceiver und GcmListenerService. So migrieren Sie: Ersetzen Sie im App-Manifest Ihren GcmBroadcastReceiver durch com. google. android. gms. gcm. GcmReceiver und ersetzen Sie die aktuelle Service-Deklaration, die IntentService auf den neuen GcmListenerService erweitert. Entfernen Sie die BroadcastReceiver-Implementierung aus Ihrem Client-Code Refactor den aktuellen IntentService-Dienst Implementierung für die Verwendung von GcmListenerService Weitere Informationen finden Sie in den Beispielmanifest - und Codebeispielen auf dieser Seite. Erstellen eines API-Projekts Neue Cloud Messaging-Projekte müssen ein Firebase-Projekt in der Firebase-Konsole erstellen. In diesem Prozess, youll generieren eine Konfigurationsdatei und Anmeldeinformationen für Ihr Projekt. Erstellen Sie ein Firebase-Projekt in der Firebase-Konsole. Wenn Sie nicht bereits ein haben. Wenn Sie bereits ein Google-Projekt mit Ihrer mobilen App verknüpft haben, klicken Sie auf Google Project importieren. Klicken Sie andernfalls auf Neues Projekt erstellen. Klicken Sie auf Firebase zu Ihrer Android-App hinzufügen und folgen Sie den Installationsschritten. Wenn Sie ein bestehendes Google-Projekt importieren, kann dies automatisch geschehen und Sie können die Konfigurationsdatei einfach herunterladen. Wenn Sie dazu aufgefordert werden, geben Sie Ihren App-Paketnamen ein. Es ist wichtig, geben Sie den Paketnamen Ihrer App ist mit diesem kann nur festgelegt werden, wenn Sie eine App zu Ihrem Firebase-Projekt hinzufügen. Am Ende, youll laden Sie eine Google-services. json-Datei. Sie können diese Datei jederzeit wieder herunterladen. Wenn Sie das noch nicht getan haben, kopieren Sie es in Ihren Projektmodulordner, in der Regel App. Notieren Sie den Server-Schlüssel in Ihrem neuen Projekt unter Projekteinstellungen Cloud Messaging. Bewahren Sie diese Taste sicher auf Ihrem App-Server. Youll benötigt es, um nachgeschaltete Nachrichten an die Client-App zu senden. Add die Konfigurationsdatei zu Ihrem Projekt Das Google Services-Plugin für Gradle analysiert Konfigurationsinformationen aus der Datei "google-services. json". Fügen Sie das Plugin zu Ihrem Projekt hinzu, indem Sie die Build. gradle-Dateien auf der obersten Ebene und die build. gradle-Dateien auf der App-Ebene wie folgt aktualisieren: Fügen Sie die Abhängigkeit auf die build. gradle-Ebene auf Projektebene hinzu. Fügen Sie das Plugin zu Ihrem build. gradle auf App-Ebene hinzu. Google Play-Dienste einrichten Verwenden Sie die GoogleCloudMessaging-API, um Ihre Clientanwendung zu schreiben. Um dieses API zu verwenden, müssen Sie Ihr Projekt so einrichten, dass es das Google Play-SDK verwendet, wie im Google Play-Dienste-SDK einrichten beschrieben. Wenn Sie die GCM Play Services-Bibliothek zu Ihrem Projekt hinzufügen, müssen Sie sie mit Ressourcen hinzufügen. Wie im Einrichten des Google Play Services SDK beschrieben. Der wichtigste Punkt ist, dass Sie die Bibliothekmdashsimply das Hinzufügen einer. jar-Datei auf Ihr Projekt verweisen muss, wird nicht funktionieren. Wenn Sie Android Studio verwenden, ist dies die Zeichenfolge, die dem Abschnitt "Abhängigkeit" der Datei build. gradle hinzugefügt werden soll: In diesem Beispiel wird veranschaulicht, wie Sie auf die GCM-spezifische Bibliothek verweisen können, die die einzige Bibliothek ist, die die GCM-App-Entwicklung unterstützen muss. Verwenden Sie diese anstelle der umfassenden Play Services-Bibliothek, und stellen Sie sicher, dass Sie auf die neueste Version verweisen. Bearbeiten Sie Ihr Anwendungsmanifest Fügen Sie Folgendes zu Ihrem Anwendungsmanifest hinzu: Ihre ltapplication-package-namegt quot. permission. C2DMESSAGEquot-Berechtigung, um andere Android-Anwendungen daran zu hindern, die Android-Anwendungsnachrichten zu registrieren und zu empfangen. Der Name der Berechtigung muss genau diesem Muster entsprechen. Die Android-Anwendung wird die Nachrichten nicht empfangen. Eine Erklärung von GcmReceiver. Die von GCM an Ihre Anwendung gesendete Mitteilungen verarbeitet. Da dieser Dienst die Berechtigung zum Empfangen von Nachrichten von GCM benötigt, fügen Sie com. google. android. c2dm. permission. SEND zum Empfänger hinzu. Eine Erklärung von GcmListenerService. Die verschiedene Aspekte des Handhabens von Nachrichten, wie zum Beispiel das Erfassen unterschiedlicher nachgeschalteter Nachrichtentypen, das Ermitteln des Status des Upstream-Sendens und des automatischen Anzeigens einfacher Benachrichtigungen im App-Bereich, ermöglicht. Ein Dienst, der InstanceIDListenerService erweitert. Um die Erstellung, Rotation und Aktualisierung von Registrierungsmarken zu bewältigen. Optional die Berechtigung android. permission. WAKELOCK, wenn die Anwendung den Prozessor beim Einschalten einer Meldung schlafen lassen muss. Wenn die GCM-Funktion für die Android-Anwendungen entscheidend ist, müssen Sie android: minSdkVersionquot8quot oder höher im Manifest einstellen. Dadurch wird sichergestellt, dass die Android-Anwendung nicht in einer Umgebung installiert werden kann, in der sie nicht ordnungsgemäß ausgeführt werden konnte. Hier ist ein Beispiel-Manifest, das GCM unterstützt: Wenn Sie Pre-4.4 KitKat-Geräte unterstützen möchten, fügen Sie der Absichtserklärung für den Empfänger die folgende Aktion hinzu: ltaction android: namequotcom. google. android. c2dm. intent. REGISTRATIONquot gt Check for Google Play-Dienste APK-Apps, die auf dem Play Services-SDK basieren, sollten das Gerät vor dem Zugriff auf die Funktionen von Google Play-Diensten stets auf dem Gerät nach einem kompatiblen Google Play-Dienst überprüfen. Es wird empfohlen, dies an zwei Stellen durchzuführen: in den Haupttätigkeiten auf der Methode "Create ()" und in der Methode onResume (). Der Check in onCreate () stellt sicher, dass die App nicht ohne eine erfolgreiche Überprüfung verwendet werden kann. Die Überprüfung in onResume () stellt sicher, dass, wenn der Benutzer auf die ausgeführte App zurückkehrt, auf anderem Wege, z. B. über die Schaltfläche "Zurück", die Überprüfung noch ausgeführt wird. Wenn das Gerät keine kompatiblen Google Play-Dienste-APK besitzt, kann Ihre App GooglePlayServicesUtil. getErrorDialog () aufrufen, um es Benutzern zu ermöglichen, die APK aus dem Google Play Store herunterzuladen oder in den Geräte-Systemeinstellungen zu aktivieren. Ein Codebeispiel finden Sie unter Einrichten von Google Play Services SDK. Erhalten eines Registrierungs-Tokens Eine Android-Anwendung muss sich mit GCM-Verbindungsservern registrieren, bevor sie Nachrichten empfangen kann. Wenn eine App registriert wird, erhält sie ein Registrierungs-Token und sendet es an den App-Server. Die Client-Anwendung sollte einen booleschen Wert speichern, der angibt, ob das Registrierungs-Token an den Server gesendet wurde. Google stellt die Instanz-ID-API für die Erstellung und Aktualisierung von Registrierungs-Token bereit. Um diese API zu verwenden, schließen Sie InstanceIDListenerService in das Manifest ein: Um ein Token zu erhalten, rufen Sie instanceID. getToken an. Bereitstellen der Absender-ID des Anwendungsservers und Festlegen des Bereichs auf GoogleCloudMessaging. INSTANCEIDSCOPE. Verwenden Sie einen Dienst, der IntentService wie folgt erweitert: Sobald Sie das Registrierungs-Token erhalten haben, stellen Sie sicher, dass es an Ihren Server gesendet wird. Wenn das GCM-Registrierungs-Token aktualisiert wurde, verwenden Sie InstanceID. getToken (), um ein neues Registrierungs-Token zu erhalten, und senden Sie das neue Token dann an Ihren App-Server, wenn onTokenRefresh aufgerufen wird. Siehe die Instanz-ID-API-Referenz für alle Details auf dieser API. GCM-Register () wurde veraltet. Verwenden Sie InstanceID, um allgemeine GCM-Registrierungsverwaltung durchzuführen. Nächste Schritte Sobald die Client-App verbunden ist, können Sie nachgeschaltete Nachrichten empfangen und nachgeschaltete Nachrichten senden. Weitere Informationen zu Ihren Optionen mit GCM finden Sie auch in den Handbüchern zur Themennachrichten - und Gerätegruppenmeldung sowie zu den Referenzinformationen für Client - und Server-APIs. Sofern nicht anders angegeben, ist der Inhalt dieser Seite unter der Creative Commons Attribution 3.0 Lizenz lizenziert. Und Code-Beispiele sind unter der Apache 2.0 Lizenz lizenziert. Weitere Informationen finden Sie in unseren Website-Richtlinien. Java ist ein eingetragenes Warenzeichen von Oracle und seinen Tochtergesellschaften. 23, 2016 Check out GCM-Videos auf YouTube Entdecken Sie unsere Beispiel-Apps oder forcieren Sie sie, um eigene Fragen zu stellen Fragen Sie mit dem Google-Cloud-Messaging-Tag
No comments:
Post a Comment