Questa pagina è stata tradotta dall'API Cloud Translation.

Inviare dati semplici ad altre app

Android utilizza gli intent e le funzionalità aggiuntive associate per consentire agli utenti di condividere informazioni in modo rapido e facile utilizzando le proprie app preferite.

Android offre agli utenti due modi per condividere dati tra le app:

Sharesheet di Android è progettato principalmente per inviare contenuti al di fuori della tua app e/o direttamente a un altro utente. Ad esempio, quando condividi un URL con un amico.
Il resolver di intent di Android è più adatto per passare dati alla fase successiva di un'attività ben definita. Ad esempio, puoi aprire un PDF dalla tua app e consentire agli utenti di scegliere il visualizzatore che preferiscono.

Quando crei un intent, devi specificare l'azione che deve essere eseguita da quell'intent. Android utilizza l'azione ACTION_SEND per inviare dati da un'attività all'altra, anche oltre i confini dei processi. Devi specificare i dati e il tipo. Il sistema identifica automaticamente le attività compatibili che possono ricevere i dati e li mostra all'utente. Nel caso del resolver di intent, se solo un'attività può gestire l'intent, questa viene avviata immediatamente.

Perché utilizzare Android Sharesheet

Ti consigliamo vivamente di utilizzare Android Sharesheet per garantire la coerenza degli utenti tra le app. Non visualizzare l'elenco di destinazioni di condivisione della tua app e non creare varianti di Sharesheet.

Android Sharesheet consente agli utenti di condividere informazioni con la persona giusta, con suggerimenti di app pertinenti, il tutto con un solo tocco. Sharesheet può suggerire i target non disponibili per soluzioni personalizzate e utilizza un ranking coerente. Questo perché Sharesheet può prendere in considerazione informazioni sull'attività delle app e degli utenti disponibili solo per il sistema.

Android Sharesheet offre anche molte utili funzionalità per gli sviluppatori. Ad esempio, puoi:

Scoprire quando gli utenti completano una condivisione e dove
Aggiungere ChooserTarget e target dell'app personalizzati
Fornire anteprime di contenuti in formato RTF a partire da Android 10 (livello API 29)
Escludere i target che corrispondono a nomi di componenti specifici

Utilizza Android Sharesheet

Per tutti i tipi di condivisione, crea un intent e imposta la relativa azione su Intent.ACTION_SEND. Per visualizzare Android Sharesheet, chiama Intent.createChooser(), trasmettendolo il tuo oggetto Intent. Restituisce una versione del tuo intent che mostra sempre Android Sharesheet.

Invia contenuti testuali

L'uso più semplice e comune di Android Sharesheet è l'invio di contenuti testuali da un'attività a un'altra. Ad esempio, la maggior parte dei browser può condividere l'URL della pagina attualmente visualizzata sotto forma di testo con un'altra app. È utile per condividere un articolo o un sito web con gli amici via email o social network. Ecco un esempio di come procedere:

Kotlin

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)

Java

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);

Se vuoi, puoi aggiungere altri elementi per includere ulteriori informazioni, ad esempio i destinatari (EXTRA_EMAIL, EXTRA_CC, EXTRA_BCC), l'oggetto dell'email (EXTRA_SUBJECT) e così via.

Nota:alcune app email, come Gmail, prevedono un String[] per extra come EXTRA_EMAIL e EXTRA_CC. Utilizza putExtra(String, String[]) per aggiungerli al tuo intent.

Invia contenuti binari

Condividi dati binari utilizzando l'azione ACTION_SEND. Imposta il tipo MIME appropriato e inserisci un URI per i dati nell'EXTRA_STREAM aggiuntivo, come mostrato nell'esempio seguente. Di solito viene utilizzato per condividere un'immagine, ma può essere usato per condividere qualsiasi tipo di contenuto binario.

Kotlin

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))

Java

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));

L'applicazione ricevente deve avere l'autorizzazione per accedere ai dati a cui rimanda Uri. Puoi farlo in due modi:

Archivia i dati nel tuo ContentProvider, assicurandoti che le altre app dispongano dell'autorizzazione corretta per accedere al tuo provider. Il meccanismo preferito per fornire l'accesso consiste nell'utilizzare le autorizzazioni per URI, che sono temporanee e che concedono l'accesso solo all'applicazione ricevente. Un modo semplice per creare un ContentProvider come questo è usare il corso helper FileProvider.
Utilizza il sistema MediaStore. MediaStore è destinato principalmente ai tipi MIME video, audio e immagine. Tuttavia, a partire da Android 3.0 (livello API 11), è possibile archiviare anche tipi non multimediali. Per ulteriori informazioni, consulta MediaStore.Files. I file possono essere inseriti in MediaStore utilizzando scanFile(), dopodiché un Uri in stile content:// adatto alla condivisione viene trasmesso al callback onScanCompleted() fornito. Tieni presente che, una volta aggiunti al sistema MediaStore, i contenuti sono accessibili a qualsiasi app sul dispositivo.

