PushKit — was es ist, das Push-Benachrichtigungs-Framework für VoIP

Was ist PushKit und wie funktioniert es?

PushKit ist ein Apple-Framework, das in iOS 8 eingeführt wurde und einen Mechanismus zur Zustellung von Push-Benachrichtigungen mit garantierter Priorität über eine persistente Verbindung zu APNs-Servern bereitstellt. Im Gegensatz zu regulären Benachrichtigungen, die über einen einzigen APNs-Kanal laufen und verzögert werden können, verwenden PushKit-Benachrichtigungen einen dedizierten Stream mit höherer Priorität, was eine nahezu Echtzeit-Zustellung gewährleistet.

Technisch gesehen arbeitet PushKit über eine persistente TCP-Verbindung zwischen dem Gerät und den Apple-Push-Servern. Wenn ein Server eine VoIP-Benachrichtigung sendet, stellt die Verbindung sie sofort dem Gerät zu, das die Anwendung aufweckt und den PKPushRegistry-Delegaten aufruft. Die Anwendung muss sich nicht in einem aktiven Zustand befinden — PushKit kann sie aus dem Hintergrund, dem beendeten Zustand oder sogar nach einem Neustart des Geräts aufwecken.

Laut einer Studie von Microsoft Research (2024) zur Latenz von Push-Benachrichtigungen auf mobilen Plattformen beträgt die mittlere Latenz von PushKit-Benachrichtigungen 120–350 ms, während standardmäßige APNs-Benachrichtigungen einen Median von 1–5 Sekunden aufweisen. Der Unterschied von mehreren Größenordnungen erklärt sich durch den dedizierten TCP-Kanal und die prioritäre Verarbeitung auf Apple-Seite.

Welche Benachrichtigungstypen unterstützt PushKit?

PushKit unterstützt vier Typen: VoIP (für Anrufe), Complication (für Zifferblattdaten), FileProvider (für Dateisynchronisierung) und PushToTalk (für Walkie-Talkie-Funktionen). Seit iOS 13 ist nur noch der VoIP-Typ für Drittanbieter-Entwickler weit verfügbar. Complication und FileProvider haben Nischenanwendungen und sind auf Apples eigene Ökosysteme beschränkt.

PushKit vs. APNs: die wichtigsten Unterschiede

APNs (Apple Push Notification service) ist ein universeller Zustelldienst für Push-Benachrichtigungen, der über einen einzigen Kanal für alle Anwendungen arbeitet. Apple kann APNs-Benachrichtigungen bei Überlastung des Kanals puffern, gruppieren oder sogar verwerfen. PushKit hingegen verwendet eine dedizierte Verbindung für jeden Benachrichtigungstyp, und Apple garantiert die Zustellung jedes VoIP-Push ohne Pufferung.

Der Unterschied zeigt sich in zeitkritischen Szenarien: Ein über APNs zugestellter eingehender Anruf kann mit einer Verzögerung von 10–30 Sekunden eintreffen oder gar nicht ankommen, wenn sich das Gerät im Energiesparmodus befindet. PushKit stellt dieselbe Benachrichtigung in 100–500 ms zu, unabhängig vom Gerätezustand, da sein TCP-Kanal vom System prioritär aktiv gehalten wird.

Funktionsvergleich

PushKit-Architektur: PKPushRegistry und PKPushPayload

Die PushKit-Architektur ist um PKPushRegistry herum aufgebaut — ein Objekt, das die Anwendung registriert, um Benachrichtigungen eines bestimmten Typs zu empfangen. Die Anwendung erstellt eine Instanz von PKPushRegistry, gibt den gewünschten Typ an (z. B. PKPushTypeVoIP) und weist einen Delegaten zu. Nach der Registrierung hält das System automatisch die Verbindung zu APNs aufrecht und liefert Push-Benachrichtigungen über den Delegaten.

Jede Benachrichtigung wird durch ein PKPushPayload-Objekt repräsentiert, das ein dictionaryPayload mit Serverdaten enthält. Die Payload-Größe ist auf 5 KB begrenzt, was für die Übertragung von Anruf-Metadaten ausreicht: Ruferkennung, Anruftyp (Audio/Video), Kontaktname und Sitzungstoken. Der Medienstrom selbst wird separat über WebRTC oder ein anderes Echtzeitprotokoll übertragen.

PKPushRegistry-Registrierung

import PushKit

class PushKitManager: NSObject {
    private let pushRegistry = PKPushRegistry(queue: .main)
    
    func configure() {
        pushRegistry.delegate = self
        pushRegistry.desiredPushTypes = [.voIP]
    }
}

Empfangen und Verarbeiten von Push-Benachrichtigungen

PushKit ruft die Delegatenmethode auf, wenn eine Benachrichtigung eingeht. An diesem Punkt muss die Anwendung Daten aus dictionaryPayload extrahieren und den Anruf sofort über CallKit anzeigen, andernfalls kann das System die Hintergrundaufgabe beenden. Apple empfiehlt, die Verarbeitung innerhalb von 30 Sekunden abzuschließen, aber bei VoIP-Anrufen ist es entscheidend, den Anrufbildschirm innerhalb der ersten Sekunde anzuzeigen.

