Кастомные 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-разработкой более 5 лет, реализовали 40+ проектов разной сложности — от стартапов до enterprise-решений с миллионами пользователей. Каждый проект проходит через 3 этапа Code Review, собственный набор UI-тестов (в среднем 150+ тест-кейсов) и обязательный прогон через Xcode Instruments до релиза.

Нативная iOS-разработка на Swift — это прямой доступ к платформе. Без прослойки, без компромиссов по производительности, с полным контролем над тем, что происходит на каждом кадре.

Почему нативная разработка iOS на Swift — выбор для enterprise-приложений?

Нативный код даёт гарантию совместимости с новыми API Apple в день их выхода, а не через месяцы адаптации в кроссплатформенных фреймворках. Для приложений с чувствительной к задержкам логикой (финансовые терминалы, медицинские мониторы, AR-навигация) это критично. Swift с ARC и строгой типизацией позволяет держать crash-free rate на уровне 99.9% при правильной архитектуре.

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)]. При среднем бюджете проекта в 5 миллионов рублей экономия может составить до 3 миллионов рублей только на UI-слое.

@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 — навигацией.

Как async/await и Combine работают вместе

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

// Правильно — @MainActor гарантирует UI-обновления на main thread
@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 {
            // handle error
        }
    }
}

Combine остаётся незаменимым для дебаунсинга ввода, объединения нескольких Publishers (CombineLatest, Zip) и функциональной обработки потока значений (map, flatMap, filter). На практике 80% проектов используют оба подхода, выбирая инструмент под задачу.

Архитектура 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 недели уходят на проектирование, после чего мы фиксируем сроки и бюджет. Средний бюджет на разработку среднего iOS-приложения — от 4 до 7 миллионов рублей в зависимости от сложности интеграций.

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