Compartilhando e recebendo conteúdo (HTML)

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Muitas vezes, os usuários encontram determinadas informações que gostam de compartilhar com alguém ou usar em outro aplicativo. O compartilhamento é um recurso contextual leve, fácil de adicionar ao seu aplicativo.

Um aplicativo pode dar suporte ao recurso Compartilhar de duas maneiras. Uma delas pode ser um aplicativo de origemque fornece conteúdo que o usuário quer compartilhar. A segunda pode ser um aplicativo de destino que o usuário seleciona como o destino do conteúdo compartilhado. Um aplicativo também pode ser um aplicativo de origem e um aplicativo de destino. Se você quiser que o aplicativo compartilhe conteúdo como aplicativo de origem, decida sobre os formatos de dados que o aplicativo pode fornecer. Recomendamos que você tente suportar o máximo de formatos de dados possível, mas, no final, você deve escolher os que fazem mais sentido no seu aplicativo. Depois de tomar essa decisão, use as classes do namespace Windows.ApplicationModel.DataTransfer para encapsular os dados.

Se você quiser que o aplicativo receba conteúdo compartilhado como um aplicativo de destino, será preciso configurar primeiro o arquivo de manifesto do aplicativo para indicar que ele suporta o contrato de Compartilhamento.

Observação  

Os usuários do aplicativo podem compartilhar conteúdo de seu aplicativo com um simples passar de dedo do botão Compartilhar. O usuário pode compartilhar um arquivo ou uma URL de seu aplicativo com um dispositivo diferente usando Tocar e Enviar no botão Dispositivos.

Observação  

A barra Botões não existe no Windows Phone 8.1, assim as opções de compartilhamento devem ser incluídas de maneira programática pelo desenvolvedor como parte de uma barra de aplicativos ou outro controle.

Esse contrato de Compartilhamento permite que seu aplicativo seja apresentado como uma opção quando o usuário chama a opção Compartilhar em cenários nos quais os formatos de dados suportados são compartilhados. Ao escolher os formatos de dados para seu aplicativo de destino aceitar, você deve registar somente os formatos com os quais o aplicativo poderá lidar. Para obter mais orientação, consulte Escolhendo formatos de dados. Quando o usuário chama a opção Compartilhar, aparecem somente os aplicativos de destino que suportam os dados que estão sendo compartilhados.

Se você usa o Visual Studio, para adicionar o contrato de Compartilhamento ao aplicativo, no menu Projeto, clique em Adicionar novo item e em seguida selecione Contrato de compartilhamento de destino na lista. Como parte desse processo, você tem que especificar a lista de formatos de dados e tipos de arquivo que seu aplicativo aceita. Formatos são especificados na guia Declarações durante a edição do arquivo package.appxmanifest, no Visual Studio.

Para saber mais sobre como dar suporte ao contrato de Compartilhamento no arquivo de manifesto de seu aplicativo, consulte Guia de início rápido: recebendo conteúdo compartilhado e ShareTarget na Referência do esquema de manifesto do pacote.

Para ver um exemplo de como compartilhar conteúdo, consulte nosso exemplo de aplicativo compartilhamento de fonte de conteúdo e nosso exemplo de aplicativo de compartilhamento de destino de conteúdo ou continue lendo os tópicos do Guia de início rápido: compartilhando conteúdo e Guia de início rápido: recebendo conteúdo compartilhado.

O diagrama abaixo é uma uma exibição de alto nível de como o compartilhamento funciona.

Observação  

Os QuickLinks não têm suporte no Windows Phone 8.1. Se um aplicativo de destino retornar um QuicklLnk, o aplicativo de origem o ignorará automaticamente.

Você também pode especificar o formulário que é aberto quando o aplicativo for ativado pelo contrato de Compartilhamento. Assim, você poderá criar uma experiência personalizada especialmente para o compartilhamento. Saiba mais sobre esse assunto e sobre outras considerações de design em Diretrizes e lista de verificação para o compartilhamento de conteúdo.

Observação  

Se estiver implementando um aplicativo de destino, considere a experiência da interface do usuário. No Windows, quando o usuário seleciona o seu aplicativo, ele é exibido usando o submenu Compartilhar. Esse modo de exibição representa uma das quatro formas de exibição em tela de um aplicativo. Verifique se o seu aplicativo apresenta uma interface fácil e organizada para compartilhamento de conteúdo no submenu Compartilhar.

O conteúdo que seu aplicativo recebe de um aplicativo de origem não pode ser modificado. É possível, no entanto, permitir que o sistema saiba que seu aplicativo recebeu os dados e indique quando eles foram processados. Isso é especialmente importante para conteúdos (como imagens, por exemplo) que podem demorar um pouco para carregar e processar. Nosso exemplo de aplicativo de compartilhamento de destino de conteúdo mostra como isso funciona ou confira o nosso Guia de início rápido: Recebendo conteúdo compartilhado para mais detalhes.

Tenha em mente que, embora essas funções—origem e destino—sejam diferentes, é possível dar suporte a ambas em um mesmo aplicativo. Por exemplo, um aplicativo de compartilhamento de fotos pode atuar como um aplicativo de origem (para que os usuários possam enviar suas fotos por email para outras pessoas) e também como o aplicativo de destino, para que os usuários possam atualizar seus álbuns com novas fotos.

Para começar a adicionar Compartilhamento ao seu aplicativo, consulte os seguintes tópicos:

• Diretrizes e lista de verificação para o compartilhamento de conteúdo. Independentemente de você estar escrevendo um aplicativo de origem ou de destino, este tópico fornece informações úteis que podem ajudá-lo a oferecer a melhor experiência possível ao usuário para o compartilhamento de conteúdo.
• Escolhendo formatos de dados para compartilhamento. Saiba mais sobre os formatos padrão de compartilhamento e aprenda como criar e usar formatos personalizados, caso os formatos padrão não sejam adequados.
• Compartilhando conteúdo. Aqui você aprenderá as noções básicas sobre como implementar um aplicativo de origem. Também abordaremos cenários mais específicos e forneceremos alguns detalhes que você deve ter em mente ao implementá-los.
• Recebendo conteúdo compartilhado. Os tópicos aqui descrevem como adicionar o contrato de Compartilhamento ao seu aplicativo, as noções básicas de como detectar se um usuário seleciona seu aplicativo para compartilhar conteúdo e como processar os dados que estão sendo compartilhados. Também descrevemos alguns cenários específicos para ajudá-lo a ter tudo em execução rapidamente.
• Exemplo de aplicativo de compartilhamento de fonte de conteúdo. Esse exemplo mostra como iniciar uma operação de compartilhamento e como empacotar conteúdo para compartilhamento.
• Exemplo de aplicativo de destino de conteúdo de compartilhamento. Esse exemplo mostra como receber conteúdo compartilhado de outro aplicativo.
• Diretrizes para depurar aplicativos de destino. Saiba mais sobre os problemas envolvidos na depuração de um aplicativo de destino de Compartilhamento.