App Clip: concetti chiave, versione leggera dell'app iOS

Cos'è App Clip?

App Clip è la tecnologia di Apple per iOS che consente di avviare una piccola parte di un'app completa senza installarla. Quando un utente scansiona un tag NFC, un codice QR o un App Clip Code, il sistema operativo scarica e apre App Clip come una scheda sopra lo schermo corrente. Apple ha progettato App Clip per scenari di “pagare, ordinare o registrarsi” — azioni che devono essere eseguite senza attriti e attese.

App Clip funziona in modalità effimera. iOS conserva i dati di App Clip per un tempo limitato (di solito diversi giorni o fino alla cancellazione esplicita da parte dell'utente). Se l'utente necessita nuovamente della stessa funzione, App Clip viene scaricato di nuovo. Apple limita intenzionalmente la persistenza di App Clip per incoraggiare l'installazione dell'app completa per un uso continuativo. I dati creati in App Clip vengono automaticamente trasferiti all'app completa al momento dell'installazione tramite CloudKit.

Esempi reali: scansione di un tag NFC su un tavolo di ristorante per ordinare e pagare (Panera, Pizza Hut), un codice QR su uno scooter a noleggio per sbloccarlo (Lime, Bird), un App Clip Code su un parcometro per pagare (PayByPhone), scansione di un prodotto in un negozio per acquistarlo (Shopify). Tutti questi scenari condividono una caratteristica — un'attività transazionale che beneficia dell'assenza di un passaggio di installazione.

Trigger di avvio: NFC, QR, App Clip Code

App Clip viene attivato attraverso cinque meccanismi. I più comuni sono tag NFC (il tocco avvia App Clip), codici QR (la scansione con la fotocamera mostra la scheda App Clip in basso sullo schermo) e App Clip Codes (codici visivi proprietari Apple con bordo decorato e tag NFC integrato). App Clip si avvia anche tramite Safari App Banner e collegamenti iMessage.

App Clip Code è la tecnologia brevettata da Apple. A differenza dei codici QR, gli App Clip Codes hanno un aspetto estetico — supportano i colori del marchio e un logo al centro, con l'URL codificato in onde simili a suoni lungo i bordi. Il codice contiene un tag NFC integrato, fornendo un doppio meccanismo di avvio: scansione visiva e tocco. Apple fornisce strumenti di generazione App Clip Code attraverso il portale App Store Connect.

// SceneDelegate.swift — gestione dell'avvio di App Clip tramite NSUserActivity
import UIKit

class SceneDelegate: UIResponder, UIWindowSceneDelegate {

    var window: UIWindow?

    func scene(_ scene: UIScene,
                willContinueUserActivityWithType userActivityType: String) {
        // Preparazione per NSUserActivity in arrivo
    }

    func scene(_ scene: UIScene,
                continue userActivity: NSUserActivity) {

        guard let invocationURL = userActivity.webpageURL else { return }

        // Analisi dell'URL e navigazione verso la schermata richiesta
        handleInvocationURL(invocationURL)
    }

    private func handleInvocationURL(_ url: URL) {
        // Esempio: /order/restaurantID — schermata ordine
        // Esempio: /pay/parkingID — schermata pagamento
    }
}

Tutti i trigger creano infine un NSUserActivity con un parametro webpageURL che contiene il contesto di invocazione. App Clip analizza questo URL e mostra la schermata corrispondente. App Clip supporta anche trigger di geolocalizzazione — iOS può suggerire un App Clip quando l'utente si trova vicino a una posizione specifica (ad esempio, vicino a un bar con App Clip).

Sviluppo di App Clip in Swift

Lo sviluppo di App Clip inizia da un progetto Xcode esistente dell'app completa. Si aggiunge un nuovo target App Clip — utilizza lo stesso progetto, lo stesso team e la maggior parte del codice condiviso. Il target App Clip include solo i file, gli storyboard e le risorse necessari per la funzione specifica. Apple fornisce un modello App Clip con entitlements e chiavi Info.plist preconfigurati.

// AppClip/ProductViewModel.swift — logica condivisa tra App Clip e l'app completa
import Foundation
import StoreKit

class ProductViewModel: ObservableObject {

    @Published var items: [Product] = []
    @Published var total: Decimal = 0

    func checkout() {
        // Invio ordine tramite API
    }

    func showInstallPrompt() {
        // Visualizzazione di SKOverlay per installare l'app completa
        guard let scene = UIApplication.shared()
            .connectedScenes
            .first(where: { $0 is UIWindowScene }) as? UIWindowScene else { return }

        let overlay = SKOverlay(configuration: SKOverlay.AppClipConfiguration(
            position: .bottom
        ))
        overlay.present(in: scene)
    }
}

// AppClip/MainViewController.swift — schermata principale di App Clip
class MainViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Interfaccia compatta per la scheda App Clip
        // Utilizzo di SF Symbols per ridurre le dimensioni
        // Caricamento solo dei dati per la transazione corrente
    }

    @IBAction func openFullApp(_ sender: Any) {
        // Apertura della pagina dell'app nell'App Store
        guard let url = URL(string: "https://apps.apple.com/app/id123456789") else { return }
        UIApplication.shared.open(url)
    }
}

