Cómo enviar datos simples a otras apps

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Android usa intents y sus servicios adicionales asociados para que los usuarios puedan compartir información de forma rápida y fácilmente con sus aplicaciones favoritas.

Los usuarios pueden compartir contenido en Android de dos formas:

• Android Sharesheet está diseñada principalmente para enviar contenido fuera de tu app o directamente. a otro usuario. (por ejemplo, para compartir una URL con un amigo)
• El agente de resolución de intent de Android es más adecuado para pasar datos al la siguiente etapa de una tarea bien definida. Por ejemplo, abrir un PDF desde tu app y permitir que los usuarios y elige su público preferido.

Cuando construyes un intent, especificas la acción que quieres que lleve a cabo. Android usa la acción ACTION_SEND para enviar datos de una actividad a otra, incluso entre límites de procesos. Debes especificar los datos y su tipo. El sistema identifica automáticamente las actividades compatibles que puede recibir los datos y mostrárselos al usuario. En el caso del agente de resolución de intents, si solo una actividad puede controlar el intent, esa actividad se inicia inmediatamente.

Por qué usar Android Sharesheet

Recomendamos usar Android Sharesheet para mantener la coherencia de las apps entre tus usuarios. No muestres la lista de destinos de uso compartido de tu app ni crees tus propias variaciones de Sharesheet.

Android Sharesheet permite que los usuarios compartan información con el la persona adecuada, con sugerencias de aplicaciones relevantes, todo con un solo toque. Sharesheet puede sugerir objetivos no disponibles para soluciones personalizadas y usa una clasificación coherente. Esto se debe a que Sharesheet puede tener en cuenta información sobre la app y la actividad del usuario que solo está disponible para el sistema.

Android Sharesheet también tiene diversas funciones útiles para desarrolladores. Por ejemplo, puedes hacer lo siguiente:

• Conocer cuándo los usuarios implementan el uso compartido y dónde
• Agrega un ChooserTarget y destinos de app personalizados
• Proporcionar vistas previas de contenido de texto enriquecido a partir de Android 10 (nivel de API 29)
• Cómo excluir destinos que coincidan con nombres de componentes específicos

Cómo usar Android Sharesheet

Para todos los tipos de uso compartido, crea un intent y establece su acción en Intent.ACTION_SEND Para mostrar Android Sharesheet, llama Intent.createChooser(), y pasarle tu objeto Intent. Se mostrará una versión de tu intent que siempre estará disponible en Android Sharesheet.

Cómo enviar contenido de texto

El uso más simple y común de Android Sharesheet es el envío de contenido de texto desde una actividad a otra. Por ejemplo, en la mayoría de los navegadores, se puede compartir la URL de la página que se muestra como texto mediante otra app. Este recurso es útil para compartir un artículo o un sitio web con amigos por correo electrónico o redes sociales. Este es un ejemplo de cómo hacerlo:

val sendIntent: Intent = Intent().apply {
    action = Intent.ACTION_SEND
    putExtra(Intent.EXTRA_TEXT, "This is my text to send.")
    type = "text/plain"
}

val shareIntent = Intent.createChooser(sendIntent, null)
startActivity(shareIntent)

Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, "This is my text to send.");
sendIntent.setType("text/plain");

Intent shareIntent = Intent.createChooser(sendIntent, null);
startActivity(shareIntent);

De manera opcional, puedes agregar servicios adicionales para incluir más información, como destinatarios de correo electrónico (EXTRA_EMAIL, EXTRA_CC o EXTRA_BCC), el asunto del correo electrónico (EXTRA_SUBJECT), etcétera.

Nota: Algunas apps de correo electrónico, como Gmail, esperan una String[] para servicios adicionales como EXTRA_EMAIL y EXTRA_CC. Usa putExtra(String, String[]) para agregarlos a tu intent.

Cómo enviar contenido binario

Comparte los datos binarios con la acción ACTION_SEND. Establece el tipo de MIME adecuado y coloca un URI en los datos en la EXTRA_STREAM, como se muestra en el siguiente ejemplo. Por lo general, se usa para compartir una imagen, pero se puede utilizar para compartir cualquier tipo de contenido binario.

val shareIntent: Intent = Intent().apply {
    action = Intent.ACTION_SEND
    // Example: content://com.google.android.apps.photos.contentprovider/...
    putExtra(Intent.EXTRA_STREAM, uriToImage)
    type = "image/jpeg"
}
startActivity(Intent.createChooser(shareIntent, null))

Intent shareIntent = new Intent();
shareIntent.setAction(Intent.ACTION_SEND);
// Example: content://com.google.android.apps.photos.contentprovider/...
shareIntent.putExtra(Intent.EXTRA_STREAM, uriToImage);
shareIntent.setType("image/jpeg");
startActivity(Intent.createChooser(shareIntent, null));