Utilizzare il tipo MIME corretto

Fornisci il tipo MIME più specifico disponibile per i dati che invia. Ad esempio, utilizza text/plain quando condividi testo normale. Ecco alcuni tipi MIME comuni durante l'invio di dati semplici in Android:

I destinatari si registrano a	Invio dei mittenti
`text/*`	`text/plain` `text/rtf` `text/html` `text/json`
`image/*`	`image/jpg` `image/png` `image/gif`
`video/*`	`video/mp4` `video/3gp`
Estensioni dei file supportate	`application/pdf`

Attenzione:anche se puoi utilizzare un tipo MIME */*, sconsigliamo vivamente di farlo perché la maggior parte delle app di ricezione non è in grado di ricevere alcun tipo di contenuto. Idealmente, la tua app deve corrispondere ad attività in grado di gestire stream di dati generici.

Per ulteriori informazioni sui tipi MIME, consulta il registro ufficiale IANA dei tipi multimediali MIME.

Android Sharesheet potrebbe mostrare un'anteprima dei contenuti, a seconda del tipo MIME fornito. Alcune funzionalità in anteprima sono disponibili solo per tipi specifici.

Per condividere più contenuti, utilizza l'azione ACTION_SEND_MULTIPLE insieme a un elenco di URI che rimandano ai contenuti. Il tipo MIME varia a seconda del mix di contenuti condivisi. Ad esempio, se condividi tre immagini JPEG, utilizzi il tipo "image/jpg". Per una combinazione di tipi di immagini, utilizza "image/*" per trovare una corrispondenza con un'attività che gestisce qualsiasi tipo di immagine. Sebbene sia possibile condividere un mix di tipi, ti sconsigliamo vivamente di farlo perché al destinatario non è chiaro cosa vuoi inviare. Se è necessario inviare più tipi, utilizza "*/*". Spetta all'applicazione ricevente analizzare ed elaborare i dati. Ecco un esempio:

Kotlin

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))

Java

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));

Assicurati che gli oggetti Uri forniti rimandino ai dati a cui può accedere un'applicazione ricevente.

Aggiungi contenuti avanzati alle anteprime di testo

A partire da Android 10 (livello API 29), Android Sharesheet mostra un'anteprima del testo condiviso. In alcuni casi, il testo che viene condiviso può essere difficile da comprendere. Valuta la possibilità di condividere un URL complicato come https://www.google.com/search?ei=2rRVXcLkJajM0PEPoLy7oA4. Un'anteprima più completa può rassicurare gli utenti sui contenuti condivisi.

Se stai visualizzando l'anteprima del testo, puoi impostare un titolo, un'immagine in miniatura o entrambi. Aggiungi una descrizione a Intent.EXTRA_TITLE prima di chiamare Intent.createChooser() e aggiungi una miniatura pertinente utilizzando ClipData.

Nota: l'URI del contenuto dell'immagine viene fornito da un FileProvider, in genere da un <cache-path> configurato. Per ulteriori informazioni, vedi Condivisione di file. Assicurati di concedere a Sharesheet le autorizzazioni giuste per leggere l'immagine che vuoi utilizzare come miniatura. Per maggiori informazioni, consulta Intent.FLAG_GRANT_READ_URI_PERMISSION.

Ecco un esempio:

Kotlin

 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)

Java

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));

L'anteprima ha un aspetto simile a questo:

Aggiungi azioni personalizzate a Sharesheet

Screenshot di azioni personalizzate su Android Sharesheet.

Su Android 14 (livello API 34) e versioni successive, le app possono aggiungere azioni personalizzate a Sharesheet di Android. Le azioni personalizzate vengono mostrate come piccole icone di azione nella parte superiore di Android Sharesheet e le app possono specificare qualsiasi Intent come azione richiamata quando l'icona viene selezionata.

Per aggiungere azioni personalizzate su Android Sharesheet, devi prima creare un ChooserAction con ChooserAction.Builder. Puoi specificare un PendingIntent come azione richiamata quando l'icona viene selezionata. Crea un array contenente tutte le tue azioni personalizzate e specificalo come EXTRA_CHOOSER_CUSTOM_ACTIONS della condivisione Intent.

Kotlin

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)

Java

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);

Aggiungi target personalizzati

