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. „APNs-Schlüssel”).

   Fragt Apple beim Aktivieren nach Environment und Key Restriction (Button “Configure”), wähle:

   • Environment: “Sandbox & Production” – ein Key deckt damit beide Umgebungen ab (Development-Builds aus Xcode senden über Sandbox, TestFlight/App-Store-Builds über Production). So brauchst du nie einen zweiten Key.
   • Key Restriction: “Team Scoped” – der Schlüssel gilt für dein gesamtes Team.

   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.

   Zwei Upload-Felder (Entwicklung / Produktion)?

   Firebase zeigt je nach Ansicht zwei Auth-Key-Felder: “Entwicklungs-APNs-Authentifizierungsschlüssel” und “Produktions-APNs-Authentifizierungsschlüssel”. Lade in beide Felder dieselbe .p8-Datei hoch (mit derselben Key ID und Team ID). Dein „Sandbox & Production”-Key gilt für beide Umgebungen – so sind Development- und Produktions-Builds abgedeckt. Es ist kein zweiter, separater Key nötig.

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.