Zum Hauptinhalt springen
Tutorial

Ionic Capacitor Push-Benachrichtigungen mit Firebase: Ein Schritt-für-Schritt-Leitfaden

Lernen Sie, wie Sie Push-Benachrichtigungen in Ihrer Ionic Capacitor-App mit Firebase integrieren können, mit Schritt-für-Schritt-Anweisungen für beide Android- und iOS-Plattformen.

Martin Donadieu

Martin Donadieu

Content-Marketing-Spezialist

Ionic Capacitor Push-Benachrichtigungen mit Firebase: Ein Schritt-für-Schritt-Leitfaden

In diesem Tutorial werden wir Push-Benachrichtigungen in einer Ionic Capacitor-App mit Firebase integrieren. Für einen gepflegten Capacitor-Plugin mit Unterstützung für Firebase Cloud Messaging, sehen Sie bitte @capgo/capacitor-firebase-messagingSie benötigen für diese Funktion keinen spezifischen Dienst, müssen jedoch mehrere Dinge vorher konfigurieren. Firebase ist eine gute Wahl, da es für Android erforderlich ist und Sie es leicht verwenden können, um Benachrichtigungen ohne die Verwendung der Datenbank zu senden.

Zuerst erstellen wir eine Ionic-App mit Capacitor aktiviert und legen unseren Paket-Idfest, der die eindeutige Identifikationsnummer für Ihre App ist. Dann bauen wir die App und fügen die nativen Plattformen hinzu.

ionic start pushApp blank --type=angular --capacitor --package-id=com.appdactic.devpush
cd ./pushApp
ionic build
npx cap add ios
npx cap add android

Wenn Sie bereits eine App haben, können Sie den capacitor.config.json anpassen, um Ihren appIdeinzufügen. Allerdings müssen Sie, wenn Ihre nativen Ordner bereits existieren, den Id in allen Dateien ersetzen, da Capacitor nur den Ordner einmal erstellt und den Id selbst nicht aktualisiert. Im capacitor.config.jsonkönnen Sie auch Optionen wie die Aktualisierung der Badge-Zahl, das Abspielen eines Sounds bei einer Push-Benachrichtigung und das Anzeigen einer Benachrichtigung, wenn eine Benachrichtigung eintrifft, angeben.

{
  "appId": "com.appdactic.devpush",
  "appName": "pushApp",
  "bundledWebRuntime": false,
  "npmClient": "npm",
  "webDir": "www",
  "plugins": {
    "SplashScreen": {
      "launchShowDuration": 0
    },
    "PushNotifications": {
      "presentationOptions": ["badge", "sound", "alert"]
    }
  },
  "cordova": {}
}

Jetzt konfigurieren wir Push-Benachrichtigungen außerhalb der App.

Firebase-Konfiguration

Beginnen Sie damit eine neue Firebase-Projekt zu erstellen oder ein bestehendes zu verwenden. Geben Sie einen Namen und Standardoptionen für ein neues Projekt an.

Wenn Sie ein neues App haben, sollten Sie “Mit der Arbeit beginnen, indem Sie Firebase in Ihrer App hinzufügen” in Ihrem App-Dashboard sehen. Ansonsten klicken Sie auf das Zahnrad-Symbol und gehen Sie zu Projekt-Einstellungen um eine App hinzuzufügen.

Das Dialogfeld für beide iOS und Android sieht ähnlich aus, und das Wichtige ist, dass Sie Ihren Paket-Id verwenden für die Apps.

firebase-app-setup-ios

Nach dem ersten Schritt, laden Sie die folgenden Dateien herunter:

  • google-services.json Datei für Android
  • GoogleService-info.plist Datei für iOS

Als Nächstes konfigurieren Sie die Plattformen.

Android-Push-Vorbereitung

Für Android bewegen Sie die google-services.json heruntergeladene Datei in den android/app/ Ordner.

android-push-file

Das ist alles für Android. Jetzt konfigurieren wir iOS.

iOS-Push-Vorbereitung

Diese Teile sind komplexer. Zuerst, erstellen Sie einen App-Id für Ihre App innerhalb der Identifikatorenliste Ihrer Apple-Entwickler-Konto. Stellen Sie sicher, dass Sie die Push-Benachrichtigungsfähigkeit aus der Liste auswählen.