La aplicación receptora necesita permiso para acceder a los datos a los que apunta la Uri. Estas son las dos formas recomendadas de hacerlo:

• Almacena los datos en tu ContentProvider y asegúrate de que otras apps tengan el permiso adecuado para acceder a tu proveedor. El mecanismo preferido para acceder es usar permisos por URI, que son temporales y solo otorgan acceso a la aplicación receptora. Una forma fácil de crear ContentProvider de esta manera es para usar Clase auxiliar FileProvider.
• Usa la clase MediaStore del sistema. MediaStore es principalmente para video, tipos MIME de imágenes y audio. Sin embargo, a partir de Android 3.0 (API nivel 11), también puede almacenar tipos que no son de medios. Para obtener más información, consulta MediaStore.Files. Los archivos se pueden insertar en MediaStore con scanFile(). Luego, se pasa una Uri de estilo content:// adecuada para uso compartido a la devolución de llamada onScanCompleted() proporcionada. Ten en cuenta que, una vez que se agregue MediaStore al sistema, cualquier app del dispositivo podrá acceder al contenido.

Usa el tipo de MIME correcto

Proporciona el tipo de MIME más específico disponible para los datos que envías. Por ejemplo, usa text/plain cuando compartas texto sin formato. Estos son algunos ejemplos Tipos de MIME comunes cuando se envían datos simples en Android:

Para obtener más información sobre los tipos de MIME, consulta la IANA oficial de los tipos de medios MIME.

Android Sharesheet también puede mostrar una vista previa de contenido, según el tipo de MIME proporcionado. Algunas funciones de vista previa solo están disponibles para tipos específicos.

Compartir varios contenidos

Para compartir varios tipos de contenido, usa el ACTION_SEND_MULTIPLE. junto con una lista de URIs que apuntan al contenido. El tipo de MIME varía según la combinación de contenido que compartes. Por ejemplo, si compartes tres imágenes JPEG, debes usar el tipo "image/jpg". Si usas una combinación de tipos de imágenes, usa "image/*" para que coincida con un que maneja cualquier tipo de imagen. Si bien es posible compartir una combinación de tipos, no se recomienda, ya que no es claro para el receptor qué se pretende enviar. Si es necesario enviar varios tipos, usa "*/*". Corresponde a la aplicación receptora analizar y procesar los datos. Por ejemplo:

val imageUris: ArrayList<Uri> = arrayListOf(
        // Add your image URIs here
        imageUri1,
        imageUri2
)

val shareIntent = Intent().apply {
    action = Intent.ACTION_SEND_MULTIPLE
    putParcelableArrayListExtra(Intent.EXTRA_STREAM, imageUris)
    type = "image/*"
}
startActivity(Intent.createChooser(shareIntent, null))

ArrayList<Uri> imageUris = new ArrayList<Uri>();
imageUris.add(imageUri1); // Add your image URIs here
imageUris.add(imageUri2);

Intent shareIntent = new Intent();
shareIntent.setAction(Intent.ACTION_SEND_MULTIPLE);
shareIntent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, imageUris);
shareIntent.setType("image/*");
startActivity(Intent.createChooser(shareIntent, null));

Asegúrate de que los objetos Uri proporcionados apunten a los datos a los que puede acceder una aplicación receptora.

Cómo agregar contenido enriquecido a las vistas previas de texto

A partir de Android 10 (nivel de API 29), Android Sharesheet muestra una vista previa del texto que se comparte. En algunos casos, el texto que se comparte puede ser difícil de comprender. Considera compartir un URL complicada, como https://www.google.com/search?ei=2rRVXcLkJajM0PEPoLy7oA4. Una versión más completa la vista previa puede asegurarles a los usuarios lo que se comparte.

Mientras se muestra una vista previa del texto, puedes definir un título, una imagen en miniatura o ambas. Agrega una descripción a Intent.EXTRA_TITLE antes de llamar a Intent.createChooser() y agrega una miniatura relevante con ClipData.

Nota: El URI del contenido de la imagen se proporciona desde una FileProvider, por lo general, desde una <cache-path> configurada. Para obtener más información, consulta Cómo compartir archivos. Asegúrate de otorgar a Sharesheet los permisos adecuados para leer cualquier imagen que quieras usar como miniatura. Para obtener más información, consulta Intent.FLAG_GRANT_READ_URI_PERMISSION.

Por ejemplo:

 val share = Intent.createChooser(Intent().apply {
      action = Intent.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 = contentUri
      flags = Intent.FLAG_GRANT_READ_URI_PERMISSION
  }, null)
  startActivity(share)

Intent sendIntent = new Intent(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, "https://developer.android.com/training/sharing/");

