Universal Link — τι είναι, αρχή λειτουργίας και ρύθμιση

Τι είναι το Universal Link

Universal Link είναι ένας τυπικός σύνδεσμος HTTPS της μορφής https://example.com/page που, όταν γίνει κλικ από συσκευή iOS, ανοίγει την εγκατεστημένη εφαρμογή αντί για το Safari. Η κύρια διαφορά από το Custom URL Scheme: το Universal Link δεν απαιτεί εγγραφή προσαρμοσμένου σχήματος (myapp://) — χρησιμοποιείται ένας συνηθισμένος τομέας. Αυτό εξαλείφει το πρόβλημα URL Scheme hijacking, όπου οποιαδήποτε εφαρμογή μπορεί να καταχωρήσει το ίδιο σχήμα.

Η Apple παρουσίασε το Universal Link στο WWDC 2015 στο πλαίσιο του iOS 9. Ο μηχανισμός έγινε μέρος του οικοσυστήματος Handoff και Spotlight: το Universal Link λειτουργεί όχι μόνο στον περιηγητή, αλλά και στα αποτελέσματα αναζήτησης Spotlight, στο Mail, Messages και σε άλλες εφαρμογές συστήματος. Επιπλέον, το Universal Link υποστηρίζεται σε watchOS και macOS — ο χρήστης μπορεί να ανοίξει την εφαρμογή στο iPhone μέσω ενός συνδέσμου στο Mac.

Το βασικό πλεονέκτημα: ενιαίο URL. Ο προγραμματιστής δεν διαχειρίζεται δύο διαφορετικούς συνδέσμους (έναν για τον ιστό, έναν για την εφαρμογή). Το Universal Link είναι ο ίδιος σύνδεσμος https. Εάν η εφαρμογή είναι εγκατεστημένη — ανοίγει αυτή. Εάν όχι — ο ίδιος σύνδεσμος ανοίγει στο Safari ως συνηθισμένη ιστοσελίδα. Αυτό παρέχει μια ιδανική εναλλακτική (fallback) χωρίς απώλεια κίνησης.

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

Ο μηχανισμός Universal Link αποτελείται από τρία στάδια: επαλήθευση συσχέτισης, επεξεργασία συνδέσμου και fallback στον περιηγητή. Κάθε στάδιο είναι κρίσιμο για τη σωστή λειτουργία. Εάν η συσχέτιση δεν έχει ρυθμιστεί, το iOS αντιμετωπίζει τον σύνδεσμο ως μια συνηθισμένη μετάβαση στο Safari. Ας εξετάσουμε κάθε στάδιο λεπτομερώς.

Επαλήθευση συσχέτισης (Association Verification)

Στο πρώτο κλικ στον σύνδεσμο, το iOS κατεβάζει το αρχείο apple-app-site-association από τον διακομιστή στη διεύθυνση https://example.com/.well-known/apple-app-site-association. Το αρχείο περιέχει JSON με το Team ID και το Bundle ID της εφαρμογής, καθώς και μια λίστα διαδρομών που πρέπει να ανοίγει η εφαρμογή. Το iOS αποθηκεύει προσωρινά αυτό το αρχείο και ελέγχει περιοδικά την επικαιρότητά του (κατά την ενημέρωση της εφαρμογής, επανεκκίνηση της συσκευής).

Το αρχείο JSON apple-app-site-association πρέπει να είναι προσβάσιμο μέσω HTTPS χωρίς ανακατευθύνσεις. Ο διακομιστής πρέπει να επιστρέφει Content-Type: application/json. Σημαντικό: το αρχείο δεν έχει επέκταση .json — το iOS το αναζητά αυστηρά στη διαδρομή /.well-known/apple-app-site-association. Η Apple συνιστά επίσης την προσθήκη υποστήριξης για Universal Link στο CDN και τον έλεγχο ότι το αρχείο δεν αποκλείεται από το robots.txt.

// apple-app-site-association — ελάχιστη διαμόρφωση
{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "TEAMID.com.example.app",
                "paths": ["/product/*", "/profile/*", "/search"]
            }
        ]
    }
}

appID σχηματίζεται ως Team ID + Bundle ID (TEAMID.com.example.app). paths — ένας πίνακας προτύπων URL που πρέπει να επεξεργάζεται η εφαρμογή. Μπορούν να χρησιμοποιηθούν *, ? και σημειογραφία NOT: ["NOT /admin/*", "/product/*"]. Οι διαδρομές ελέγχονται με τη σειρά απαρίθμησης: η πρώτη αντιστοιχία καθορίζει τη συμπεριφορά. Εάν η διαδρομή δεν ταιριάζει — ο σύνδεσμος ανοίγει στο Safari.

Επεξεργασία συνδέσμου (Link Handling)

