Notification Service Extension: επεξεργασία περιεχομένου πριν από την εμφάνιση στο iOS

Τι είναι το Notification Service Extension

Notification Service Extension — είναι μια επέκταση εφαρμογής στο iOS που εκτελείται πριν από την εμφάνιση της push ειδοποίησης. Επιτρέπει στον διακομιστή να στέλνει ελάχιστο payload, και η επέκταση να το συμπληρώνει με περιεχόμενο: να κατεβάζει εικόνες, να αποκρυπτογραφεί δεδομένα, να αντικαθιστά κείμενο. Ο χρήστης βλέπει την έτοιμη, επεξεργασμένη ειδοποίηση.

Πώς λειτουργεί

Όταν το iOS λαμβάνει μια push ειδοποίηση, το σύστημα ελέγχει την ύπαρξη επέκτασης για αυτήν την εφαρμογή. Εάν η επέκταση είναι καταχωρημένη, το iOS την εκκινεί σε μια διαδικασία παρασκηνίου και μεταδίδει το περιεχόμενο της ειδοποίησης μέσω της μεθόδου didReceive(_:withContentHandler:). Η επέκταση επεξεργάζεται το περιεχόμενο και καλεί το contentHandler με το τροποποιημένο περιεχόμενο. Εάν η επέκταση δεν προλάβει εντός 30 δευτερολέπτων, το σύστημα εμφανίζει την αρχική ειδοποίηση.

Πότε να χρησιμοποιείτε το Service Extension

Το Service Extension είναι απαραίτητο σε σενάρια όπου το περιεχόμενο της ειδοποίησης απαιτεί επεξεργασία στη συσκευή. Ασφαλείς επικοινωνίες: ο διακομιστής στέλνει κρυπτογραφημένο payload, η επέκταση το αποκρυπτογραφεί τοπικά. Πλούσιες ειδοποιήσεις πολυμέσων: ο διακομιστής στέλνει URL εικόνας, η επέκταση το κατεβάζει και το επισυνάπτει. Δυναμική τοπικοποίηση: η επέκταση αντικαθιστά το κείμενο στη γλώσσα της συσκευής.

Περιορισμοί και χρόνος εκτέλεσης

Το Notification Service Extension λειτουργεί σε περιορισμένο περιβάλλον. Μέγιστος χρόνος εκτέλεσης — 30 δευτερόλεπτα. Η επέκταση δεν έχει πρόσβαση στην κύρια αποθήκευση της εφαρμογής (εκτός από App Group). Το μέγεθος της επέκτασης περιορίζεται στα 50 MB. Σε υπέρβαση χρόνου, το σύστημα καλεί το contentHandler με το αρχικό περιεχόμενο και όλες οι αλλαγές χάνονται.

Δημιουργία επέκτασης και ρύθμιση Info.plist

Στο Xcode, το Notification Service Extension προστίθεται δημιουργώντας ένα νέο target τύπου Notification Service Extension. Το Xcode δημιουργεί ένα πρότυπο κλάσης NotificationService που κληρονομεί από το UNNotificationServiceExtension, με δύο μεθόδους: didReceive και serviceExtensionTimeWillExpire.

Προσθήκη target στο έργο

Στο Xcode επιλέξτε File → New → Target → Notification Service Extension. Καθορίστε το όνομα (π.χ. PushNotificationService) και τη γλώσσα Swift. Βεβαιωθείτε ότι το target προστέθηκε στην κύρια εφαρμογή και έχει σωστή υπογραφή. Μετά τη δημιουργία, θα δημιουργηθεί η κλάση NotificationService.swift με βασική υλοποίηση.

Δομή Info.plist της επέκτασης

Το Info.plist της επέκτασης περιέχει το κλειδί NSExtension με υποκλειδιά NSExtensionPointIdentifier (com.apple.usernotifications.service) και NSExtensionPrincipalClass (το όνομα του ελεγκτή σας). Προαιρετικά μπορεί να καθοριστεί NSExtensionAttributes με κανόνες ενεργοποίησης της επέκτασης. Αυτές οι ρυθμίσεις δημιουργούνται αυτόματα από το Xcode.

Παράδειγμα βασικής επέκτασης

