Condivisione e ricezione di contenuto (HTML)

[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]

Accade spesso di imbattersi in informazioni interessanti da voler condividere con altre persone o usare in altre app. La condivisione è una funzionalità in contesto semplificata che può essere aggiunta facilmente alla tua app.

Le app che supportano la funzionalità di condivisione sono di due tipi. Il primo tipo è un'app di origine che fornisce il contenuto che l'utente vuole condividere. Il secondo tipo è un'app di destinazione che l'utente seleziona come destinazione del contenuto condiviso. Un'app può anche essere sia di origine che di destinazione. Per impostare un'app come origine per la condivisione di contenuto, dovrai prima decidere quali formati di dati puoi fornire. Ti consigliamo di provare a supportare il maggior numero possibile di formati di dati, ma alla fine dovrai scegliere quelli più appropriati per l'app. Dopo aver preso questa decisione, potrai usare le classi dello spazio dei nomi Windows.ApplicationModel.DataTransfer per inserire i dati in un pacchetto.

Per impostare un'app come destinazione per la ricezione del contenuto condiviso, dovrai innanzitutto configurare il file manifesto dell'app per indicare che supporta il contratto Condivisione.

Nota  

Gli utenti dell'app possono condividere il contenuto dall'app con un semplice gesto di scorrimento rapido dall'accesso alla condivisione. Un utente può condividere un file o un URL dall'app con un altro dispositivo usando Tocca e invia nell'accesso ai dispositivi.

Nota  

La barra degli accessi non esiste in Windows Phone 8.1, quindi le opzioni di condivisione devono essere incluse a livello di programmazione dallo sviluppatore nella barra dell'app o in un altro controllo.

Questo contratto Condivisione permette di presentare la tua app come un'opzione quando l'utente richiama la condivisione in scenari in cui sono condivisi i formati di dati supportati. Quando scegli i formati di dati che saranno supportati dalla tua app, registra solo i formati che la tua app è effettivamente in grado di gestire. Per altre indicazioni, vedi Scelta dei formati di dati. Quando l'utente richiama l'opzione di condivisione, vengono visualizzate solo le app di destinazione che supportano i dati da condividere.

Se usi Visual Studio, puoi aggiungere il contratto Condivisione all'app scegliendo Aggiungi nuovo elemento dal menu Progetto e quindi selezionando Contratto condivisione di destinazione nell'elenco. Nell'ambito di questo processo, dovrai specificare l'elenco dei formati di dati e dei tipi di file che l'app può accettare. I formati devono essere specificati nella scheda Dichiarazioni durante la modifica del file package.appxmanifest in Visual Studio.

Per altre informazioni sul supporto del contratto Condivisione nel manifesto dell'app, vedi la Guida introduttiva: Ricezione di contenuto condiviso e ShareTarget nella guida di riferimento allo schema del manifesto del pacchetto.

Per un esempio di condivisione di contenuto, vedi l'esempio di app di origine per la condivisione di contenuto e l'esempio di app di destinazione per la condivisione di contenuto oppure gli argomenti Guida introduttiva: Condivisione di contenuto e Guida introduttiva: Ricezione di contenuto condiviso.

Nel diagramma seguente viene mostrato un quadro generale del funzionamento della condivisione.

Nota  

Gli oggetti QuickLink non sono supportati in Windows Phone 8.1. Se un'app di destinazione restituisce un elemento QuickLink, l'app di origine lo ignorerà automaticamente.

Puoi specificare il modulo che si apre quando l'app viene attivata tramite il contratto Condivisione. In questo modo puoi creare un'esperienza personalizzata appositamente per la condivisione. Per altre informazioni su questo argomento e ulteriori considerazioni sulla progettazione, vedi Linee guida ed elenco di controllo per la condivisione di contenuto.

Nota  

Se implementi un'app di destinazione, tieni presente l'esperienza dell'interfaccia utente. In Windows l'app selezionata da un utente viene visualizzata nel riquadro a comparsa Condivisione. Si tratta di una delle modalità di visualizzazione disponibili per le app. Accertati che la tua app presenti un'interfaccia pulita e ordinata per la condivisione di contenuto nel riquadro a comparsa Condivisione.

Il contenuto che la tua app riceve da un'app di origine non può essere modificato. Puoi tuttavia informare il sistema che l'app ha ricevuto i dati e indicare quando sono stati elaborati. Questo aspetto è importante, soprattutto per tipi di contenuto come le immagini, che possono richiedere tempi lunghi di caricamento ed elaborazione. Per altri dettagli, vedi l'esempio di app di destinazione per la condivisione di contenuto o l'argomento Guida introduttiva: Ricezione di contenuto condiviso.

Tieni presente che, anche se questi ruoli (—di origine e destinazione—) sono diversi, possono essere supportati entrambi in una singola app. È ad esempio possibile impostare un'app di condivisione di foto come app di origine, in modo che gli utenti possano inviare le loro foto ad altri tramite email, e specificarla anche come app di destinazione per permettere agli utenti di aggiornare gli album fotografici con nuove immagini.

Per informazioni su come aggiungere la condivisione all'app, vedi gli argomenti e le app di esempio seguenti:

• Linee guida ed elenco di controllo per la condivisione di contenuto. In questo articolo troverai informazioni utili per offrire un'esperienza utente ottimale per la condivisione di contenuto, sia per le app di origine che per quelle di destinazione.
• Scelta dei formati di dati per la condivisione. In questo articolo troverai informazioni sui formati standard per la condivisione e scoprirai come creare e usare formati personalizzati quando quelli standard non sono adatti.
• Condivisione di contenuto. Contiene informazioni sui concetti di base per implementare un'app di origine. Sono inoltre illustrati scenari più specifici, con alcuni aspetti da considerare durante l'implementazione.
• Ricezione di contenuto condiviso. Gli argomenti di questo articolo contengono le procedure per aggiungere il contratto Condivisione all'app, informazioni di base su come rilevare se un utente seleziona l'app per la condivisione di contenuto e indicazioni su come elaborare i dati da condividere. Troverai inoltre alcuni scenari specifici, utili per raggiungere subito la piena operatività.
• Esempio di app di origine per la condivisione di contenuto. Questo esempio illustra come avviare un'operazione di condivisione e creare un pacchetto del contenuto da condividere.
• Esempio di app di destinazione per la condivisione di contenuto. Questo esempio illustra come ricevere il contenuto condiviso da un'altra app.
• Linee guida per il debug delle app di destinazione. In questo articolo troverai informazioni sui problemi relativi al debug di un'app di destinazione di condivisione.