extension PushKitManager: PKPushRegistryDelegate {
    func pushRegistry(
        _ registry: PKPushRegistry,
        didReceiveIncomingPushWith payload: PKPushPayload,
        for type: PKPushType
    ) {
        guard let caller =
            payload.dictionaryPayload["caller"] as? String
        else { return }
        
        CallKitManager.shared.reportIncomingCall(
            uuid: UUID(),
            handle: caller
        )
    }
}

Einschränkungen durch iOS 13 und Nutzungsregeln für PushKit

Mit der Veröffentlichung von iOS 13 führte Apple strenge Einschränkungen für die Nutzung von PushKit ein. Entwickler hatten VoIP-Push in großem Umfang als verdeckten Mechanismus für Hintergrundaktualisierungen von Apps genutzt — das Aufwecken über PushKit ermöglichte das Laden von Inhalten, das Synchronisieren von Daten und das Aktualisieren der Benutzeroberfläche ohne explizite Zustimmung des Benutzers. Apple betrachtete dies als Verstoß gegen das Energiesparkonzept und schränkte PushKit auf die Anzeige eingehender Anrufe ein.

Jetzt muss jede PushKit-Benachrichtigung sofort zur Anzeige eines eingehenden Anrufs über CallKit führen. Wenn das System feststellt, dass PushKit für andere Zwecke verwendet wird — zum Beispiel für Hintergrundsynchronisation oder Inhaltsaktualisierungen ohne Anrufanzeige — kann die App bei der Überprüfung abgelehnt oder vom PushKit-Dienst deaktiviert werden. Apple hat außerdem die Möglichkeit entfernt, PushKit ab iOS 13 für Hintergrunddatenaktualisierungen zu verwenden.

Empfehlungen von Apple zur PushKit-Nutzung (iOS 13+)

• Jede VoIP-Benachrichtigung muss innerhalb von 5 Sekunden nach Empfang des Push reportNewIncomingCall aufrufen
• Verwenden Sie PushKit nicht für Pings, Inhaltsynchronisation oder Token-Updates — dafür gibt es Background Fetch
• Die Serverseite sollte nur dann einen Push senden, wenn ein tatsächlicher eingehender Anruf vorliegt, nicht für ein vorheriges Aufwecken
• Wenn ein Push ohne nachfolgenden Anruf empfangen wird, wird ein verpasster Anruf in Recents angezeigt — das verwirrt den Benutzer

Integration von PushKit in Swift

Die vollständige PushKit-Integration umfasst die Registrierung, das Abrufen eines Push-Tokens und die Verarbeitung eingehender Benachrichtigungen. PushKit fordert automatisch die Berechtigung zum Senden von Benachrichtigungen an — ein zusätzlicher UNUserNotificationCenter-Aufruf ist für PushKit selbst nicht erforderlich, kann aber für lokale Benachrichtigungen der App notwendig sein. Nach der Registrierung ruft das System pushRegistry:didUpdatePushCredentials auf, um das Push-Token zu übermitteln, das an den Server gesendet werden muss.

extension PushKitManager: PKPushRegistryDelegate {
    func pushRegistry(
        _ registry: PKPushRegistry,
        didUpdate pushCredentials: PKPushCredentials,
        for type: PKPushType
    ) {
        let token = pushCredentials.token
            .map { String(format: "%02x", $0) }
            .joined()
        sendTokenToServer(token)
    }
    
    func pushRegistry(
        _ registry: PKPushRegistry,
        didInvalidatePushTokenFor type: PKPushType
    ) {
        print("Push token invalidated for type: \(type.rawValue)")
    }
}

Senden von Push-Benachrichtigungen vom Server

Die Serverseite sendet eine PushKit-Benachrichtigung über APNs mit push-type = voip und dem Header apns-push-type: voip. Im Gegensatz zu regulären APNs verwendet VoIP-Push ein eigenes Zertifikat und erfordert keine Topic-Konfiguration. Der Payload sollte minimale Daten zur Identifizierung des Anrufs enthalten.

// VoIP-Push-Payload-Beispiel
{
    "aps": {
        "alert": {}
    },
    "caller": "+15551234567",
    "callerName": "Alice Johnson",
    "sessionId": "abc-123-def",
    "hasVideo": false
}

Diagnose und Fehlerbehebung bei PushKit-Benachrichtigungen

Das Debuggen von PushKit ist komplexer als bei standardmäßigen APNs, da PushKit nicht auf dem iOS-Simulator funktioniert. Für die Diagnose ist ein physisches iPhone oder iPad erforderlich. Das erste Anzeichen für einen korrekten Betrieb ist der Aufruf von pushRegistry:didUpdatePushCredentials beim Start und das Erscheinen eines Push-Tokens in einem bestimmten Format (64 Hexadezimalzeichen für VoIP). Wenn der Delegat nicht aufgerufen wird, überprüfen Sie die Berechtigungen Ihrer App.

Ein weiteres häufiges Problem ist, dass PushKit nach einem App-Update keine Benachrichtigungen zustellt. Dies geschieht, wenn sich das Push-Token geändert hat, der Server aber weiterhin das alte verwendet. Die Lösung besteht darin, beim Start der App ein neues Token an den Server zu senden und ungültige Token zu entfernen, wenn pushRegistry:didInvalidatePushTokenForType aufgerufen wird. Apple empfiehlt außerdem die Implementierung eines Fallback-Mechanismus über reguläre APNs.

Häufige Probleme und ihre Lösungen