Push-Benachrichtigungen (iOS / APNs)

Beim Veröffentlichen richtet BLOCQ Push-Benachrichtigungen fast vollständig automatisch ein. Android (FCM) und die Cloud Functions – inklusive des Broadcast-Versands für manuelle Admin-Pushes – laufen vollautomatisch. Für iOS ist ein einmaliger manueller Schritt nötig, den Apple technisch nicht automatisierbar macht.

---

Was automatisch passiert

Cloud Functions

sendPushNotification und sendBroadcastPush werden automatisch deployt – kein manuelles Eingreifen nötig.

Android / FCM

FCM-Zustellung für Android-Geräte wird vollständig automatisch konfiguriert.

In-App-Benachrichtigungszentrum

Das In-App-Notification-Center wird mit deinen aktiven Benachrichtigungstypen eingerichtet.

---

Was du für iOS manuell tun musst

Apple erlaubt es keiner externen Plattform, einen APNs Auth Key automatisch zu erstellen oder in die Firebase Console hochzuladen – dieser Schritt muss einmalig von dir durchgeführt werden.

1. Apple Developer Account öffnen

   Gehe zu developer.apple.com → Certificates, Identifiers & Profiles → Keys → ”+” (neuen Key erstellen).

   Aktiviere den Dienst “Apple Push Notifications service (APNs)” und vergib einen Namen (z. B. „BLOCQ APNs Key”). Tippe auf “Continue” → “Register”.

2. Key herunterladen und Daten notieren

   Lade die .p8-Datei herunter.

   Nur einmalig herunterladbar

   Apple stellt den .p8-Key nach der Erstellung nur einmal zum Download bereit. Speichere ihn sicher (z. B. Passwortmanager oder verschlüsseltes Laufwerk) – er kann nicht erneut heruntergeladen werden.

   Notiere:

   • Key ID – 10-stellige alphanumerische ID (sichtbar in der Key-Liste)
   • Team ID – 10-stellige ID in deinem Apple Developer Account (Profil-Menü oben rechts → Membership)

3. Firebase Console öffnen

   Öffne die Firebase Console → wähle dein Projekt → Projekteinstellungen (Zahnrad-Icon) → Tab “Cloud Messaging”.

   Scrolle zum Abschnitt “Apple app configuration” und tippe auf “Upload” neben „APNs authentication key”.

   Lade die .p8-Datei hoch und trage Key ID und Team ID ein. Speichern.

4. Bestätigung im BLOCQ Publish-Wizard

   Kehre in der App zum Publish-Wizard zurück. Aktiviere die Bestätigung:

   „Ich habe den APNs Auth Key in der Firebase Console hochgeladen.”

   Erst nach dieser Bestätigung kann der Wizard weiterlaufen.

---

Wichtige Hinweise

Ohne diesen Schritt: kein iOS-Push

Ohne den hinterlegten APNs Auth Key kommen auf iPhones und iPads keine Push-Benachrichtigungen an. Android-Geräte sind nicht betroffen – FCM funktioniert unabhängig davon vollautomatisch.

Key-Details: Laufzeit, Wiederverwendung, Umgebungen

• Der .p8-Key gilt sowohl für Development als auch Production – kein separater Key nötig.
• Ein Key läuft nicht ab (im Gegensatz zu APNs-Zertifikaten).
• Derselbe Key kann für mehrere Apps im selben Apple Developer Team genutzt werden.

---

Warum ist dieser Schritt nicht automatisierbar?

Technische Einschränkung

Apple gibt den .p8-Key nach der Erstellung nicht erneut heraus – BLOCQ kann ihn daher nicht im Hintergrund abrufen. Firebase bietet zudem keine öffentliche API zum Hochladen des APNs Auth Keys an. Deshalb ist dieser eine Schritt bewusst manuell und im Wizard durch eine Pflicht-Bestätigung abgesichert.

---

Weiter im Wizard

Nach der Bestätigung wechselt der Wizard zum nächsten Schritt.