Кастомні Siri Intents: від INExtension до AppIntents

Користувачі продовжують відкривати додаток вручну, тому що Siri не розуміє їхні команди. Кастомні Intents вирішують цю проблему: ви визначаєте голосові команди, Siri диктує параметри та виконує дію у фоні. Ми реалізували понад 30 проєктів із SiriKit — середня інтеграція займає 2 тижні. На відміну від базових Shortcuts, кастомні Intents підтримують діалоги з уточненням параметрів. Це знижує помилки введення та підвищує задоволеність. За внутрішніми даними, впровадження інтенцій збільшує частоту використання додатку на 15–20%. Один клієнт заощадив 2 000 000 рублів на рік на підтримці старого коду після міграції на AppIntents.

Як працює INExtension на практиці?

INExtension — процес, який запускає Siri при вимові команди. Він містить хендлери для кожного Intent, визначеного в .intentdefinition. Xcode генерує код класів Intent, Response та параметрів. Розглянемо структуру параметра:

Parameter: date
  Type: Date (INDateComponentsResolutionResult)
  Display Name: "дата"
  Prompt: "На яке число?"
  Siri Dialog: "На яке число призначити зустріч?"

Типи параметрів: String, Integer, Boolean, Date, CLPlacemark (геолокація), INPerson (контакт з адресної книги), кастомні INObject-типи для сутностей вашого додатку. Siri отримує параметри через INObject — кастомний тип, що описує сутності. У INExtension потрібно реалізувати provide…Options…Collection, який повертає об'єкти для вибору.

Проблеми, які вирішуємо

Extension не викликається — найчастіша причина. Переконайтеся, що Intent додано до NSExtension.NSExtensionAttributes.IntentsSupported в Info.plist extension, а також в основний таргет. App Group не пробрасується — extension і додаток у різних sandbox. Використовуйте FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: "group.com.yourapp") або UserDefaults(suiteName: "group.com.yourapp"). Siri не розуміє специфічні терміни — INVocabulary.shared().setVocabularyStrings(projectNames, of: .organizationName) та глобальний AppIntentVocabulary.plist для статичних термінів.

Як вирішити проблему нерозуміння термінів Siri?

Використовуйте INVocabulary та AppIntentVocabulary.plist для реєстрації назв проєктів, задач або інших сутностей. Це дозволить Siri розпізнавати їх голосом без додаткових уточнень. В одному з проєктів ми додали понад 200 термінів, і точність розпізнавання зросла з 70% до 95%.

Як ми розробляємо кастомні Intents

Перший крок — створення файлу .intentdefinition з параметрами та діалогами. Потім генеруємо Swift-класи та пишемо хендлери:

// Кастомний INObject
class ProjectObject: INObject {
    // identifier та displayString обов'язкові
}

// У IntentHandler
func provideProjectOptionsCollection(
    for intent: CreateTaskIntent,
    with completion: @escaping (INObjectCollection<ProjectObject>?, Error?) -> Void
) {
    let projects = ProjectRepository().fetchAll()
    let objects = projects.map {
        ProjectObject(identifier: $0.id, display: $0.name)
    }
    completion(INObjectCollection(items: objects), nil)
}

Resolve, Confirm, Handle — три методи життєвого циклу:

Resolve — валідація та уточнення кожного параметра:

func resolveTaskName(for intent: CreateTaskIntent,
                     with completion: @escaping (INStringResolutionResult) -> Void) {
    guard let name = intent.taskName, name.count >= 2 else {
        completion(.needsValue()) // Siri: "Як назвати задачу?"
        return
    }
    guard name.count <= 255 else {
        completion(.unsupported(forReason: .tooLong))
        return
    }
    completion(.success(with: name))
}

Confirm — фінальна перевірка:

func confirm(intent: CreateTaskIntent,
             completion: @escaping (CreateTaskIntentResponse) -> Void) {
    guard ProjectRepository().exists(id: intent.project?.identifier) else {
        let response = CreateTaskIntentResponse(code: .failure, userActivity: nil)
        response.failureReason = "Проєкт не знайдено"
        completion(response)
        return
    }
    completion(CreateTaskIntentResponse(code: .ready, userActivity: nil))
}

Handle — виконання:

func handle(intent: CreateTaskIntent,
            completion: @escaping (CreateTaskIntentResponse) -> Void) {
    let store = TaskStore(appGroup: "group.com.yourapp")
    let task = store.create(
        name: intent.taskName!,
        projectId: intent.project?.identifier,
        dueDate: intent.dueDate?.dateComponents
    )
    let response = CreateTaskIntentResponse(code: .success, userActivity: nil)
    response.task = TaskObject(identifier: task.id, display: task.name)
    completion(response)
}

Response-шаблони задаються в .intentdefinition: Siri вимовить «Задача "$(taskName)" створена в проєкті "$(project)"».

Процес роботи