Η βασική υλοποίηση παρακάμπτει τη didReceive, τροποποιεί το περιεχόμενο της ειδοποίησης και καλεί το contentHandler. Εάν η επεξεργασία διαρκεί πολύ, καλείται η serviceExtensionTimeWillExpire, όπου πρέπει να ολοκληρωθεί η εργασία με την τρέχουσα κατάσταση.

import UserNotifications

class NotificationService: UNNotificationServiceExtension {

    var contentHandler: ((UNNotificationContent) -> Void)?
    var bestAttemptContent: UNMutableNotificationContent?

    override func didReceive(
        request: UNNotificationRequest,
        withContentHandler handler: @escaping (UNNotificationContent) -> Void
    ) {
        contentHandler = handler
        bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)

        if let bestAttemptContent = bestAttemptContent {
            bestAttemptContent.title = "[Επεξεργάστηκε] \(bestAttemptContent.title)"
            contentHandler?(bestAttemptContent)
        }
    }

    override func serviceExtensionTimeWillExpire() {
        if let contentHandler = contentHandler,
           let bestAttemptContent = bestAttemptContent {
            contentHandler(bestAttemptContent)
        }
    }
}

Αποκρυπτογράφηση κρυπτογραφημένου payload

Μία από τις βασικές εφαρμογές του Service Extension είναι η αποκρυπτογράφηση του περιεχομένου της ειδοποίησης στη συσκευή. Ο διακομιστής στέλνει κρυπτογραφημένο payload, και η επέκταση το αποκρυπτογραφεί χρησιμοποιώντας ένα κλειδί που είναι αποθηκευμένο στο Keychain ή στο App Group. Αυτό εγγυάται ότι το περιεχόμενο δεν μπορεί να υποκλαπεί κατά τη μεταφορά.

Αρχιτεκτονική ασφαλούς παράδοσης

Ο διακομιστής κρυπτογραφεί το σώμα της ειδοποίησης χρησιμοποιώντας συμμετρικό κλειδί (AES-256). Το κλειδί κρυπτογράφησης συμφωνείται εκ των προτέρων μεταξύ πελάτη και διακομιστή. Η επέκταση λαμβάνει κρυπτογραφημένη συμβολοσειρά στο πεδίο data του payload, την αποκρυπτογραφεί και την τοποθετεί στα πεδία της ειδοποίησης. Το κλειδί χρήστη μπορεί να ληφθεί από το Keychain μετά την αυθεντικοποίηση.

override func didReceive(
    request: UNNotificationRequest,
    withContentHandler handler: @escaping (UNNotificationContent) -> Void
) {
    guard let content = request.content.mutableCopy()
        as? UNMutableNotificationContent else {
        handler(request.content)
        return
    }

    guard let encryptedData = content.userInfo["encrypted_data"]
        as? String else {
        handler(content)
        return
    }

    let decrypted = CryptoService.decrypt(encryptedData)
    content.body = decrypted.body
    content.title = decrypted.title
    handler(content)
}

Ασφαλής αποθήκευση κλειδιών

Το κλειδί αποκρυπτογράφησης δεν πρέπει να αποθηκεύεται στον κώδικα της επέκτασης ή στο NSUserDefaults. Χρησιμοποιήστε iOS Keychain με πρόσβαση μέσω App Group, ώστε τόσο η εφαρμογή όσο και η επέκταση να μπορούν να διαβάσουν το κλειδί. Για τη δημιουργία κλειδιού στην πλευρά του πελάτη, χρησιμοποιήστε το Security.framework με αλγόριθμο AES-256-GCM.

Λήψη και επισύναψη πολυμέσων

Η πιο συχνή χρήση του Notification Service Extension — λήψη εικόνων, GIF και βίντεο για επακόλουθη εμφάνιση στην ειδοποίηση. Ο διακομιστής στέλνει το URL του αρχείου πολυμέσου, και η επέκταση το κατεβάζει, το αποθηκεύει σε προσωρινό κατάλογο και δημιουργεί UNNotificationAttachment.

Διαδικασία λήψης και επισύναψης πολυμέσων

Η επέκταση λαμβάνει το URL της εικόνας από το πεδίο payload της ειδοποίησης. Χρησιμοποιώντας το URLSession, η επέκταση κατεβάζει το αρχείο σε προσωρινό κατάλογο. Μετά την ολοκλήρωση της λήψης, δημιουργείται UNNotificationAttachment με το τοπικό URL. Το συνημμένο μεταδίδεται στο τροποποιημένο περιεχόμενο. Το iOS αυτόματα εμφανίζει την εικόνα στην τυπική διεπαφή ή στο Notification Content Extension.

