Пользователь нажимает «Поделиться» в 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 работает в отдельном процессе. Прямого вызова методов основного приложения нет. Два надёжных способа:
| Метод | iOS | Android |
|---|---|---|
| Общее хранилище | App Groups + UserDefaults / CoreData | SharedPreferences / файл |
| Intent / URL Scheme | open(_:completionHandler:) (не гарантирован) |
Intent.EXTRA_TEXT / EXTRA_STREAM |
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
| Критерий | iOS | Android |
|---|---|---|
| Точка входа | NSExtension (отдельный процесс) | Activity с intent-filter |
| Типы данных | UTIs (public.url, public.plain-text) | MIME types (text/plain, image/*) |
| Передача данных | App Groups (shared container) | Intent extras |
| Активация | NSExtensionActivationRule (предикат) | intent-filter (action + mime) |
| Современные фичи | — | Sharing Shortcuts (Android 12+) |
Сравнение: по нашим замерам, передача данных через App Groups занимает в 2 раза меньше времени (в среднем 0.5 с против 1.2 с через Intent).
Как мы реализуем Share Extension: процесс работы
- Анализ — определяем типы данных, которые нужно принимать, и сценарии использования.
- Проектирование — выбираем способ передачи данных (App Groups / SharedPreferences), проектируем UI расширения (если нужен).
- Реализация — пишем код расширения, настраиваем Activation Rules / intent-filter, подключаем общее хранилище.
- Тестирование — проверяем с реальными приложениями (Safari, Chrome, Telegram, Фото).
- Деплой — публикация в 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, и мы предложим оптимальное решение под ваш бюджет.