Μετά την επιτυχή επαλήθευση της συσχέτισης, το iOS προωθεί τον σύνδεσμο στην εφαρμογή. Η επεξεργασία γίνεται στο AppDelegate μέσω της μεθόδου application(_:continue:restorationHandler:) για NSUserActivity ή στο SceneDelegate μέσω της scene(_:continue:). Ο προγραμματιστής λαμβάνει ένα αντικείμενο NSUserActivity με τύπο NSUserActivityTypeBrowsingWeb, εξάγει το URL και πλοηγείται στην αντίστοιχη οθόνη.

// Επεξεργασία Universal Link στο AppDelegate
func application(
    _ application: UIApplication,
    continue userActivity: NSUserActivity,
    restorationHandler: @escaping UIUserActivityRestorationHandler
) -> Bool {
    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
          let url = userActivity.webpageURL
    else { return false }

    // Πλοήγηση στην οθόνη σύμφωνα με το URL
    DeepLinkRouter.navigate(to: url)
    return true
}

DeepLinkRouter στο παραπάνω παράδειγμα είναι μια προσαρμοσμένη κλάση που αναλύει το URL και καλεί τον αντίστοιχο συντονιστή πλοήγησης. Για SwiftUI, η επεξεργασία γίνεται μέσω της μεθόδου onOpenURL ή του modifier environment(\.openURL). Είναι σημαντικό να επεξεργάζεται όχι μόνο η εκκίνηση στο προσκήνιο (foreground), αλλά και η περίπτωση όπου η εφαρμογή δεν έχει εκκινηθεί (cold start): το Universal Link σε αυτή την περίπτωση ανοίγει την εφαρμογή μέσω των επιλογών εκκίνησης.

Fallback στον περιηγητή (Browser Fallback)

Εάν η εφαρμογή δεν είναι εγκατεστημένη, το iOS ανοίγει αυτόματα το Universal Link στο Safari. Αυτή είναι η κύρια διαφορά από το Custom URL Scheme: ο χρήστης δεν βλέπει σφάλμα. Το fallback είναι μια τυπική ιστοσελίδα του ίδιου τομέα. Ο προγραμματιστής μπορεί να τοποθετήσει σε αυτήν τη σελίδα έναν σύνδεσμο προς το App Store, πληροφορίες προϊόντος ή εναλλακτικό περιεχόμενο.

Σημαντικό: το fallback δεν μπορεί να προσαρμοστεί σε επίπεδο iOS. Το iOS απλώς ανοίγει το URL στο Safari. Για να εμφανίζεται διαφορετικό περιεχόμενο σε χρήστες με εγκατεστημένη και μη εγκατεστημένη εφαρμογή, χρησιμοποιήστε το Smart App Banner (meta-ετικέτα για το Safari που προτείνει το άνοιγμα της εφαρμογής) ή ανίχνευση εγκατάστασης εφαρμογής μέσω JavaScript. Η Apple παρέχει επίσης το SKAdNetwork για την απόδοση εγκαταστάσεων μέσω Universal Link.

Universal Link vs Deep Link