Il target App Clip utilizza lo stesso Apple Developer Team ID e Bundle ID dell'app principale (con il suffisso .Clip). Entitlements chiave: com.apple.developer.app-clip e domini associati per la gestione degli URL. App Clip supporta Apple Pay, Sign in with Apple, StoreKit per gli acquisti e Core Location. Alcuni framework non sono disponibili: modalità background, HealthKit, Media Library e alcune API dei sensori.

Limiti di dimensione e ottimizzazione

Il limite di dimensione di App Clip è strettamente controllato da Apple — non più di 10 MB compressi. Il controllo viene effettuato nella fase di caricamento su App Store; le build che superano il limite vengono rifiutate. La dimensione include il codice binario, le risorse (storyboard, cataloghi asset) e i framework collegati. Le librerie runtime di Swift fanno parte di iOS e non vengono conteggiate, ma i framework di terze parti aumentano la dimensione.

Xcode fornisce un rapporto sulla dimensione di App Clip in Organizer dopo l'archiviazione. Il rapporto suddivide la dimensione per componente (codice, risorse, framework) e mostra la dimensione di download stimata. Apple raccomanda di mantenere App Clip entro 8 MB per considerare le variazioni di compressione sui diversi canali di distribuzione.

Scenario utente di App Clip

Lo scenario di utilizzo di App Clip si compone di quattro fasi. Scoperta: l'utente incontra un tag NFC, un codice QR o un App Clip Code nel mondo fisico. Avvio: la scansione o il tocco carica App Clip (meno di 2 secondi, di solito 1 secondo). Interazione: App Clip si apre come una scheda con una singola funzione — una schermata di ordine, pagamento o prenotazione. Completamento: l'utente completa l'attività e vede un'offerta per installare l'app completa tramite SKOverlay o un collegamento all'App Store.

Apple presta particolare attenzione alla privacy in App Clip. Il sistema richiede autorizzazioni per fotocamera, geolocalizzazione e notifiche separatamente per App Clip. I dati creati in App Clip (informazioni di pagamento, preferenze) vengono memorizzati localmente e trasferiti all'app completa tramite CloudKit al momento dell'installazione. App Clip non può richiedere autorizzazioni sensibili (Health, Motion, Media Library) — queste richiedono l'installazione dell'app completa.

Una caratteristica importante è SKOverlay, un elemento nativo iOS che appare nella parte inferiore dello schermo di App Clip e offre di installare l'app completa. SKOverlay non richiede di andare all'App Store e funziona nel contesto dell'app corrente. L'utente può installare l'app completa con un tocco, e App Clip trasferisce automaticamente tutti i dati creati dopo l'installazione.

App Clip vs Android Instant App

Entrambe le tecnologie — App Clip e Android Instant App — risolvono lo stesso problema: avvio istantaneo di un'app nativa senza installazione, ma utilizzano approcci di piattaforma diversi. App Clip è più limitato (solo iOS, ecosistema più piccolo), ma offre un'integrazione profonda con Apple Pay e l'ecosistema di dispositivi Apple. Le Instant Apps vincono con una portata Android più ampia e trigger flessibili, inclusi i codici QR standard senza infrastruttura aggiuntiva.