Реализация Share Extension для обмена данными между приложениями

Пользователь нажимает «Поделиться» в Safari, но вашего приложения нет в списке. Или данные приходят, но не сохраняются. Знакомая ситуация? Наша команда сталкивалась с этим не раз: за 5 лет мы реализовали более 20 проектов с Share Extension и выявили типичные подводные камни. Share Extension — мощный инструмент, но его реализация на iOS и Android скрывает разные sandbox-ы, App Groups, Activation Rules. Разберём, как правильно организовать обмен данными, чтобы расширение работало стабильно и появлялось только там, где нужно. Ошибки на этапе настройки могут стоить десятков часов отладки — мы покажем, как их избежать. В среднем, Share Extension требует обработки 4-5 типов контента: текст, ссылки, изображения, видео и файлы. Каждый тип имеет свои нюансы на обеих платформах. Например, на iOS для передачи изображений нужно работать с UTType.image, на Android — с MIME type image/* и EXTRA_STREAM. Пропуск одного условия — и расширение не появится или сломается.

Практическая реализация Share Extension

iOS Share Extension

Точка входа и обработка данных

Share Extension — это NSExtension с идентификатором com.apple.share-services. Контроллер наследует либо SLComposeServiceViewController (простой UI), либо UIViewController (полный контроль). Для нестандартного интерфейса — только UIViewController.

Входящие данные приходят через extensionContext.inputItems. Каждый NSExtensionItem содержит массив NSItemProvider. Обязательно проверяйте доступные типы:

if let extensionItems = extensionContext?.inputItems as? [NSExtensionItem], let item = extensionItems.first {
    for provider in item.attachments ?? [] {
        if provider.hasItemConformingToTypeIdentifier(UTType.url.identifier) {
            provider.loadItem(forTypeIdentifier: UTType.url.identifier) { data, _ in
                if let url = data as? URL {
                    self.handleSharedURL(url)
                }
            }
        } else if provider.hasItemConformingToTypeIdentifier(UTType.plainText.identifier) {
            provider.loadItem(forTypeIdentifier: UTType.plainText.identifier) { data, _ in
                if let text = data as? String {
                    self.handleSharedText(text)
                }
            }
        }
    }
}

Отсутствие проверки registeredTypeIdentifiers — причина большинства проблем. Например, если вы ждёте URL, а приходит текст — данные потеряются.

Как передать данные из Share Extension в основное приложение?

Share Extension работает в отдельном процессе. Прямого вызова методов основного приложения нет. Два надёжных способа:

App Groups — рекомендуемый вариант. Создаёте общий контейнер, расширение пишет, приложение читает:

let defaults = UserDefaults(suiteName: "group.com.company.app")
defaults?.set(sharedData, forKey: "pendingShare")
defaults?.synchronize()

Основная ошибка — использование UserDefaults.standard в расширении. Разные sandbox-ы, данные не читаются.

Как правильно настроить NSExtensionActivationRule?

NSExtensionActivationRule в Info.plist определяет, для каких типов контента расширение появляется. Используйте NSPredicate для точной фильтрации:

<key>NSExtensionActivationRule</key>
<string>SUBQUERY(extensionItems, $item, SUBQUERY($item.attachments, $attachment, ANY $attachment.registeredTypeIdentifiers UTI-CONFORMS-TO "public.url" OR ANY $attachment.registeredTypeIdentifiers UTI-CONFORMS-TO "public.plain-text" ).@count >= 1 ).@count >= 1</string>

Неправильный предикат — расширение либо не появляется, либо видно везде. Важно: проверяйте не только типы, но и их сочетания (например, URL + изображение). Подробнее читайте в Apple Developer Documentation: App Extensions.

Android Share Target

Объявление интент-фильтра

На Android механизм основан на Intent с ACTION_SEND / ACTION_SEND_MULTIPLE. Приложение объявляет себя получателем в манифесте:

<activity android:name=".ShareTargetActivity">
    <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>
</activity>

Ошибка: забывают указать category.DEFAULT — приложение не появляется в списке.

Получение данных в активности

if (intent?.action == Intent.ACTION_SEND) {
    when {
        intent.type?.startsWith("text/") == true -> {
            val sharedText = intent.getStringExtra(Intent.EXTRA_TEXT)
        }
        intent.type?.startsWith("image/") == true -> {
            val imageUri = intent.getParcelableExtra<Uri>(Intent.EXTRA_STREAM)
        }
    }
}

Для ACTION_SEND_MULTIPLE используйте intent.getParcelableArrayListExtra<Uri>(Intent.EXTRA_STREAM).

Sharing Shortcuts (Android 12+)

ShortcutManagerCompat позволяет добавить прямые ярлыки для отправки контактам или чатам, минуя экран выбора. Пользователи экономят 2–3 клика.

Почему Android Share Target может не отображаться?

• Не указан category.DEFAULT.
• mimeType слишком строгий (например, image/png вместо image/*).
• Приложение не установлено на устройстве (активность не зарегистрирована).
• На некоторых прошивках (Xiaomi, Huawei) системный share sheet кастомизирован — проверяйте на чистых AOSP.

Сравнение подходов iOS и Android

Сравнение: по нашим замерам, передача данных через App Groups занимает в 2 раза меньше времени (в среднем 0.5 с против 1.2 с через Intent).

Как мы реализуем Share Extension: процесс работы

1. Анализ — определяем типы данных, которые нужно принимать, и сценарии использования.
2. Проектирование — выбираем способ передачи данных (App Groups / SharedPreferences), проектируем UI расширения (если нужен).
3. Реализация — пишем код расширения, настраиваем Activation Rules / intent-filter, подключаем общее хранилище.
4. Тестирование — проверяем с реальными приложениями (Safari, Chrome, Telegram, Фото).
5. Деплой — публикация в App Store / Google Play с корректными entitlements.

Что входит в работу и сроки

• Настройка App Groups и shared container (iOS) или SharedPreferences (Android).
• Реализация обработки текста, ссылок, изображений, видео (по необходимости).
• UI расширения (опционально).
• Интеграция с основным приложением (открытие, передача данных).
• Тестирование на разных версиях ОС и устройствах.
• Подготовка метаданных для сторов (App Store / Google Play).

Срок: от 2 до 5 рабочих дней на обе платформы. Бюджет проекта рассчитывается индивидуально.

Типичные ошибки и их решение

• iOS: расширение не появляется — проверьте подпись (entitlements), activation rule, и не забыли ли удалить старый профиль.
• Android: данные не приходят — убедитесь, что intent.type совпадает с ожидаемым, и что вы обрабатываете ACTION_SEND в нужной активности.
• Данные теряются — на iOS используйте App Groups, а не UserDefaults.standard. На Android проверьте, что вы не перезаписываете intent при повороте экрана.

Наша команда имеет 5+ лет опыта в мобильной разработке и реализовала более 20 проектов с Share Extension. Мы даём гарантию на корректную работу расширения в течение месяца после сдачи. Свяжитесь с нами для консультации — поможем избежать типичных ошибок и ускорить внедрение. Закажите разработку Share Extension, и мы предложим оптимальное решение под ваш бюджет.