private func downloadAndAttachMedia(
    content: UNMutableNotificationContent,
    mediaUrl: String,
    handler: @escaping (UNNotificationContent) -> Void
) {
    guard let url = URL(string: mediaUrl) else {
        handler(content)
        return
    }

    let task = URLSession.shared.downloadTask(with: url) { localUrl, _, error in
        guard let localUrl = localUrl, error == nil else {
            handler(content)
            return
        }

        let attachment = try? UNNotificationAttachment(
            identifier: "media",
            url: localUrl,
            options: nil
        )

        if let attachment = attachment {
            content.attachments = [attachment]
        }
        handler(content)
    }
    task.resume()
}

Υποστηριζόμενες μορφές πολυμέσων

Το iOS υποστηρίζει τις ακόλουθες μορφές για εμφάνιση σε ειδοποιήσεις: JPEG, PNG, GIF (στατικά), βίντεο MPEG-4 έως 50 MB. Για αρχεία ήχου υποστηρίζονται MP3, AAC και ALAC. Σημαντικό: όλα τα αρχεία πολυμέσων πρέπει να ληφθούν εντός του ορίου των 30 δευτερολέπτων. Για μεγάλα αρχεία, συνιστάται περικοπή από τον διακομιστή ή προοδευτική λήψη.

Διαχείριση χρόνου και σενάρια εφεδρείας

Διαχείριση του ορίου των 30 δευτερολέπτων — βασικό καθήκον στην ανάπτυξη του Notification Service Extension. Εάν η επέκταση δεν ολοκληρώσει την επεξεργασία, το σύστημα καλεί το serviceExtensionTimeWillExpire και εμφανίζει το αρχικό περιεχόμενο. Πρέπει να προβλέπονται σενάρια εφεδρείας για κάθε τύπο επεξεργασίας.

Στρατηγική προτεραιοτήτων

Χωρίστε τις εργασίες ανά προτεραιότητα. Οι κρίσιμες τροποποιήσεις (αποκρυπτογράφηση, βασική τοπικοποίηση) εκτελούνται πρώτα. Οι προαιρετικές βελτιώσεις (λήψη εικόνων, εμπλουτισμός κειμένου) — σε δεύτερη φάση. Χρησιμοποιήστε URLSession με χρονικά όρια για αιτήματα δικτύου, για να μην εξαντλήσετε ολόκληρο το όριο σε μία λειτουργία.

Σενάρια εφεδρείας σε σφάλματα

Εάν η λήψη εικόνας απέτυχε ή η αποκρυπτογράφηση payload επέστρεψε σφάλμα, η επέκταση πρέπει να καλέσει το contentHandler με το αρχικό περιεχόμενο. Μην τερματίζετε ποτέ την επέκταση χωρίς να καλέσετε το contentHandler — αυτό οδηγεί σε απώλεια της ειδοποίησης. Ασφαλής εφεδρεία πρέπει πάντα να προβλέπεται στον κώδικα της επέκτασης.

override func didReceive(
    request: UNNotificationRequest,
    withContentHandler handler: @escaping (UNNotificationContent) -> Void
) {
    let content = (request.content.mutableCopy()
        as? UNMutableNotificationContent) ?? request.content

    // Κρίσιμη εργασία: αποκρυπτογράφηση
    var decryptedContent = tryDecryptPayload(content)

    // Προαιρετική εργασία: πολυμέσα
    guard let mediaUrl = decryptedContent.userInfo["media_url"]
        as? String else {
        handler(decryptedContent)
        return
    }

    downloadAndAttachMedia(
        content: decryptedContent,
        mediaUrl: mediaUrl,
        handler: handler
    )
}

Δοκιμή της επέκτασης

Για τη δοκιμή του Notification Service Extension χρησιμοποιήστε Xcode: επιλέξτε το target της επέκτασης, εκτελέστε στον προσομοιωτή και στείλτε push ειδοποίηση μέσω τερματικού ή Firebase Console. Καταγράψτε κάθε στάδιο επεξεργασίας μέσω os_log — αυτό βοηθά στη διάγνωση προβλημάτων χρονισμού και σφαλμάτων φόρτωσης.