ionic-ios-push-id

The Bundle-ID sollte dasselbe sein wie Ihr App-ID innerhalb von __CAPGO_KEEP_0__ und Firebase. Sollte die gleiche sein wie Ihre App-ID innerhalb von Capacitor und Firebase.

Jetzt, Erstellen Sie eine Schlüssel und aktivieren Sie das Apple Push-Benachrichtigungen-Dienst (APNs)Wenn Sie die maximale Anzahl von Schlüsseln erreicht haben, können Sie einen bestehenden Schlüssel oder ein Zertifikat verwenden, aber der Prozess ist komplexer.

ios-developer-push-key

Nach dem Herunterladen des .p8 Dateien, laden Sie sie in Firebase hoch. Öffnen Sie die Cloud Messaging Registerkarte in Ihren Firebase-Projekt-Einstellungen, laden Sie das Datei hoch und geben Sie die Details für die Key-ID und Ihre Team-ID von iOS ein.

firebase-upload-ios-key

Ändern Sie nun Ihre Xcode-Projekt, indem Sie Folgendes ausführen:

npx cap open ios

Kopieren Sie die GoogleService-Info.plist Datei, die Sie von Firebase heruntergeladen haben, in Ihr iOS-Projekt. Ziehen Sie die Datei in das Xcode-Projekt innerhalb der app/app-Folder und wählen Sie Kopieren Sie, wenn erforderlich.

Als Nächstes fügen Sie ein neues Pod für die Firebase-Abhängigkeit in der ios/App/Podfile:

target 'App' do
  capacitor_pods
  # Add your Pods here
  pod 'Firebase/Messaging'
end

Aktualisieren Sie die native Plattform mit diesem Befehl:

npx cap update ios

Ändern Sie die native Swift code in ios/App/App/AppDelegate.swift um sich bei Firebase anzumelden und den richtigen Token an Ihre App zurückzugeben.

import UIKit
import Capacitor
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // Override point for customization after application launch.
    FirebaseApp.configure()
    return true
  }

  // All the existing functions
  // ...

  // Update this one:
    func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
        Messaging.messaging().apnsToken = deviceToken
        InstanceID.instanceID().instanceID { (result, error) in
            if let error = error {
                NotificationCenter.default.post(name: Notification.Name(CAPNotifications.DidFailToRegisterForRemoteNotificationsWithError.name()), object: error)
            } else if let result = result {
                NotificationCenter.default.post(name: Notification.Name(CAPNotifications.DidRegisterForRemoteNotificationsWithDeviceToken.name()), object: result.token)
            }
        }
    }
}

Schließlich fügen Sie die Fähigkeit für Push-Benachrichtigungen innerhalb Ihres Xcode-Projekts hinzu.

capacitor-xcode-capability

Bauen Sie nun Ihre App und integrieren Sie Push-Benachrichtigungen.

Ionic-Integration von Push-Benachrichtigungen

Erstellen Sie ein Dienstprogramm und eine neue Seite in Ihrem Ionic-Projekt:

ionic g service services/fcm
ionic g page pages/details

Aktualisieren Sie die Routen in app/app-routing.module.ts um die neue Seite mit einem dynamischen ID zu beinhalten:

import { NgModule } from '@angular/core';
import { PreloadAllModules, RouterModule, Routes } from '@angular/router';

const routes: Routes = [
  {
    path: 'home',
    loadChildren: () => import('./home/home.module').then( m => m.HomePageModule)
  },
  {
    path: '',
    redirectTo: 'home',
    pathMatch: 'full'
  },
  {
    path: 'home/:id',
    loadChildren: () => import('./pages/details/details.module').then( m => m.DetailsPageModule)
  },
];

@NgModule({
  imports: [
    RouterModule.forRoot(routes, { preloadingStrategy: PreloadAllModules })
  ],
  exports: [RouterModule]
})
export class AppRoutingModule { }

Erstellen Sie ein Dienstprogramm zum Umgang mit Push-Benachrichtigungen in services/fcm.service.ts:

import { Injectable } from '@angular/core';
import {
  Plugins,
  PushNotification,
  PushNotificationToken,
  PushNotificationActionPerformed,
  Capacitor
} from '@capacitor/core';
import { Router } from '@angular/router';

const { PushNotifications } = Plugins;

