Розробка Share Extension для Android: intent-filter та Direct Share

Розробка розширення для Share Sheet (Android)

Користувач натиснув Share, але ваш додаток не з'явився у списку. Або з'явився, але впав з SecurityException. Знайома ситуація? Типові причини — неправильний intent-filter або відсутність обробки ContentResolver. Розберемо, як побудувати надійний Share Extension, який коректно приймає будь-які типи контенту — від тексту до відео — та персоналізує шеринг через Direct Share.

В Android 10+ модель доступу до файлів змінилася: прямий шлях до файлу не отримати. Кожен content:// URI потребує тимчасового дозволу, який діє тільки під час активності Activity. Ігнорування цього правила веде до падінь на Android 11 та вище. Ми розповімо, як уникнути цих помилок та забезпечити стабільну обробку контенту на всіх актуальних версіях.

Наше рішення включає перевірені патерни: роздільні intent-filter для кожного MIME-типу, безпечне копіювання файлів через ContentResolver та персоналізований Direct Share для підвищення конверсії. Ви отримаєте готовий код, який вже протестовано на Android 10–14. Це економить час на налагодження та гарантує сумісність.

Як налаштувати intent-filter для декількох MIME-типів?

Головна помилка — один фільтр на все. Система Android погано обробляє декілька <data> всередині одного <intent-filter>. Правильний підхід: створюємо окремі фільтри для text/plain, image/*, video/*, application/octet-stream. Приклад:

<intent-filter>
    <action android:name="android.intent.action.SEND" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:mimeType="text/plain" />
</intent-filter>
<intent-filter>
    <action android:name="android.intent.action.SEND" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:mimeType="image/*" />
</intent-filter>

Для SEND_MULTIPLE додаємо аналогічні фільтри. Це гарантує появу додатку в Chooser для кожного типу.

Як обробляти URI без втрати даних?

Uri з Intent.EXTRA_STREAM живе тільки під час активності (якщо не взято persistedUriPermission). Читати його потрібно через ContentResolver.openInputStream(), а не File(). Ми копіюємо файл в cacheDir одразу:

val inputStream = contentResolver.openInputStream(sourceUri)
val destFile = File(cacheDir, "shared_${System.currentTimeMillis()}.jpg")
inputStream?.use { it.copyTo(destFile.outputStream()) }

Так файл доступний навіть після завершення Activity. На Android 10+ прямий доступ до /data/ заблоковано, тому цей pattern обов'язковий.

Чому Direct Share збільшує конверсію?

Direct Share показує персоналізованих отримувачів прямо в системному шерингу. За даними A/B-тестів, конверсія таких шерингів вища в 2–3 рази порівняно з базовим Chooser. Реалізується через ShortcutManagerCompat.pushDynamicShortcut() з категорією SHORTCUT_CATEGORY_CONVERSATION:

val shortcut = ShortcutInfoCompat.Builder(context, "chat_anna")
    .setShortLabel("Анна")
    .setLongLived(true)
    .setCategories(setOf(ShortcutInfoCompat.SHORTCUT_CATEGORY_CONVERSATION))
    .setIntent(Intent(context, ChatActivity::class.java).apply { putExtra("user_id", 42) })
    .build()
ShortcutManagerCompat.pushDynamicShortcut(context, shortcut)

Це окрема робота: потрібно підтримувати актуальність shortcuts, оновлювати аватарки, реагувати на зміни контактів. Але результат того вартий.

Порівняння підходів

Типові проблеми та їх рішення

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

• Аналіз типів контенту, які повинен приймати додаток.
• Проектування intent-filter та UI вибору (при необхідності).
• Реалізація Activity-приймача з обробкою URI та копіюванням.
• Налаштування Direct Share з підтримкою актуальних shortcuts.
• Тестування на Android 10–14 з реальними файлами та текстом.
• Документація з інтеграції та підтримка при деплої.
• Економія часу на налагодження за рахунок готових рішень.

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

1. Аналіз — вивчаємо типи контенту, які ваш додаток повинен приймати.
2. Проектування — вибираємо схему intent-filter, проектуємо UI вибору (якщо потрібно).
3. Розробка — пишемо Activity-приймач, обробляємо URI, реалізуємо копіювання.
4. Тестування — перевіряємо на Android 10, 12, 14 з різними файлами та текстом.
5. Деплой — публікуємо в Google Play, налаштовуємо Google Play Console для прийому посилань.

Строки та вартість

Оцінимо ваш проект за 1–2 дні. Базове розширення — від 2 тижнів. Складні інтеграції — до 6 тижнів. Вартість фіксується після узгодження ТЗ. У нас 5+ років досвіду в Android-розробці, понад 20 успішних Share Extension. Отримайте готове рішення з гарантією сумісності на Android 10–14. Замовте розробку Share Extension прямо зараз — почнемо з консультації.

Згідно з Android Developer Guide, для надійного прийому контенту використовуйте окремі intent-filter на кожен MIME-тип.

Зв'яжіться з нами, щоб обговорити ваш проект та отримати індивідуальну пропозицію.

Розробка віджетів, App Clips та Live Activities: точки входу поза додатком

Ми знаємо: користувач бачить додаток не тільки всередині. Віджет на домашньому екрані, живий рахунок матчу в Dynamic Island, міні-досвід без встановлення — це окремі точки входу. За 5 років ми розробили понад 50 розширень — від простих інформаційних віджетів до App Clips з платіжними сценаріями. Економія часу клієнта на повторних входах — до 30%. Ми — сертифіковані розробники Apple і Google, гарантуємо сумісність з останніми версіями SDK.

Розробка віджетів WidgetKit: чому не можна просто «додати віджет»

WidgetKit працює через Timeline Provider — віджет не живе в пам'яті постійно, а запитує знімки даних заздалегідь. Найчастіша помилка: розробник намагається показати дані в реальному часі через URLSession прямо з getTimeline(). Apple цього не забороняє, але при агресивному оновленні система починає троттлити запити, і віджет застигає на застарілих даних.

Правильний підхід: основний додаток оновлює дані через WidgetCenter.shared.reloadTimelines(ofKind:) після отримання push-сповіщення або при поверненні в foreground. Віджет читає дані з shared App Group контейнера через UserDefaults(suiteName:) або файлового сховища. Жодних прямих мережевих запитів у провайдері в продакшні.

У новітніх версіях iOS з'явився AppIntent-based interactive widget — кнопки та тогли прямо на віджеті без відкриття додатку. Реалізується через Button(intent:) у SwiftUI-розмітці. Працює тільки для простих дій; складна логіка повинна переходити в додаток через widgetURL.

Як Live Activities змінюють користувацький досвід?

Live Activities — механізм для відображення живих даних на Lock Screen та в Dynamic Island (iPhone 14 Pro+). Запускаються через ActivityKit, оновлюються через push-сповіщення типу liveactivity з корисним навантаженням до 4KB.

Архітектурно це окремий SwiftUI-таргет з двома представленнями: компактним (Dynamic Island) та розгорнутим (Lock Screen). Дані передаються через ActivityAttributes — строго типізовану структуру. Динамічна частина — ContentState, статична (не змінюється за час активності) — в ActivityAttributes безпосередньо.

Типова проблема: Live Activity не оновлюється, хоча push надсилається. Причина — додаток не має permission на background push або apns-push-type виставлений неправильно. У production потрібен apns-push-type: liveactivity і токен з activity.pushToken. Без коректного push-токена Activity не отримає оновлень — це підтверджено документацією Apple.

Коли використовувати App Clips, а коли Instant Apps?

App Clips (iOS) та Instant Apps (Android) вирішують схоже завдання — дати функціональність без встановлення повного додатку. Реалізація принципово різна.

App Clip — окремий таргет у Xcode, максимум 15MB, запускається через NFC-мітку, QR-код, Safari Smart App Banner або посилання в Messages. Доступ до даних обмежений: немає Keychain sharing з основним додатком без явного налаштування, немає доступу до HealthKit, немає push-сповіщень (тільки ephemeral). App Clip Card налаштовується в App Store Connect — помилки в метаданих часта причина відмови в рев'ю.

Android Instant Apps будуються на модульній архітектурі: додаток ділиться на feature-модулі, кожен може бути завантажений окремо через Play Feature Delivery. Instant App — це feature-модуль з <dist:module dist:instant="true">. Обмеження — не більше 15MB сумарно для instant delivery.

Порівняння показує: App Clips виграють у сценаріях з оплатою завдяки інтеграції з Apple Pay — конверсія вища на 20% порівняно з Instant Apps в аналогічних кейсах. Instant Apps краще підходять для ігрових демо та сервісів, де потрібен швидкий доступ через Google Search.

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

• Аудит поточної архітектури: визначаємо, які точки входу потрібні — віджет, Live Activity, App Clip, Instant App.
• Прототипування: візуальна модель розширення з урахуванням гайдлайнів платформи (Apple HIG, Material Design).
• Розробка: реалізація на Swift (iOS) або Kotlin (Android) з використанням WidgetKit, ActivityKit, App Clip API, Play Feature Delivery.
• Інтеграція: налаштування App Group, Keychain sharing, push-сертифікатів, provisioning profile.
• Тестування: на реальних пристроях (iPhone, iPad, Android) та в симуляторах. Для Live Activities — тест через xcrun simctl push.
• Публікація: підготовка метаданих для App Store Connect (App Clip Card) та Google Play Console (Instant App configuration).
• Документація та навчання: опис архітектури, інструкції з оновлення віджетів, troubleshooting push-сповіщень.

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

1. Аналітика: які функції додатку реально потрібні поза ним, і який механізм підходить. Віджет з прогнозом — WidgetKit. Трекінг доставки — Live Activity. Оплата на касі — App Clip.
2. Проектування: вибір стеку, схеми оновлення даних (Timeline, push), UI-макети для компактного та розгорнутого представлення.
3. Реалізація: написання коду на Swift/Kotlin, налаштування App Group, push-сертифікатів, тестових схем.
4. Тест: кожне розширення тестується ізольовано. WidgetKit-рендеринг перевіряється через Xcode Widget Gallery, Live Activities — через симулятор з примусовим надсиланням push.
5. Деплой: публікація в сторах, моніторинг метрик (частота оновлень, кількість запусків App Clip).

Строки орієнтовно

Вартість розраховується індивідуально після аудиту. Оцінка надається протягом 2 робочих днів.

Типові помилки при розробці розширень

• Занадто часте оновлення віджета — призводить до троттлінгу та порожнього стану. Рекомендуємо інтервал не менше 15 хвилин (див. Apple Human Interface Guidelines, WidgetKit documentation).
• Ігнорування shared container — віджет не бачить дані, тому що використовує свій UserDefaults, а не App Group.
• Відсутність fallback для Live Activities — якщо push не доставлений, користувач бачить застарілі дані. Потрібен механізм періодичного опитування через Activity.update з pushType: nil.
• Неправильні метадані App Clip Card — часта причина відхилення в App Store Review. Наприклад, некоректний URL або відсутній значок.

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