// (Optional) Here you're setting the title of the content
sendIntent.putExtra(Intent.EXTRA_TITLE, "Introducing content previews");

// (Optional) Here you're passing a content URI to an image to be displayed
sendIntent.setData(contentUri);
sendIntent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);

// Show the Sharesheet
startActivity(Intent.createChooser(sendIntent, null));

La vista previa debería ser similar a la siguiente:

Agrega acciones personalizadas a la hoja compartida

Captura de pantalla de acciones personalizadas en Android Sharesheet.

En Android 14 (nivel de API 34) y versiones posteriores, las apps pueden agregar acciones personalizadas a Android Sharesheet. Las acciones personalizadas se muestran como pequeños íconos de acción en la parte superior de Android Sharesheet y las apps puede especificar cualquier Intent como la acción invocada cuando se hace clic en el ícono.

Para agregar acciones personalizadas en la hoja compartida de Android, primero crea un ChooserAction con ChooserAction.Builder. Puedes especificar un PendingIntent como la acción que se invoca cuando se hace clic en el ícono. Crea un array con todas tus acciones personalizadas y especificarlo EXTRA_CHOOSER_CUSTOM_ACTIONS del Intent compartido.

val sendIntent = Intent(Intent.ACTION_SEND)
    .setType("text/plain")
    .putExtra(Intent.EXTRA_TEXT, text)