1. Аналітика — вивчаємо бізнес-логіку та визначаємо команди.
2. Проєктування — створюємо .intentdefinition з параметрами та діалогами.
3. Реалізація — пишемо хендлери, INObject, інтеграцію з App Group та INVocabulary.
4. Тестування — симуляція Siri на реальному пристрої, перевірка всіх сценаріїв відмови.
5. Деплой — підготовка App Store Review, при необхідності — оновлення конфіг-файлів.

Що входить у роботу

• Файл .intentdefinition з параметрами та діалогами.
• INExtension з повним циклом resolve/confirm/handle.
• Налаштування App Group для спільної бази даних.
• Інтеграція з INVocabulary для голосового розпізнавання.
• (опціонально) Міграція на AppIntents для актуальних версій iOS.
• Документація з інтеграції.

Орієнтовні строки

Порівняння SiriKit та AppIntents

AppIntents (актуальні версії iOS) використовує async/await, більш лаконічний, підтримує SwiftUI та працює у віджетах. Старий код вимагає до 150 рядків на Intent, новий — близько 40. AppIntents у 2–3 рази швидший у реалізації та легше підтримується. Якщо ваш додаток уже використовує сучасні патерни, AppIntents — очевидний вибір. Детальніше: AppIntents.

Отримайте консультацію досвідченого розробника для оцінки вашого проєкту. Зв'яжіться з нами, щоб обговорити деталі та замовити аудит поточного SiriKit-рішення. Замовте розробку кастомних Intents — гарантуємо проходження App Store Review та повну підтримку інтеграцій.

Чому нативна розробка iOS — найкращий вибір для складних додатків

Додаток крашиться на cold start — EXC_BAD_ACCESS в момент ініціалізації синглтона, який звертається до іншого синглтона, який ще не ініціалізований. Або: ViewController витікає в пам'яті, тому що closure захоплює self без [weak self], і цей ViewController висить у пам'яті через два переходи після того, як користувач його покинув. Це не гіпотетичні сценарії — це два найпоширеніші класи проблем на iOS-проектах, які приходять до нас після іншої команди.

Ми займаємося iOS-розробкою понад 6 років, реалізували 50+ проєктів — від стартапів до enterprise-рішень з мільйонами користувачів. Кожен проєкт проходить через 3 етапи Code Review, власний набір UI-тестів (в середньому 150+ тест-кейсів) та обов'язковий прогін через Xcode Instruments до релізу. Нативна iOS-розробка на Swift — це прямий доступ до платформи. Без прошарку, без компромісів щодо продуктивності, з повним контролем над тим, що відбувається на кожному кадрі.

Чому нативна розробка iOS на Swift — вибір для enterprise-додатків?

Нативний код дає гарантію сумісності з новими API Apple у день їх виходу, а не через місяці адаптації в кроссплатформних фреймворках. Для додатків із чутливою до затримок логікою (фінансові термінали, медичні монітори, AR-навігація) це критично. Swift з ARC та строгою типізацією дозволяє тримати crash-free rate на рівні 99.9% за правильної архітектури. На практиці середній показник на наших проєктах — 99.8%, що на 15% вище середнього по ринку.

Як вибрати між SwiftUI та UIKit для нативної розробки iOS?

На сьогодні SwiftUI покриває переважну більшість production-завдань. Але UIKit не застарів і не зникне — Apple не deprecate-ить його, а продовжує додавати API. Реальна картина на великих проєктах: гібридний підхід. SwiftUI для більшості екранів, UIKit там, де SwiftUI впирається в обмеження.

Які сценарії SwiftUI виграє беззаперечно

Декларативний синтаксис SwiftUI скорочує код UI у 3–5 разів порівняно з UIKit. Екран налаштувань з List, Toggle, Picker — це 40 рядків SwiftUI проти 200 рядків UIKit з делегатами UITableViewDataSource. Економія часу на UI-розробку досягає 60%. Apple рекомендує починати нові проєкти на SwiftUI (Human Interface Guidelines).

@State, @Binding, @ObservableObject (а з iOS 17 — макрос @Observable) створюють реактивний зв'язок між даними та UI без ручного reloadData(). Зміна @State-змінної автоматично перемальовує порушену частину ієрархії. Це працює правильно, якщо розуміти, як SwiftUI обчислює diff — через Equatable та id у ForEach.

AsyncImage, NavigationStack з типобезпечним роутингом через NavigationPath, searchable, refreshable — це готові патерни, які UIKit вимагає реалізовувати вручну.

Коли UIKit залишається необхідним

UICollectionView з compositional layout та diffable data source — складні сітки з різними типами комірок, горизонтальними секціями всередині вертикального скролу, динамічними розмірами комірок. SwiftUI LazyVGrid / LazyHGrid не дають такого контролю.

Кастомні переходи між екранами. UIViewControllerAnimatedTransitioning та UIViewControllerInteractiveTransitioning — інтерактивний pop gesture з частковим прогресом, кастомний hero-перехід з точним керуванням frame. SwiftUI matchedGeometryEffect покриває частину випадків, але не всі.