Android Sharesheet ti consente di specificare fino a due oggetti ChooserTarget che vengono mostrati prima delle scorciatoie di condivisione e delle destinazioni dei selettori caricati da ChooserTargetServices. Puoi anche specificare fino a due intent che rimandano alle attività elencate prima dei suggerimenti delle app:

Aggiungi Intent.EXTRA_CHOOSER_TARGETS e Intent.EXTRA_INITIAL_INTENTS all'intent condiviso dopo la chiamata a Intent.createChooser():

Kotlin

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

Java

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

Usa questa funzione con cautela. Ogni elemento Intent e ChooserTarget personalizzato che aggiungi riduce il numero suggerito dal sistema. In genere sconsigliamo di aggiungere target personalizzati. Un esempio appropriato e comune di aggiunta di Intent.EXTRA_INITIAL_INTENTS è fornire ulteriori azioni che gli utenti possono eseguire sui contenuti condivisi. Ad esempio, un utente condivide immagini e Intent.EXTRA_INITIAL_INTENTS viene utilizzato per consentirgli di inviare un link. Un esempio appropriato e comune di aggiunta di Intent.EXTRA_CHOOSER_TARGETS è mostrare le persone o i dispositivi pertinenti forniti dalla tua app.

Escludi target specifici in base al componente

Per escludere target specifici, fornisci il valore Intent.EXTRA_EXCLUDE_COMPONENTS. Esegui questa operazione solo per rimuovere i target su cui hai il controllo. Un caso d'uso comune è nascondere i target delle condivisioni dell'app quando gli utenti condividono contenuti dall'interno dell'app, poiché è probabile che la loro intenzione sia quella di condividere contenuti all'esterno dell'app.

Aggiungi Intent.EXTRA_EXCLUDE_COMPONENTS al tuo intent dopo aver chiamato Intent.createChooser():

Kotlin

  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)
  }

Java

  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);

Può essere utile sapere quando gli utenti condividono contenuti e quale target selezionano. Android Sharesheet ti consente di ottenere queste informazioni fornendo il ComponentName dei target selezionati dagli utenti tramite un IntentSender.

Innanzitutto crea un PendingIntent per un BroadcastReceiver e fornisci il relativo IntentSender in Intent.createChooser():

Kotlin

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)

Java

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());

Ricevi il callback tra MyBroadcastReceiver e cerca in Intent.EXTRA_CHOSEN_COMPONENT:

Kotlin

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

Java

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

Aggiungi azioni personalizzate a Sharesheet

Su Android 14 (livello API 34) e versioni successive, le app possono aggiungere azioni personalizzate a Sharesheet di Android. Crea una ChooserAction con ChooserAction.Builder. Puoi specificare un PendingIntent come azione richiamata quando l'icona viene selezionata. Crea un array contenente tutte le tue azioni personalizzate e specificalo come EXTRA_CHOOSER_CUSTOM_ACTIONS della condivisione Intent.

Kotlin

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)

Java

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);

Utilizzare il resolver di intent di Android

Screenshot del resolver di intent di ACTION_SEND.

Lo strumento di risoluzione degli intent di Android è ideale per inviare dati a un'altra app nell'ambito di un flusso di attività ben definito.

Per utilizzare Intent resolver di Android, crea un intent e aggiungi degli extra come faresti con Android Sharesheet. Tuttavia, non chiamare Intent.createChooser().

Se sono presenti più applicazioni installate con filtri corrispondenti a ACTION_SEND e al tipo MIME, il sistema mostra una finestra di dialogo di disambiguazione denominata intent resolver che consente all'utente di scegliere una destinazione con cui eseguire la condivisione. Se una singola applicazione corrisponde, viene eseguita.

Ecco un esempio di come utilizzare il resolver di intent di Android per inviare testo:

Kotlin

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

Java

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);

Scopri di più

Per maggiori informazioni sull'invio di dati, consulta Filtri per intent e intent.

Avanti

Ricevere dati semplici da altre app

Inviare dati semplici ad altre app

Perché utilizzare Android Sharesheet

Utilizza Android Sharesheet

Invia contenuti testuali

Kotlin

Java

Invia contenuti binari

Kotlin

Java

Utilizzare il tipo MIME corretto

Condividere più contenuti

Kotlin

Java

Aggiungi contenuti avanzati alle anteprime di testo

Kotlin

Java

Aggiungi azioni personalizzate a Sharesheet

Kotlin

Java

Aggiungi target personalizzati

Kotlin

Java

Escludi target specifici in base al componente

Kotlin

Java

Ottieni informazioni sulla condivisione

Kotlin

Java

Kotlin

Java

Aggiungi azioni personalizzate a Sharesheet

Kotlin

Java

Utilizzare il resolver di intent di Android

Kotlin

Java

Scopri di più