val shareIntent = Intent.createChooser(sendIntent, null)
val customActions = arrayOf(
    ChooserAction.Builder(
        Icon.createWithResource(context, R.drawable.ic_custom_action),
        "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)

Intent sendIntent = new Intent(Intent.ACTION_SEND)
        .setType("text.plain")
        .putExtra(Intent.EXTRA_TEXT, text);
Intent shareIntent = Intent.createChooser(sendIntent, null);
ChooserAction[] actions = new ChooserAction[]{
        new ChooserAction.Builder(
                Icon.createWithResource(context, R.drawable.ic_custom_action),
                "Custom",
                PendingIntent.getBroadcast(
                        context,
                        1,
                        new Intent(Intent.ACTION_VIEW),
                        PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_CANCEL_CURRENT
                )
        ).build()
};
shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, actions);
context.startActivity(shareIntent);

Cómo agregar destinos personalizados

Android Sharesheet te permite especificar hasta dos objetos ChooserTarget que se muestran antes de los accesos directos de uso compartido y los objetivos del selector que se cargan desde ChooserTargetServices. También puedes especificar hasta dos intents que apunten a actividades enumeradas antes de las sugerencias de la aplicación:

Agrega Intent.EXTRA_CHOOSER_TARGETS y Intent.EXTRA_INITIAL_INTENTS a tu intent de uso compartido después de la llamada Intent.createChooser():

val share = Intent.createChooser(myShareIntent, null).apply {
    putExtra(Intent.EXTRA_CHOOSER_TARGETS, myChooserTargetArray)
    putExtra(Intent.EXTRA_INITIAL_INTENTS, myInitialIntentArray)
}

Intent shareIntent = Intent.createChooser(sendIntent, null);
share.putExtra(Intent.EXTRA_CHOOSER_TARGETS, myChooserTargetArray);
share.putExtra(Intent.EXTRA_INITIAL_INTENTS, myInitialIntentArray);

Usa esta función con cuidado. Cada Intent personalizado y ChooserTarget que agregues reduce la cantidad que sugiere el sistema. Por lo general, no se recomienda agregar orientaciones personalizadas. Un ejemplo común y apropiado de agregar Intent.EXTRA_INITIAL_INTENTS es proporcionar acciones adicionales que los usuarios puedan llevar a cabo en el contenido compartido. Por ejemplo, un usuario comparte imágenes y se usa Intent.EXTRA_INITIAL_INTENTS para permitirle enviar un vínculo. Una forma apropiada de agregar Intent.EXTRA_CHOOSER_TARGETS es mostrar personas o dispositivos relevantes que proporciona la aplicación.

Excluye destinos específicos por componente

Puedes excluir segmentaciones específicas si proporcionas Intent.EXTRA_EXCLUDE_COMPONENTS. Solo debes seguir estos pasos para quitar las orientaciones sobre las que tienes el control. Un caso de uso común es ocultar los destinos de uso compartido de la app cuando los usuarios comparten contenido desde la app, ya que es probable que su intent comparta desde afuera de la app.

Agrega Intent.EXTRA_EXCLUDE_COMPONENTS a tu intent después de llamar a Intent.createChooser():

  val share = Intent.createChooser(Intent(), null).apply {
    // Only use for components you have control over
    val excludedComponentNames = arrayOf(ComponentName("com.example.android", "ExampleClass"))
    putExtra(Intent.EXTRA_EXCLUDE_COMPONENTS, excludedComponentNames)
  }

  Intent shareIntent = Intent.createChooser(new Intent(), null);
  // Only use for components you have control over
  ComponentName[] excludedComponentNames = {
          new ComponentName("com.example.android", "ExampleClass")
  };
  shareIntent.putExtra(Intent.EXTRA_EXCLUDE_COMPONENTS, excludedComponentNames);

Obtener información sobre el uso compartido

Puede ser útil saber cuándo los usuarios comparten y qué destino seleccionan. El Android Sharesheet te permite obtener esta información proporcionando el ComponentName de objetivo que los usuarios seleccionan mediante un IntentSender,

Primero, crea un PendingIntent para un BroadcastReceiver y proporciona su IntentSender en Intent.createChooser():

var share = Intent(Intent.ACTION_SEND)
// ...
val pi = PendingIntent.getBroadcast(
    myContext, requestCode,
    Intent(myContext, MyBroadcastReceiver::class.java),
    PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
)
share = Intent.createChooser(share, null, pi.intentSender)

Intent share = new Intent(ACTION_SEND);
...
PendingIntent pi = PendingIntent.getBroadcast(myContext, requestCode,
        new Intent(myContext, MyBroadcastReceiver.class),
        PendingIntent.FLAG_MUTABLE | PendingIntent.FLAG_UPDATE_CURRENT);
share = Intent.createChooser(share, null, pi.getIntentSender());

Recibe la devolución de llamada en MyBroadcastReceiver y busca en Intent.EXTRA_CHOSEN_COMPONENT:

override fun onReceive(context: Context, intent: Intent) {
  ...
  val clickedComponent : ComponentName = intent.getParcelableExtra(EXTRA_CHOSEN_COMPONENT);
}

@Override public void onReceive(Context context, Intent intent) {
  ...
  ComponentName clickedComponent = intent.getParcelableExtra(EXTRA_CHOSEN_COMPONENT);
}

Agrega acciones personalizadas a Sharesheet

En Android 14 (nivel de API 34) y versiones posteriores, las apps pueden agregar acciones personalizadas a la hoja compartida de Android. Crea un ChooserAction con ChooserAction.Builder Puedes especificar un PendingIntent como la acción que se invoca cuando se hace clic en el ícono. Crea un array que contenga todas tus acciones personalizadas y especifícalo como EXTRA_CHOOSER_CUSTOM_ACTIONS del elemento Intent compartido.

val sendIntent = Intent(Intent.ACTION_SEND)
    .setType("text/plain")
    .putExtra(Intent.EXTRA_TEXT, text)
val shareIntent = Intent.createChooser(sendIntent, null)
val customActions = arrayOf(
    ChooserAction.Builder(
        Icon.createWithResource(context, R.drawable.ic_custom_action),
        "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)

Intent sendIntent = new Intent(Intent.ACTION_SEND)
        .setType("text.plain")
        .putExtra(Intent.EXTRA_TEXT, text);
Intent shareIntent = Intent.createChooser(sendIntent, null);
ChooserAction[] actions = new ChooserAction[]{
        new ChooserAction.Builder(
                Icon.createWithResource(context, R.drawable.ic_custom_action),
                "Custom",
                PendingIntent.getBroadcast(
                        context,
                        1,
                        new Intent(Intent.ACTION_VIEW),
                        PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_CANCEL_CURRENT
                )
        ).build()
};
shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, actions);
context.startActivity(shareIntent);

Cómo usar el agente de resolución de intent de Android

Captura de pantalla del agente de resolución de intent de ACTION_SEND.

El agente de resolución de intent de Android se usa mejor cuando se envían datos a otra app como parte de un flujo de tareas bien definido.

Para usar el agente de resolución de intent de Android, crea un intent y agrega extras como lo harías con una llamada. Android Sharesheet. Sin embargo, no llames Intent.createChooser()

Si hay varias aplicaciones instaladas con filtros que coinciden ACTION_SEND y el tipo de MIME, el sistema muestra un diálogo de desambiguación llamado agente de resolución de intents que permite al usuario elegir un objetivo para compartir. Si una sola aplicación coincide, se ejecuta.

A continuación, se muestra un ejemplo de cómo usar el agente de resolución de intent de Android para enviar texto:

val sendIntent: Intent = Intent().apply {
    action = Intent.ACTION_SEND
    putExtra(Intent.EXTRA_TEXT, "This is my text to send.")
    type = "text/plain"
}
startActivity(sendIntent)

Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, "This is my text to send.");
sendIntent.setType("text/plain");
startActivity(sendIntent);

Más información

Para obtener más información sobre cómo enviar datos, consulta Intents y filtros de intents.