UITextView з TextKit 2. Багатий редактор тексту, кастомні атрибути, кастомний рендеринг — TextKit 2 (доступний з iOS 16) перейшов на async layout, що вирішило проблеми з продуктивністю на довгих документах. SwiftUI TextEditor — це обгортка навколо UITextView без прямого доступу до TextKit.

UIScrollView з кастомною поведінкою. scrollViewDidScroll, parallax-ефекти, sticky headers з кастомною логікою, pull-to-refresh з кастомним індикатором. SwiftUI ScrollView з scrollPosition та onScrollGeometryChange (iOS 17) закриває частину випадків, але не всі.

Як ми інтегруємо SwiftUI та UIKit: крок за кроком

1. Ідентифікуємо екрани, де SwiftUI дає максимальний виграш (списки, форми, налаштування) — зазвичай 70-80% екранів.
2. Для критичних до продуктивності ділянок (складні колекції, кастомні анімації) залишаємо UIKit.
3. Використовуємо UIHostingController для вбудовування SwiftUI-в'ю в UIKit navigation stack.
4. Для зворотної сумісності обгортаємо UIKit-компоненти через UIViewRepresentable.
5. Coordinator pattern (UIKit) керує навігацією на рівні флоу, екрани реалізовані на SwiftUI.

Один патерн, який ми використовуємо на проєктах: UIKit-координатор керує навігацією, а самі екрани на SwiftUI. Координатор створює UIHostingController, передає ViewModel через ініціалізатор або @EnvironmentObject, керує переходами. Це дає чисте розділення: SwiftUI займається UI, Coordinator — навігацією. Завдяки такому підходу ми скорочуємо час дебагу на 30% порівняно з чистим UIKit.

Як async/await та Combine працюють разом?

До Swift 5.5 асинхронний код на iOS будувався на Combine або callback-ланцюжках. З появою async/await та Actor модель конкурентності стала частиною мови. На нових проєктах ми використовуємо async/await як основний інструмент для мережевих викликів та бізнес-логіки, Combine — для реактивної прив'язки UI-стану.

@MainActor
class UserViewModel: ObservableObject {
    @Published var user: User?
    @Published var isLoading = false

    func loadUser(id: String) async {
        isLoading = true
        defer { isLoading = false }
        do {
            user = try await userService.fetch(id: id)
        } catch {
            // обробити помилку
        }
    }
}

Combine залишається незамінним для дебаунсингу введення, об'єднання кількох Publishers (CombineLatest, Zip) та функціональної обробки потоку значень (map, flatMap, filter). На практиці 80% проєктів використовують обидва підходи, обираючи інструмент під задачу. Це дозволяє підвищити швидкість розробки на 20% без втрати якості.

Архітектура iOS-додатку

MVVM — базовий патерн. ViewModel містить логіку та @Published-стан, SwiftUI View підписується через @ObservedObject або @StateObject. Правило одне: View не знає про URLSession, CoreData, UserDefaults.

Clean Architecture додає шари Repository та UseCase. UserRepository абстрагує джерело даних (мережа vs кеш). FetchUserUseCase містить бізнес-правило. UserViewModel викликає UseCase та керує UI-станом.

TCA (The Composable Architecture) — більш строгий патерн від Point-Free. State, Action, Reducer, Effect — все явне, все тестоване, composable через Scope. Добре працює у великих командах (5+ iOS-розробників), де важлива передбачуваність поведінки.

Що входить у розробку iOS-додатку

Інструменти, без яких не обходиться жоден реліз

Xcode Instruments. Time Profiler показує, де CPU витрачає час. Allocations — витоки пам'яті та excessive allocations. Leaks — об'єкти, які не звільняються. Перед кожним релізом — обов'язковий прогін.

Firebase Crashlytics. Crash-free rate, групування по stack trace, breadcrumbs подій до крашу. Налаштовується за 30 хвилин, дає картину по всьому парку пристроїв. В середньому crash-free rate на наших проєктах — 99.8%.

Fastlane match. Керування сертифікатами та provisioning profiles через зашифрований git-репозиторій. Усуває «у мене локально збирається, а на CI ні» раз і назавжди. Економить до 4 годин на кожну збірку при ручному підписуванні.

XCTest + XCUITest. Unit-тести для ViewModel та UseCase, UI-тести для критичних флоу (онбординг, оплата, авторизація). В середньому код покритий на 75%.

Процес і терміни

Замовте розробку під ключ — ми оцінимо ваш проєкт за 2 робочі дні та запропонуємо оптимальну архітектуру. Зв'яжіться з нами, щоб обговорити вашу задачу: гарантуємо якість коду, дотримання App Store Review Guidelines та досвід роботи з проєктами будь-якого масштабу. Отримайте консультацію — ми допоможемо вибрати правильний стек та уникнути типових помилок на старті.