App Clip: temel kavramlar, iOS uygulamasının hafif sürümü

App Clip nedir?

App Clip, tam bir uygulamanın küçük bir bölümünü kurulum gerektirmeden başlatmaya izin veren Apple'ın iOS teknolojisidir. Bir kullanıcı NFC etiketi, QR kodu veya App Clip Code taradığında, işletim sistemi App Clip'i indirir ve mevcut ekranın üstünde bir kart olarak açar. Apple, App Clip'i “ödeme yap, sipariş ver veya kaydol” senaryoları için tasarladı — sürtünme ve bekleme olmadan gerçekleştirilmesi gereken eylemler.

App Clip geçici modda çalışır. iOS, App Clip verilerini sınırlı bir süre (genellikle birkaç gün veya kullanıcı açıkça silene kadar) saklar. Kullanıcının aynı işleve tekrar ihtiyacı olursa, App Clip yeniden indirilir. Apple, sürekli kullanım için tam uygulamanın kurulumunu teşvik etmek amacıyla App Clip'in kalıcılığını kasıtlı olarak sınırlar. App Clip'te oluşturulan veriler, CloudKit aracılığıyla kurulum sırasında otomatik olarak tam uygulamaya aktarılır.

Gerçek örnekler: bir restoran masasındaki NFC etiketini tarayarak sipariş verme ve ödeme (Panera, Pizza Hut), kiralık bir scooter'daki QR kodu kilidini açmak için (Lime, Bird), bir parkmetredeki App Clip Code ile ödeme (PayByPhone), bir mağazadaki ürünü tarayarak satın alma (Shopify). Tüm bu senaryolar ortak bir şeyi paylaşır — kurulum adımının olmamasından fayda sağlayan işlemsel bir görev.

Başlatma tetikleyicileri: NFC, QR, App Clip Code

App Clip beş mekanizma aracılığıyla etkinleştirilir. En yaygın olanları NFC etiketleri (dokunma App Clip'i başlatır), QR kodları (kamera taraması ekranın altında App Clip kartını gösterir) ve App Clip Codes'dur (desenli kenarlığı ve yerleşik NFC etiketi olan Apple'a özel görsel kodlar). App Clip ayrıca Safari App Banner ve iMessage bağlantıları aracılığıyla da başlatılır.

App Clip Code, Apple'ın patentli teknolojisidir. QR kodlarının aksine, App Clip Codes estetik görünür — marka renklerini ve merkezde bir logoyu destekler, URL kenarlarda ses benzeri dalgalarla kodlanmıştır. Kod, yerleşik bir NFC etiketi içerir ve ikili bir başlatma mekanizması sağlar: görsel tarama ve dokunma. Apple, App Store Connect portalı aracılığıyla App Clip Code oluşturma araçları sağlar.

// SceneDelegate.swift — NSUserActivity aracılığıyla App Clip başlatma işleme
import UIKit

class SceneDelegate: UIResponder, UIWindowSceneDelegate {

    var window: UIWindow?

    func scene(_ scene: UIScene,
                willContinueUserActivityWithType userActivityType: String) {
        // Gelen NSUserActivity için hazırlık
    }

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

        guard let invocationURL = userActivity.webpageURL else { return }

        // URL ayrıştırma ve gerekli ekrana gezinme
        handleInvocationURL(invocationURL)
    }

    private func handleInvocationURL(_ url: URL) {
        // Örnek: /order/restaurantID — sipariş ekranı
        // Örnek: /pay/parkingID — ödeme ekranı
    }
}

Tüm tetikleyiciler sonuçta, çağrı bağlamını içeren bir webpageURL parametresine sahip bir NSUserActivity oluşturur. App Clip bu URL'yi ayrıştırır ve ilgili ekranı görüntüler. App Clip ayrıca coğrafi konum tetikleyicilerini de destekler — iOS, kullanıcı belirli bir konumun yakınındayken (örneğin, App Clip'i olan bir kafenin yakınında) bir App Clip önerebilir.

Swift ile App Clip geliştirme

App Clip geliştirme, tam uygulamanın mevcut Xcode projesinden başlar. Yeni bir App Clip hedefi eklersiniz — aynı projeyi, aynı ekibi ve paylaşılan kodun çoğunu kullanır. App Clip hedefi yalnızca belirli işlev için gereken dosyaları, storyboard'ları ve kaynakları içerir. Apple, önceden yapılandırılmış entitlements ve Info.plist anahtarlarıyla birlikte bir App Clip şablonu sağlar.