@Injectable({
  providedIn: 'root'
})
export class FcmService {

  constructor(private router: Router) { }

  initPush() {
    if (Capacitor.platform !== 'web') {
      this.registerPush();
    }
  }

  private registerPush() {
    PushNotifications.requestPermission().then((permission) => {
      if (permission.granted) {
        // Register with Apple / Google to receive push via APNS/FCM
        PushNotifications.register();
      } else {
        // No permission for push granted
      }
    });

    PushNotifications.addListener(
      'registration',
      (token: PushNotificationToken) => {
        console.log('My token: ' + JSON.stringify(token));
      }
    );

    PushNotifications.addListener('registrationError', (error: any) => {
      console.log('Error: ' + JSON.stringify(error));
    });

    PushNotifications.addListener(
      'pushNotificationReceived',
      async (notification: PushNotification) => {
        console.log('Push received: ' + JSON.stringify(notification));
      }
    );

    PushNotifications.addListener(
      'pushNotificationActionPerformed',
      async (notification: PushNotificationActionPerformed) => {
        const data = notification.notification.data;
        console.log('Action performed: ' + JSON.stringify(notification.notification));
        if (data.detailsId) {
          this.router.navigateByUrl(`/home/${data.detailsId}`);
        }
      }
    );
  }
}

Rufen Sie die initPush() Funktion in __CAPGO_KEEP_0__ in app/app.component.ts:

import { Component } from '@angular/core';

import { Platform } from '@ionic/angular';
import { SplashScreen } from '@ionic-native/splash-screen/ngx';
import { StatusBar } from '@ionic-native/status-bar/ngx';
import { FcmService } from './services/fcm.service';

@Component({
  selector: 'app-root',
  templateUrl: 'app.component.html',
  styleUrls: ['app.component.scss']
})
export class AppComponent {
  constructor(
    private platform: Platform,
    private splashScreen: SplashScreen,
    private statusBar: StatusBar,
    private fcmService: FcmService
  ) {
    this.initializeApp();
  }

  initializeApp() {
    this.platform.ready().then(() => {
      this.statusBar.styleDefault();
      this.splashScreen.hide();

      // Trigger the push setup
      this.fcmService.initPush();
    });
  }
}

Behandeln Sie die Informationen auf der Details-Seite in pages/details/details.page.ts:

import { Component, OnInit } from '@angular/core';
import { ActivatedRoute } from '@angular/router';
import { Plugins } from '@capacitor/core';
const { PushNotifications } = Plugins;

@Component({
  selector: 'app-details',
  templateUrl: './details.page.html',
  styleUrls: ['./details.page.scss'],
})
export class DetailsPage implements OnInit {
  id = null;

  constructor(private route: ActivatedRoute) { }

  ngOnInit() {
    this.route.paramMap.subscribe(params => {
      this.id = params.get('id');
    });
  }

  resetBadgeCount() {
    PushNotifications.removeAllDeliveredNotifications();
  }

}

Anzeigen Sie die Details in pages/details/details.page.html:

<ion-header>
  <ion-toolbar>
    <ion-buttons slot="start">
      <ion-back-button defaultHref="/"></ion-back-button>
    </ion-buttons>
    <ion-title>Details</ion-title>
  </ion-toolbar>
</ion-header>

<ion-content>
  My Id from push: {{ id }}

  <ion-button (click)="resetBadgeCount()" expand="block">
    Reset Badge Count
  </ion-button>
</ion-content>

Bauen Sie die App, synchronisieren Sie Ihre Änderungen und deployen Sie sie auf Ihrem Gerät.

ionic build
npx cap sync

Jetzt können Sie Push-Benachrichtigungen mit Firebase senden.

Mit Firebase Push-Benachrichtigungen senden

Es gibt mehrere Möglichkeiten, Push-Benachrichtigungen mit Firebase zu senden.

Spezifische Geräte-Test

Nachdem Sie Ihre App auf einem Gerät bereitgestellt haben, können Sie die Konsole-Protokolle überprüfen, um den Token nach der Registrierung zu sehen. Verwenden Sie diesen Token, um eine gezielte Test-Benachrichtigung zu senden, um Ihre Integration zu überprüfen. In Firebase gehen Sie zu Cloud Messaging und wählen Testnachricht senden. Fügen Sie den Geräte-Token aus den Protokollen hinzu.

