В Android есть два способа обмена данными между приложениями:
- Панель "Поделиться" в Android в основном предназначена для отправки контента за пределы приложения или напрямую другому пользователю. Например, вы можете поделиться URL с другом.
- Android Intent Resolver лучше всего подходит для передачи данных на следующий этап четко определенной задачи. Например, если вы открываете PDF-файл из приложения, то можете позволить пользователям выбрать средство просмотра.
Преимущества панели "Поделиться"
Используйте панель "Поделиться" в Android, чтобы обеспечить единообразие для пользователей в разных приложениях. Не показывайте собственный список получателей и не создавайте собственные варианты панели "Поделиться".
Панель "Поделиться" в Android позволяет пользователям отправлять информацию нужным людям и предлагает подходящие приложения. Все это можно сделать одним нажатием. Панель «Поделиться» может предлагать цели, недоступные для пользовательских решений, и использует согласованное ранжирование. Это связано с тем, что Sharesheet может учитывать информацию о действиях приложения и пользователя, которая доступна только системе.
Кроме того, в ней есть много полезных функций для разработчиков. Например, вы можете:
- Как узнать, когда и куда пользователи отправляют контент
- Добавление таргетинга со специальными настройками и таргетинга на приложения
- Предварительный просмотр форматированного контента (начиная с Android 10, уровень API 29)
- Как исключить цели, соответствующие определенным названиям компонентов
Как использовать панель "Поделиться" в Android
Для всех типов обмена создайте намерение и задайте для него действие Intent.ACTION_SEND.
Чтобы показать панель "Поделиться" в Android, вызовите Intent.createChooser(), передав объект Intent.
Он возвращает версию вашего намерения, которая всегда показывает панель "Поделиться".
Отправка текстового контента
Самый простой и распространенный способ использования панели "Поделиться" – отправка текстового контента из одного действия в другое. Например, большинство браузеров могут передавать URL текущей страницы в виде текста в другое приложение. Это удобно, если вы хотите поделиться статьей или сайтом с друзьями по электронной почте или в социальной сети. В Jetpack Compose получите текущий контекст с помощью LocalContext.current и вызовите context.startActivity().
Вот пример того, как это сделать:
fun shareText(context: Context) { val sendIntent: Intent = Intent().apply { action = ACTION_SEND putExtra(Intent.EXTRA_TEXT, "This is my text to send.") type = "text/plain" } val shareIntent = Intent.createChooser(sendIntent, null) context.startActivity(shareIntent) }
При необходимости вы можете добавить дополнительные данные, например получателей письма (EXTRA_EMAIL, EXTRA_CC, EXTRA_BCC) или тему письма (EXTRA_SUBJECT).
Примечание. Некоторые почтовые приложения, например Gmail, ожидают String[] для дополнительных параметров, таких как EXTRA_EMAIL и EXTRA_CC. Чтобы добавить их в намерение, используйте putExtra(String, String[]).
Отправка двоичного контента
Поделитесь двоичными данными с помощью действия ACTION_SEND.
Установите соответствующий MIME-тип и поместите URI в данные в дополнительном поле EXTRA_STREAM, как показано в следующем примере.
Обычно это используется для обмена изображением, но может использоваться для обмена любым типом двоичного контента.
fun shareBinaryContent(context: Context) { val shareIntent: Intent = Intent().apply { action = ACTION_SEND // Example: content://com.google.android.apps.photos.contentprovider/... val imageUri: Uri = Uri.parse("content://com.google.android.apps.photos.contentprovider/0/1/mediakey/1") putExtra(Intent.EXTRA_STREAM, imageUri) type = "image/jpeg" } context.startActivity(Intent.createChooser(shareIntent, null)) }
Приложению-получателю требуется разрешение на доступ к данным, на которые указывает Uri. Это можно сделать двумя способами:
- Храните данные в собственном
ContentProvider, убедившись, что у других приложений есть разрешение на доступ к вашему поставщику. Предпочтительный механизм предоставления доступа – использование разрешений для отдельных URI. Они являются временными и предоставляют доступ только принимающему приложению. Чтобы создать такой объектContentProvider, используйте вспомогательный классFileProvider. - Используйте системный
MediaStore.MediaStoreв основном используется для MIME-типов видео, аудио и изображений. Однако начиная с Android 3.0 (API уровня 11) в нем также можно хранить и другие типы файлов. Дополнительную информацию можно найти в статьеMediaStore.Files. Файлы можно вставить вMediaStoreс помощьюscanFile(), после чегоUriв стилеcontent://, подходящий для совместного использования, передается в предоставленный обратный вызовonScanCompleted(). Обратите внимание, что после добавления в системуMediaStoreконтент становится доступен любому приложению на устройстве.
Используйте правильный MIME-тип
Укажите наиболее точный MIME-тип для отправляемых данных. Например, для обычного текста используйте text/plain. Вот несколько распространенных MIME-типов, используемых при отправке данных в Android:
| Получатели регистрируются для | Отправители отправляют |
|---|---|
text/* |
|
image/* |
|
video/* |
|
| Поддерживаемые расширения имени файла | application/pdf |
Чтобы динамически определять MIME-тип во время выполнения, а не задавать его в коде, используйте следующие методы:
- Для URI
content://(например, предоставляемыхFileProviderилиMediaStore) вызовитеContentResolver.getType(). - Для расширений имени файла вызовите
MimeTypeMap.getSingleton().getMimeTypeFromExtension(). - Если вы используете Storage Access Framework, то можете также запрашивать
DocumentFile.getType().
Если вы не можете определить конкретный MIME-тип, используйте application/octet-stream для общих двоичных данных или */* в крайнем случае.
Дополнительную информацию о MIME-типах можно найти в официальном реестре MIME-типов медиаконтента IANA.
В зависимости от MIME-типа на панели "Поделиться" может показываться предпросмотр контента. Некоторые предварительные версии функций доступны только для определенных типов.
Как поделиться несколькими объектами контента
Чтобы поделиться несколькими фрагментами контента, используйте действие ACTION_SEND_MULTIPLE вместе со списком URI, указывающих на контент. MIME-тип зависит от того, какой контент вы передаете. Например, если вы делитесь тремя изображениями в формате JPEG, используйте тип "image/jpg". Для разных типов изображений используйте "image/*", чтобы сопоставить действие, которое обрабатывает любой тип изображения. Хотя вы можете передавать данные разных типов, мы не рекомендуем этого делать, поскольку получателю будет сложно понять, что именно вы хотите отправить. Если вам нужно отправить несколько типов, используйте "*/*". Приложение-получатель должно проанализировать и обработать ваши данные. Рассмотрим пример.
fun shareMultiple(context: Context) { val imageUris: ArrayList<Uri> = arrayListOf( Uri.parse("content://com.google.android.apps.photos.contentprovider/0/1/mediakey/1"), Uri.parse("content://com.google.android.apps.photos.contentprovider/0/1/mediakey/2") ) val shareIntent = Intent().apply { action = Intent.ACTION_SEND_MULTIPLE putParcelableArrayListExtra(Intent.EXTRA_STREAM, imageUris) type = "image/*" } context.startActivity(Intent.createChooser(shareIntent, null)) }
Убедитесь, что предоставленные объекты Uri указывают на данные, к которым у приложения-получателя есть доступ.
Добавление расширенного контента в предварительный просмотр текста
Начиная с Android 10 (уровня API 29) на панели "Поделиться" показывается предварительный просмотр текста, которым вы делитесь. В некоторых случаях текст, которым вы делитесь, может быть трудно понять. Представьте, что вам нужно поделиться сложным URL, например https://www.google.com/search?ei=2rRVXcLkJajM0PEPoLy7oA4. Более подробный предпросмотр может убедить пользователей в том, что именно передается.
Если вы хотите показать текст, то можете добавить заголовок, значок или и то, и другое. Добавьте описание в Intent.EXTRA_TITLE перед вызовом Intent.createChooser() и добавьте подходящий значок с помощью ClipData.
Примечание. URI контента изображения предоставляется из FileProvider, обычно из настроенного <cache-path>.
Подробнее о предоставлении доступа к файлам… Убедитесь, что у Sharesheet есть разрешение на чтение изображения, которое вы хотите использовать в качестве значка. Дополнительную информацию вы найдете здесь: Intent.FLAG_GRANT_READ_URI_PERMISSION.
Рассмотрим пример.
fun richContentToTextPreviewShares(context: Context) { val share = Intent.createChooser( Intent().apply { action = ACTION_SEND putExtra(Intent.EXTRA_TEXT, "https://developer.android.com/training/sharing/") // (Optional) Here you're setting the title of the content putExtra(Intent.EXTRA_TITLE, "Introducing content previews") // (Optional) Here you're passing a content URI to an image to be displayed data = Uri.parse("content://com.google.android.apps.photos.contentprovider/0/1/mediakey/A123456789") flags = Intent.FLAG_GRANT_READ_URI_PERMISSION }, null ) context.startActivity(share) }
Предварительная версия выглядит примерно так:
Как добавить собственные действия в меню "Поделиться"
В Android 14 (уровень API 34) и более поздних версиях приложения могут добавлять на панель "Поделиться" настраиваемые действия.
Настраиваемые действия показываются в виде небольших значков в верхней части панели "Поделиться". Приложения могут указывать любой объект Intent в качестве действия, которое выполняется при нажатии на значок.
Чтобы добавить настраиваемые действия на панель "Поделиться" в Android, сначала создайте ChooserAction с помощью ChooserAction.Builder.
В качестве действия, выполняемого при нажатии на значок, можно указать PendingIntent. Создайте массив, содержащий все ваши настраиваемые действия, и укажите его как EXTRA_CHOOSER_CUSTOM_ACTIONS для Intent.
fun sharesheetCustomActions(context: Context, previewText: String) { val sendIntent = Intent(ACTION_SEND) .setType("text/plain") .putExtra(Intent.EXTRA_TEXT, previewText) val shareIntent = Intent.createChooser(sendIntent, null) val customActions = arrayOf( ChooserAction.Builder( Icon.createWithResource(context, R.drawable.ic_logo), "Custom", PendingIntent.getBroadcast( context, 1, Intent(Intent.ACTION_VIEW), PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_CANCEL_CURRENT ) ).build() ) shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, customActions) context.startActivity(shareIntent) }
Добавьте собственные цели
Панель "Поделиться" в Android позволяет указать до двух намерений для специальных действий, которые будут показываться перед рекомендуемыми приложениями. Для этого используется Intent.EXTRA_INITIAL_INTENTS.
Для получателей Direct Share (например, чатов или контактов) публикуйте динамические ярлыки с помощью ShortcutManagerCompat (см. раздел Предоставление получателей Direct Share).
Добавьте Intent.EXTRA_INITIAL_INTENTS в намерение поделиться после вызова Intent.createChooser():
val sendIntent = Intent(ACTION_SEND).apply { type = "text/plain" putExtra(Intent.EXTRA_TEXT, previewText) } val customIntent = Intent().apply { component = ComponentName(context.packageName, "${context.packageName}.CustomActivity") } val shareIntent = Intent.createChooser(sendIntent, null).apply { putExtra( Intent.EXTRA_INITIAL_INTENTS, arrayOf(customIntent) ) } context.startActivity(shareIntent)
Используйте эту функцию с осторожностью. Каждый добавленный вами специальный Intent уменьшает количество предложенных системой. В целом, избегайте добавления пользовательских целей. Распространенный пример добавления Intent.EXTRA_INITIAL_INTENTS – предоставление дополнительных действий, которые пользователи могут выполнять с общим контентом. Например, пользователь делится изображениями, и Intent.EXTRA_INITIAL_INTENTS используется, чтобы позволить ему отправить ссылку.
Как исключить определенные цели по компоненту
Вы можете исключить определенные цели, указав Intent.EXTRA_EXCLUDE_COMPONENTS.
Удаляйте только те цели, которые вы контролируете. Например, если пользователь хочет поделиться контентом из вашего приложения, то, скорее всего, он хочет отправить его в другое приложение. В этом случае можно скрыть цели обмена данными в вашем приложении.
Добавьте Intent.EXTRA_EXCLUDE_COMPONENTS в намерение после вызова Intent.createChooser():
fun excludeSpecificTargets(context: Context) { val share = Intent.createChooser(Intent(ACTION_SEND), null).apply { // Only use for components you have control over val excludedComponentNames = arrayOf(ComponentName("com.example.android", "ExampleClass")) putExtra(Intent.EXTRA_EXCLUDE_COMPONENTS, excludedComponentNames) } context.startActivity(share) }
Как получить информацию о доступе к файлу
Вам может быть полезно знать, когда пользователи делятся файлами и какие целевые аудитории они выбирают. Панель "Поделиться" в Android позволяет получить эту информацию, предоставляя ComponentName целей, которые выбирают пользователи, с помощью IntentSender.
Сначала создайте PendingIntent для BroadcastReceiver и укажите его IntentSender в Intent.createChooser():
fun infoAboutSharing(context: Context, requestCode: Int) { var share = Intent(ACTION_SEND) // ... val pi = PendingIntent.getBroadcast( context, requestCode, Intent(context, ShareBroadcastReceiver::class.java), PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT ) share = Intent.createChooser(share, null, pi.intentSender) context.startActivity(share) }
Получите обратный вызов в MyBroadcastReceiver и посмотрите в Intent.EXTRA_CHOOSER_RESULT:
override fun onReceive(context: Context?, intent: Intent) { val TAG = ShareBroadcastReceiver::class.simpleName val chooserResult: ChooserResult? = IntentCompat.getParcelableExtra( intent, Intent.EXTRA_CHOOSER_RESULT, ChooserResult::class.java, ) chooserResult?.let { Log.i(TAG, "Share callback: isShortcut: ${it.isShortcut}, type: ${typeToString(it.type)}, componentName: ${it.selectedComponent}", ) } ?: Log.i(TAG, "chooserResult is null") }
Подробную информацию можно найти в примере отчета о доле платформы.
Используйте средство разрешения намерений Android
ACTION_SENDIntent Resolver.Средство выбора Intent в Android лучше всего использовать при отправке данных в другое приложение в рамках четко определенного рабочего процесса.
Чтобы использовать средство разрешения намерений Android, создайте намерение и добавьте дополнительные параметры, как при вызове панели "Поделиться". Однако не вызывайте Intent.createChooser().
Если на устройстве установлено несколько приложений с фильтрами, соответствующими ACTION_SEND и MIME-типу, система показывает диалоговое окно Intent Resolver, в котором пользователь может выбрать приложение для отправки контента. Если совпадение одно, запускается соответствующее приложение.
Вот пример того, как использовать средство разрешения намерений Android для отправки текста:
fun intentResolver(context: Context) { val sendIntent: Intent = Intent().apply { action = ACTION_SEND putExtra(Intent.EXTRA_TEXT, "This is my text to send.") type = "text/plain" } context.startActivity(sendIntent) }
Подробнее…
Подробнее об отправке данных…