// AppClip/ProductViewModel.swift — App Clip ve tam uygulama arasında paylaşılan mantık
import Foundation
import StoreKit

class ProductViewModel: ObservableObject {

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

    func checkout() {
        // API aracılığıyla sipariş gönderme
    }

    func showInstallPrompt() {
        // Tam uygulamayı yüklemek için SKOverlay gösterme
        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 — App Clip ana ekranı
class MainViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // App Clip kartı için kompakt UI
        // Boyutu azaltmak için SF Symbols kullanma
        // Yalnızca geçerli işlem için veri yükleme
    }

    @IBAction func openFullApp(_ sender: Any) {
        // App Store'da uygulama sayfasını açma
        guard let url = URL(string: "https://apps.apple.com/app/id123456789") else { return }
        UIApplication.shared.open(url)
    }
}

App Clip hedefi, ana uygulamayla aynı Apple Developer Team ID ve Bundle ID'sini (.Clip sonekiyle) kullanır. Temel entitlements: com.apple.developer.app-clip ve URL işleme için ilişkili alanlar. App Clip, Apple Pay, Sign in with Apple, StoreKit (satın almalar için) ve Core Location'ı destekler. Bazı framework'ler kullanılamaz: arka plan modları, HealthKit, Media Library ve bazı sensör API'leri.

Boyut sınırlamaları ve optimizasyon

App Clip boyut sınırı Apple tarafından sıkı bir şekilde kontrol edilir — sıkıştırılmış halde 10 MB'ı geçmez. Kontrol, App Store'a yükleme aşamasında gerçekleştirilir; sınırı aşan yapılar reddedilir. Boyut, ikili kodu, kaynakları (storyboard'lar, asset katalogları) ve bağlı framework'leri içerir. Swift çalışma zamanı kitaplıkları iOS'un bir parçasıdır ve sayılmaz, ancak üçüncü taraf framework'ler boyutu artırır.

Xcode, arşivleme sonrası Organizer'da bir App Clip boyut raporu sağlar. Rapor, boyutu bileşene (kod, kaynaklar, framework'ler) göre ayırır ve tahmini indirme boyutunu gösterir. Apple, farklı dağıtım kanallarındaki sıkıştırma farklılıklarını hesaba katmak için App Clip'in 8 MB içinde tutulmasını önerir.

App Clip kullanıcı senaryosu

App Clip kullanım senaryosu dört aşamadan oluşur. Keşif: kullanıcı fiziksel dünyada bir NFC etiketi, QR kodu veya App Clip Code ile karşılaşır. Başlatma: tarama veya dokunma App Clip'i yükler (2 saniyeden az, genellikle 1 saniye). Etkileşim: App Clip, tek bir işlevle (sipariş, ödeme veya rezervasyon ekranı) bir kart olarak açılır. Tamamlama: kullanıcı görevi tamamlar ve SKOverlay veya App Store bağlantısı aracılığıyla tam uygulamayı yüklemek için bir teklif görür.

Apple, App Clip'te gizliliğe özel önem verir. Sistem, App Clip için kamera, konum ve bildirim izinlerini ayrı ayrı ister. App Clip'te oluşturulan veriler (ödeme bilgileri, tercihler) yerel olarak depolanır ve kurulum sırasında CloudKit aracılığıyla tam uygulamaya aktarılır. App Clip hassas izinler (Health, Motion, Media Library) isteyemez — bunlar tam uygulamanın kurulumunu gerektirir.

Önemli bir özellik, App Clip ekranının alt kısmında görünen ve tam uygulamayı yüklemeyi öneren yerel bir iOS öğesi olan SKOverlay'dir. SKOverlay, App Store'a gitmeyi gerektirmez ve mevcut uygulama bağlamında çalışır. Kullanıcı tek bir dokunuşla tam uygulamayı yükleyebilir ve App Clip, kurulumdan sonra oluşturulan tüm verileri otomatik olarak aktarır.

App Clip vs Android Instant App

Her iki teknoloji — App Clip ve Android Instant App — aynı sorunu çözer: kurulum gerektirmeden yerel bir uygulamayı anında başlatma, ancak farklı platform yaklaşımları kullanır. App Clip daha sınırlıdır (yalnızca iOS, daha küçük ekosistem), ancak Apple Pay ve Apple cihaz ekosistemiyle derin entegrasyon sunar. Instant Apps, daha geniş Android erişimi ve ek altyapı gerektirmeyen standart QR kodları dahil esnek tetikleyicilerle kazanır.