firebase-test-push

Wenn alles korrekt eingerichtet ist, sollten Sie auf Ihrem Gerät eine Push-Benachrichtigung sehen.

Push-Nachricht mit Payload

Um eine Push-Benachrichtigung mit zusätzlichen Informationen zu testen, folgen Sie dem Wizard auf derselben Seite, um allgemeine Informationen zu spezifizieren und die Plattform auszuwählen, die Sie ansteuern möchten. Fügen Sie zusätzliche Optionen um eine Payload mit Ihrer Push-Benachrichtigung zu senden.

firebase-push-payload

In den Erweiterte Optionen Abschnitt, fügen Sie ein Benutzerdefinierte Daten Schlüssel-Wert-Paar. Zum Beispiel können Sie den Schlüssel " und einen Wert Ihrer Wahl verwenden. Diese Daten werden im App verwendet, um zur Details-Seite mit der angegebenen ID zu navigieren. detailsId Nach dem Senden der Push-Benachrichtigung sollte Ihre App sie empfangen und die Details-Seite mit der angegebenen ID anzeigen, wenn die Benachrichtigung angeklickt wird.

Mit Firebase __CAPGO_KEEP_0__

Sie können auch Push-Benachrichtigungen programmatisch mithilfe von Firebase API senden. Dazu müssen Sie den "

You can also send push notifications programmatically using the Firebase API. To do this, you need to obtain the von Ihrem Firebase-Projekt-Einstellungen unter der " Cloud Messaging Registerkarte" erhalten. Server key

Mit der Server-Schlüssel können Sie einen POST-Anforderung an die Firebase API senden, wobei der erforderliche Payload übergeben wird. Hier ist ein Beispiel mit Node.js und der request Bibliothek:

const request = require('request');

const serverKey = 'YOUR_SERVER_KEY';
const deviceToken = 'YOUR_DEVICE_TOKEN';

const options = {
  method: 'POST',
  url: 'https://fcm.googleapis.com/fcm/send',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'key=' + serverKey
  },
  body: JSON.stringify({
    to: deviceToken,
    notification: {
      title: 'Test Push',
      body: 'This is a test push notification with custom data'
    },
    data: {
      detailsId: '123'
    }
  })
};

request(options, (error, response, body) => {
  if (error) {
    console.error('Error sending push:', error);
  } else {
    console.log('Push sent successfully:', body);
  }
});

Ersetzen YOUR_SERVER_KEY und YOUR_DEVICE_TOKEN mit Ihrem tatsächlichen Server-Schlüssel und Geräte-Token. Führen Sie das Skript aus, und Ihr Gerät sollte die Push-Nachricht mit dem benutzerdefinierten Payload erhalten.

Das ist es! Sie haben erfolgreich Push-Nachrichten in Ihrer Ionic Capacitor-App mit Firebase integriert. Jetzt können Sie Push-Nachrichten an Ihre Benutzer auf beiden Android- und iOS-Plattformen senden.

Fortsetzen Sie mit Ionic Capacitor Push-Nachrichten mit Firebase: Eine Schritt-für-Schritt-Anleitung

Wenn Sie Ionic __CAPGO_KEEP_0__ Push-Nachrichten mit Firebase: Eine Schritt-für-Schritt-Anleitung Ionic Capacitor Push Notifications with Firebase: A Step-by-Step Guide __CAPGO_KEEP_0__ Enterprise für den Produktworkflow in Capgo Enterprise, Ionic Capgo Push-Nachrichten mit Firebase: Eine Schritt-für-Schritt-Anleitung Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen Capgo Alternativen für den Produktworkflow in Capgo Alternativen Capgo Consulting für den Produktworkflow in Capgo Consulting, und Capgo Premium Support für den Produktworkflow in Capgo Premium Support.

Live-Updates für Capacitor-Apps

Wenn ein Fehler im Web-Schicht lebt, liefern Sie die Reparatur über Capgo anstatt Tage zu warten, bis die App-Store-Zulassung vorliegt. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Zulassungsverfahren bleiben.

Menschliche Unterstützung von Martin

Los geht's

Neueste aus unserem Blog

Capgo bietet Ihnen die besten Einblicke, die Sie benötigen, um eine wirklich professionelle mobile App zu erstellen.