App Clip: ключови понятия, лека версия на iOS приложението

Какво е App Clip?

App Clip — технология на Apple за iOS, която позволява стартиране на малка част от пълно приложение без неговото инсталиране. Когато потребителят сканира NFC етикет, QR код или App Clip Code, операционната система изтегля и отваря App Clip под формата на карта над текущия екран. Apple проектира App Clip за сценарии „плати, поръчай или се регистрирай“ — действия, които трябва да се извършват без триене и чакане.

App Clip работи в епизодичен режим. iOS съхранява данните на App Clip за ограничено време (обикновено няколко дни или до изрично изтриване от потребителя). Ако потребителят отново се нуждае от същата функция, App Clip се изтегля отново. Apple умишлено ограничава съхранението на App Clip, насърчавайки инсталирането на пълното приложение за постоянно ползване. Данните, създадени в App Clip, автоматично се прехвърлят в пълното приложение при неговото инсталиране чрез CloudKit.

Реални примери: сканиране на NFC етикет на маса в ресторант за поръчка и плащане (Panera, Pizza Hut), QR код на нает тротинетка за отключване (Lime, Bird), App Clip Code на паркометър за плащане (PayByPhone), сканиране на продукт в магазин за покупка (Shopify). Всички тези сценарии имат едно общо нещо — транзакционна задача, която печели от липсата на етап на инсталиране.

Тригери за пускане: NFC, QR, App Clip Code

App Clip се активира чрез пет механизма. Най-често срещаните — NFC етикети (докосване пуска App Clip), QR кодове (сканиране с камера показва картата на App Clip в долната част на екрана) и App Clip Codes (собствени визуални кодове на Apple с шарена рамка и вграден NFC етикет). App Clip се стартира и чрез Safari App Banner и връзки в iMessage.

App Clip Code — патентована технология на Apple. За разлика от QR кодовете, App Clip Codes изглеждат естетически — поддържат цветовете на марката и лого в центъра, а URL е кодиран в звукови вълни по краищата. Кодът съдържа вграден NFC етикет, осигуряващ двоен механизъм за стартиране: визуално сканиране и докосване. Apple предоставя инструменти за генериране на App Clip Code чрез портала App Store Connect.

// SceneDelegate.swift — обработка на стартирането на App Clip чрез NSUserActivity
import UIKit

class SceneDelegate: UIResponder, UIWindowSceneDelegate {

    var window: UIWindow?

    func scene(_ scene: UIScene,
                willContinueUserActivityWithType userActivityType: String) {
        // Подготовка за входящ NSUserActivity
    }

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

        guard let invocationURL = userActivity.webpageURL else { return }

        // Анализ на URL и преход към нужния екран
        handleInvocationURL(invocationURL)
    }

    private func handleInvocationURL(_ url: URL) {
        // Пример: /order/restaurantID — екран за поръчка
        // Пример: /pay/parkingID — екран за плащане
    }
}

Всички тригери в крайна сметка създават NSUserActivity с параметър webpageURL, който съдържа контекста на извикването. App Clip анализира този URL и показва съответния екран. App Clip също поддържа геолокационни тригери — iOS може да предложи App Clip, когато потребителят е близо до определено място (напр. близо до кафене с App Clip).

Разработка на App Clip в Swift

Разработката на App Clip започва със съществуващ Xcode проект на пълното приложение. Добавяте нов target App Clip — той използва същия проект, същия екип и по-голямата част от общия код. Target-ът App Clip включва само файловете, storyboard-ите и ресурсите, необходими за конкретната функция. Apple предоставя шаблон App Clip с предварително конфигурирани права и Info.plist ключове.

// AppClip/ProductViewModel.swift — обща логика между App Clip и пълното приложение
import Foundation
import StoreKit

class ProductViewModel: ObservableObject {

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

    func checkout() {
        // Изпращане на поръчка чрез API
    }

    func showInstallPrompt() {
        // Показване на SKOverlay за инсталиране на пълното приложение
        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
class MainViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Компактен UI за картата на App Clip
        // Използваме SF Symbols за намаляване на размера
        // Зареждаме само данни за текущата транзакция
    }

    @IBAction func openFullApp(_ sender: Any) {
        // Отваряне на страницата на приложението в App Store
        guard let url = URL(string: "https://apps.apple.com/app/id123456789") else { return }
        UIApplication.shared.open(url)
    }
}

Target-ът App Clip използва същото Apple Developer Team ID и Bundle ID като основното приложение (с наставка .Clip). Ключови права: com.apple.developer.app-clip и associated domains за обработка на URL. App Clip поддържа Apple Pay, Sign in with Apple, StoreKit за покупки и Core Location. Някои рамки не са налични: фонов режим, HealthKit, Media Library и някои сензорни API.

Ограничения на размера и оптимизация

Ограничението на размера на App Clip се контролира строго от Apple — не повече от 10 MB в компресиран вид. Проверката се извършва на етапа на качване в App Store; компилациите, надвишаващи лимита, се отхвърлят. В размера влизат двоичен код, ресурси (storyboard-ове, asset catalogs) и свързани рамки. Библиотеките на Swift runtime са част от iOS и не се броят, но рамките на трети страни увеличават размера.

Xcode предоставя отчет за размера на App Clip в Organizer след архивиране. Отчетът разделя размера по компоненти (код, ресурси, рамки) и показва приблизителния размер за изтегляне. Apple препоръчва да поддържате App Clip в рамките на 8 MB, за да се вземат предвид вариациите в компресията в различните канали за доставка.

Потребителски сценарий на App Clip

Сценарият за използване на App Clip се състои от четири етапа. Откриване: потребителят среща NFC етикет, QR код или App Clip Code във физическия свят. Стартиране: сканирането или докосването изтегля App Clip (по-малко от 2 секунди, обикновено 1 секунда). Взаимодействие: App Clip се отваря като карта с една единствена функция — екран за поръчка, плащане или резервация. Завършване: потребителят изпълнява задачата и вижда предложение за инсталиране на пълното приложение чрез SKOverlay или връзка към App Store.

Apple обръща специално внимание на поверителността в App Clip. Системата иска разрешения за камера, геолокация и известия отделно за App Clip. Данните, създадени в App Clip (платежна информация, предпочитания), се съхраняват локално и се прехвърлят в пълното приложение чрез CloudKit при неговото инсталиране. App Clip не може да иска чувствителни разрешения (Health, Motion, Media Library) — за това е необходимо инсталиране на пълното приложение.

Важна характеристика — SKOverlay, native iOS елемент, който се показва в долната част на екрана на App Clip и предлага инсталиране на пълното приложение. SKOverlay не изисква навигация до App Store и работи в контекста на текущото приложение. Потребителят може да инсталира пълното приложение с едно докосване, а App Clip автоматично прехвърля всички създадени данни след инсталирането.

App Clip срещу Android Instant App

И двете технологии — App Clip и Android Instant App — решават една и съща задача: моментално стартиране на native приложение без инсталация, но използват различни платформени подходи. App Clip е по-ограничен (само iOS, по-малка екосистема), но предлага дълбока интеграция с Apple Pay и екосистемата на Apple устройства. Instant Apps печелят благодарение на по-широкото покритие на Android и гъвкавите тригери, включително стандартни QR кодове без допълнителна инфраструктура.