Інтеграція з Apple Shortcuts у iOS застосунку через App Intents

Ви створили мобільний застосунок, і користувачі хочуть автоматизувати сценарії через Shortcuts. Без інтеграції з Shortcuts через App Intents їхні можливості обмежені — доводиться вручну відкривати застосунок для кожної дії. Цей фреймворк став стандартом для автоматизації iOS, дозволяючи виконувати завдання без відкриття застосунку.

Ми реалізуємо глибоку інтеграцію: від базових команд до передачі складних даних між діями. Наш досвід — понад 20 успішних проєктів для iOS, що гарантує сумісність з останніми версіями системи та відсутність багів при автоматизації.

Чому варто обрати App Intents замість SiriKit?

До появи App Intents інтеграція будувалася на SiriKit з .intentdefinition файлами та INExtension в окремому таргеті. Це вимагало багато шаблонного коду та кодогенерації. З виходом iOS, що підтримує App Intents (починаючи з iOS 16), з'явився AppIntents framework. Він простіший: менше коду, Intents видимі в Shortcuts без додаткового налаштування. Для порівняння:

App Intents виграє за всіма параметрами для нових проєктів. В розробці він у 3 рази швидший за SiriKit — менше коду і менше шаблонів. Ми рекомендуємо мігрувати з SiriKit, якщо ваш застосунок все ще використовує старий підхід. Міграція скорочує час розробки нових автоматизацій на 40%.

Як App Intents спрощують розробку?

Мінімальний Intent для Shortcuts:

struct StartWorkoutIntent: AppIntent { static var title: LocalizedStringResource = "Начать тренировку" static var description = IntentDescription( "Запускает тренировку в приложении", categoryName: "Тренировки" ) static var openAppWhenRun: Bool = false // не открывать приложение @Parameter(title: "Тип тренировки") var workoutType: WorkoutType func perform() async throws -> some IntentResult & ProvidesDialog { try await WorkoutService.shared.start(type: workoutType) return .result(dialog: "Тренировка \(workoutType.name) началась") } } 

openAppWhenRun: Bool = false — ключове для автоматизацій. Intent виконується в фоні без відкриття застосунку. Для Shortcuts це критично — інакше при автоматизації екран спалахне і відкриється ваш UI.

Що таке AppEntity і навіщо він потрібен?

Статичні параметри (String, Int, Bool, Date) — просто властивості з @Parameter. Динамічні — через AppEntity з AppEntityQuery.

enum WorkoutType: String, AppEnum { case running, cycling, swimming static var typeDisplayRepresentation = TypeDisplayRepresentation(name: "Тип тренировки") static var caseDisplayRepresentations: [WorkoutType: DisplayRepresentation] = [ .running: "Бег", .cycling: "Велосипед", .swimming: "Плавание" ] } 

AppEnum — закритий список. AppEntity + AppEntityQuery — динамічний список з бази даних застосунку. Якщо користувач додав кастомний тип тренування, він має з'явитися в Shortcuts як опція — це тільки через AppEntityQuery.entities(matching:).

Як передавати дані між діями в Shortcuts?

Shortcuts дозволяє передавати результат однієї дії в іншу. Для цього Intent має повернути конкретний тип, а не просто діалог.

func perform() async throws -> some IntentResult & ReturnsValue<WorkoutSummary> { let summary = try await WorkoutService.shared.getLastSummary() return .result(value: summary) } 

WorkoutSummary — структура з AppEntity або базовим типом. Тепер наступний блок в Shortcuts може отримати ці дані як параметр.

App Shortcuts: фрази без налаштування

AppShortcutsProvider — фрази, які працюють без ручного налаштування користувачем:

struct FitnessAppShortcuts: AppShortcutsProvider { static var appShortcuts: [AppShortcut] { AppShortcut( intent: StartWorkoutIntent(), phrases: [ "Начни тренировку в \(.applicationName)", "Запусти \(.applicationName)" ], shortTitle: "Начать тренировку", systemImageName: "figure.run" ) } static var shortcutTileColor: ShortcutTileColor = .teal } 

Фраза з \(.applicationName) — обов'язкова. Apple перевіряє наявність імені застосунку у фразі на рев'ю (App Store Review Guidelines Section 4.2). Без нього — rejection.

Зараз можна використовувати параметри прямо у фразах: "Начни бег в \(.applicationName)" — Siri розпізнає «бег» як значення параметра workoutType.

Віджети та Shortcuts разом

Кнопки у віджетах використовують той самий AppIntent. Один Intent — працює і як дія в Shortcuts, і як кнопка у віджеті, і як голосова команда. Це значно спрощує розробку: логіка написана один раз.

Етапи інтеграції App Intents

1. Аналіз сценаріїв: Визначаємо, які дії користувачі хочуть автоматизувати.
2. Проектування Struct-моделі: Створюємо AppIntent, AppEntity, AppEnum для кожної дії.
3. Реалізація perform(): Пишемо логіку виконання з підтримкою фонового режиму.
4. Налаштування AppShortcutsProvider: Локалізуємо фрази для Siri та Shortcuts.
5. Тестування: Перевіряємо на симуляторі та реальних пристроях, включаючи автоматизації.
6. Деплой: Відправляємо збірку в App Store Connect і перевіряємо рев'ю.

Тестування

У симуляторі: Settings → Siri & Search → [застосунок] — показує зареєстровані Intents. Застосунок Shortcuts на симуляторі дозволяє додати Intent в automation вручну і виконати.

Для App Shortcuts: XCTest з XCTOSSignpostExpectation або просто запуск через Shortcuts.app і перевірка результату.

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

• Розробка Intents з урахуванням ваших бізнес-сценаріїв.
• Налаштування AppEntity та AppEntityQuery для динамічних даних.
• Інтеграція AppShortcutsProvider з локалізованими фразами.
• Тестування на реальних пристроях та симуляторах.
• Документація щодо використання та підтримки.

Терміни та вартість

Базова інтеграція 3–5 Intent без AppEntity: 2–4 тижні. Повна інтеграція з AppEntity, App Shortcuts, передачею значень між діями: 5–9 тижнів. Міграція з SiriKit Intents на App Intents: 3–6 тижнів. Вартість розраховується індивідуально залежно від кількості та складності дій. Зв'яжіться з нами для оцінки вашого проєкту — ми підготуємо кошторис і терміни під ключ. Отримайте консультацію, щоб дізнатися, як App Intents може скоротити ваші витрати на розробку автоматизацій.

Додаткову інформацію можна знайти в офіційній документації Apple.

Важно: App Intents не вимагають додаткових дозволів, крім випадків використання приватних даних — у таких ситуаціях необхідно налаштувати App Tracking Transparency.