Το Universal Link και το παραδοσιακό Deep Link (Custom URL Scheme) λύνουν την ίδια εργασία, αλλά διαφέρουν θεμελιωδώς στην αρχιτεκτονική και την ασφάλεια. Custom URL Scheme — ένα προσαρμοσμένο πρωτόκολλο (myapp://) που καταχωρείται στο Info.plist. Οποιαδήποτε εφαρμογή μπορεί να καταχωρήσει το ίδιο σχήμα (myapp://), και το iOS δεν μπορεί να προσδιορίσει ποια είναι η "πραγματική". Αυτό ονομάζεται URL Scheme hijacking.

Universal Link λύνει το πρόβλημα hijacking μέσω επαλήθευσης τομέα. Μόνο ο κάτοχος του τομέα μπορεί να τοποθετήσει το apple-app-site-association στον διακομιστή του, επιβεβαιώνοντας τη σύνδεση με ένα συγκεκριμένο Bundle ID. Δύο εφαρμογές δεν μπορούν να καταχωρήσουν ένα Universal Link: εάν προκύψει σύγκρουση, το iOS δίνει προτεραιότητα στην τελευταία εγκατεστημένη εφαρμογή ή ανοίγει το Safari.

Άλλη διαφορά: Fallback. Το Custom URL Scheme δεν έχει fallback — εάν η εφαρμογή δεν είναι εγκατεστημένη, ο περιηγητής εμφανίζει σφάλμα. Το Universal Link ανοίγει τον ιστότοπο. Το ενιαίο URL σημαίνει ότι η SEO αξία του συνδέσμου διατηρείται (ο σύνδεσμος ευρετηριάζεται από την Google) και ο χρήστης με οποιαδήποτε συσκευή λαμβάνει σχετικό περιεχόμενο. Το Universal Link είναι ένα εξελικτικό βήμα από το deep link στο unified link.

Ρύθμιση Universal Link

Ρύθμιση του Universal Link περιλαμβάνει το τμήμα διακομιστή και το τμήμα πελάτη. Τμήμα διακομιστή — τοποθέτηση του αρχείου apple-app-site-association στη διεύθυνση https://domain/.well-known/apple-app-site-association. Τμήμα πελάτη — καταχώρηση του τομέα στο Associated Domains στο Xcode (Capabilities → Associated Domains → applinks:example.com). Μετά από αυτό, η εφαρμογή λαμβάνει αυτόματα όλα τα Universal Link για τον καθορισμένο τομέα.

Βήματα ρύθμισης:

1. Δημιουργήστε το apple-app-site-association με σωστό appID (TeamID.BundleID) και paths
2. Τοποθετήστε το αρχείο στον διακομιστή στη διαδρομή /.well-known/ χωρίς επέκταση .json
3. Ελέγξτε την προσβασιμότητα: curl https://domain/.well-known/apple-app-site-association
4. Προσθέστε τον τομέα στο Associated Domains (Xcode Capabilities)
5. Υλοποιήστε την επεξεργασία μέσω NSUserActivity (AppDelegate ή SceneDelegate)
6. Δοκιμάστε σε πραγματική συσκευή (ο προσομοιωτής δεν επαληθεύει τη συσχέτιση)

Εντοπισμός σφαλμάτων Universal Link — συχνός πονοκέφαλος για προγραμματιστές iOS. Κύριες αιτίες μη λειτουργικών συνδέσμων: το αρχείο apple-app-site-association δεν είναι προσβάσιμο μέσω HTTPS, λανθασμένο appID, Content-Type διαφορετικό από application/json, ανακατεύθυνση από τη διαδρομή /.well-known, προσωρινή αποθήκευση παλιάς έκδοσης (επαναφορά μέσω Settings → Developer → Associated Domains Development). Η Apple παρέχει το εργαλείο "Validation Checker" στο Apple Developer Console για τη δοκιμή συσχέτισης.

Branch και άλλες πλατφόρμες MMP απλοποιούν τη ρύθμιση του Universal Link: δημιουργούν αυτόματα το apple-app-site-association και το φιλοξενούν στον δικό τους τομέα. Ο προγραμματιστής χρειάζεται απλώς να προσθέσει τον τομέα Branch στο Associated Domains και να ενσωματώσει το SDK. Αυτό είναι ιδιαίτερα βολικό για νεοφυείς επιχειρήσεις που δεν έχουν τη δική τους υποδομή διακομιστή για τη φιλοξενία του αρχείου AASA.

Περιορισμοί και συμβατότητα

Universal Link έχει αρκετούς περιορισμούς. Πρώτον: το αρχείο apple-app-site-association πρέπει να είναι προσβάσιμο αυστηρά μέσω HTTPS (το HTTP δεν υποστηρίζεται). Δεύτερον: ο σύνδεσμος πρέπει να οδηγεί στον ίδιο τομέα που καθορίζεται στο Associated Domains. Οι διατομεακοί Universal Link δεν λειτουργούν — για κάθε τομέα απαιτείται ξεχωριστή καταχώρηση στο Capabilities και ξεχωριστό αρχείο AASA. Τρίτον: το Universal Link δεν λειτουργεί σε WKWebView — μόνο στο Safari και σε στοιχεία συστήματος.

Συμβατότητα: iOS 9.0+ (Universal Link), watchOS 6.0+ (Handoff Universal Link), macOS 10.15+ (Catalyst και εφαρμογές Mac). Σε παλαιότερες εκδόσεις iOS, ο σύνδεσμος ανοίγει στο Safari. Αυτό σημαίνει ότι σε iOS 8 (λιγότερο από 1% των συσκευών) το Universal Link δεν θα λειτουργήσει. Συνιστάται η υποστήριξη και του Custom URL Scheme ως fallback για παλαιές συσκευές, εάν το κοινό περιλαμβάνει χρήστες με παλαιότερες εκδόσεις.

Αλλαγές iOS 16+: Η Apple βελτίωσε την επεξεργασία του Universal Link για SwiftUI. Εμφανίστηκε ένας νέος modifier environment(\.openURL) με δυνατότητα καθυστερημένης επεξεργασίας. Το iOS 16 επιτρέπει επίσης το άνοιγμα του Universal Link στην εφαρμογή ακόμη και μέσω SFSafariViewController. Για χρήστες iOS 16, συνιστάται η πλήρης μετάβαση στην επεξεργασία Universal Link σε SwiftUI, διατηρώντας τον κώδικα AppDelegate μόνο για συμβατότητα προς τα πίσω.