Guia de início rápido: integração com contratos de seletor de arquivos (aplicativos do tempo de Execução do Windows)

Artigo
12/12/2015

[ 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]

Forneça acesso ao conteúdo do aplicativo, um local de salvamento ou atualizações de arquivos por meio do seletor de arquivos integrando seu aplicativo com o contrato do Seletor de Abertura de Arquivos, o contrato do Seletor de Salvamento de Arquivos ou com o contrato do Atualizador de Arquivos em Cache.

Pré-requisitos

JavaScript: Como ativar um aplicativo
C#/C++/VB: Como ativar um aplicativo
Recomendado: Contratos de aplicativos do Windows

Decida quais serviços o seu aplicativo oferecerá em janelas do seletor de arquivos

Seu aplicativo pode fornecer os seguintes serviços para outros aplicativos por meio da integração com o contrato de aplicativo associado. Para participar de um contrato, você deve declarar o contrato no manifesto do seu aplicativo, responder ao evento ativado correspondente e criar uma exibição de aplicativo especializada.

Fornecer acesso a arquivos

Torne os arquivos acessíveis de uma seleção de arquivos se o seu aplicativo tiver uma exibição exclusiva e/ou valiosa desses arquivos ou se os usuários não puderem acessar facilmente os arquivos de outra maneira.

Contrato de aplicativo: Contrato do seletor de abertura de arquivo

Informações do evento ativado: fileOpenPickerActivatedEventArgs

Fornecer um local de gravação

Forneça um local de salvamento por meio de um seletor de arquivos se esperar que seus usuários queiram salvar arquivos a fim de abrir e trabalhar com eles em seu aplicativo posteriormente.

Contrato de aplicativo: Contrato do seletor de salvamento de arquivos

Informações do evento ativado: fileSavePickerActivatedEventArgs

Fornecer atualizações em tempo real para arquivos

Controle e atualize os arquivos por meio de um seletor de arquivos se você espera que os usuários usem seu aplicativo como um repositório central de arquivos a que seu aplicativo permite o acesso, ou que são salvos com o aplicativo como o local de salvamento.

Contrato de aplicativo: contrato do Atualizador de arquivos em cache:

Informações do evento ativado: cachedFileUpdaterActivatedEventArgs

Saiba mais sobre os serviços que o seu aplicativo pode fornecer através de um seletor de arquivos em Acessando arquivos com seletores de arquivos.

Declare o contrato no manifesto do seu arquivo

Com o projeto aberto no Microsoft Visual Studio, siga estas etapas para adicionar um contrato de aplicativo ao seu manifesto:

Adicione um contrato de aplicativo abrindo a janela Adicionar novo item ao seu projeto, selecionando o contrato do painel central e, então, clicando no botão Adicionar.

Há várias maneiras de abrir a janela Adicionar Novo Item no Visual Studio:
- Selecionando a opção de menu Projeto > Adicionar novo item...
- Selecionando a opção de menu Adicionar > Novo item... a partir do menu de contexto do projeto.
- Usando o atalho de teclado Crtl+Shift+A
Dica Quando você adiciona esses contratos, o Visual Studio atualiza automaticamente o arquivo de manifesto "package.appmanifest" e adiciona arquivos ao projeto. Você usará esses arquivos para definir o layout e o comportamento da exibição que será hospedada na janela do seletor de arquivos quando o serviço do aplicativo for chamado.
Personalize as configurações do contrato no Visual Studio se as configurações padrão não forem adequadas ao seu aplicativo.
1. Abra "package.appmanifest".
2. Abra a guia Declarações.
3. Selecione o nome do seu contrato na lista Declarações suportadas.
4. Adicione suporte para tipos específicos de arquivos.
  
  Na caixa Tipos de arquivos suportados, desmarque a caixa de seleção SupportsAnyFileType.
  
  Adicione um novo campo FileType para cada arquivo que você deseja suportar com as seguintes etapas:
  1. Clique no botão Adicionar novo.
  2. Insira a extensão de um tipo de arquivo que você queira suportar no campo FileType da seguinte forma: *.ext
  Dica Adicione apenas os tipos de arquivos que são diretamente relevantes para o seu aplicativo, para seus usuários e para o seu contrato. Limitar tipos de arquivos dessa maneira pode ajudar a manter a exibição do seletor de arquivos organizada e fácil de usar.
Você também pode remover o suporte para um tipo de arquivo seguindo as etapas anteriores e clicando no botão Remover do tipo que você deseja remover. O botão Remover fica diretamente acima do campo Tipo de arquivo.

O seu arquivo de manifesto é atualizado com a marcação do contrato que você adicionou. Um elemento que representa o contrato que você adicionou é inserido na marcação em XML do manifesto como filho do elementoExtensions. Por exemplo, a marcação para um Seletor de abertura de arquivos com suporte a todos os tipos de arquivos tem a seguinte aparência:


  <Extension Category="windows.filePicker" StartPage="filePicker.html">
    <FileOpenPicker>
      <SupportedFileTypes SupportsAnyFileType="true" />
    </FileOpenPicker>
  </Extension>

Responda quando o seu aplicativo é ativado por um seletor de arquivos

Adicione código ao seu manipulador de eventos ativados que testa se o objeto passado para o seu manipulador está associado ao contrato que você declarou no seu manifesto e, então, exibe o arquivo do seu aplicativo na exibição do seletor de arquivos.

Cada contrato é associado a um objeto que fornece informações sobre um evento ativado que é disparado quando um dos serviços fornecidos pelo seu aplicativo é chamado de um seletor de arquivos.

Contrato do seletor de abertura de arquivos - fileOpenPickerActivatedEventArgs

Contrato do seletor de salvamento de arquivos - fileSavePickerActivatedEventArgs

Contrato do atualizador de arquivos em cache - cachedFileUpdaterActivatedEventArgs

Criar uma exibição especializada do seu aplicativo que será hospedada no seletor de arquivos

As orientações das Diretrizes e lista de verificação dos seletores de arquivos devem ajudá-lo a projetar a exibição aplicativo que estará hospedado no seletor de arquivos.

Em última análise, sua exibição deve ser composta de:

Um código que personaliza a letterbox do seletor de arquivos de forma adequada
Uma marcação e estilos que definem a disposição da área delimitada do seletor de arquivos (onde os arquivos são exibidos)
Um código que conecta a fonte de dados para marcação para que os arquivos sejam exibidos na área delimitada

Testar os serviços fornecidos pelo seu aplicativo a partir de um seletor de arquivos chamado por outro aplicativo

Para testar os serviços fornecidos pelo seu aplicativo através de um seletor de arquivos, você deve disparar o evento ativado correspondente ao serviço fornecido pelo seu aplicativo. Você não pode disparar esse evento executando diretamente o seu aplicativo.

Em vez disso, use estas etapas para disparar o evento ativado correspondente a cada contrato.

Para testar a participação do seu aplicativo no contrato do Seletor de abertura de arquivos:

Inicie um aplicativo outro que não o seu.
Use a interface do usuário para chamar uma janela do seletor de arquivos para acessar arquivos.
Selecione o seu aplicativo na lista de locais do seletor de arquivos para ver o seu aplicativo hospedado no seletor de arquivos.

Para testar a participação do seu aplicativo no contrato do Seletor de salvamento de arquivos:

Inicie um aplicativo outro que não o seu.
Use a interface do usuário para chamar uma janela do seletor de arquivos para salvar um arquivo.
Selecione o seu aplicativo na lista de locais do seletor de arquivos para ver o seu aplicativo hospedado no seletor de arquivos.

Para testar a participação do seu aplicativo no contrato do Atualizador de arquivos em cache:

Inicie um aplicativo outro que não o seu.
Use a interface do usuário desse outro aplicativo para chamar uma janela de seleção de arquivos ou salve um arquivo que você marcou para ser atualizado.

Resumo

O seu aplicativo pode fornecer serviços a outros aplicativos participando de um contrato de aplicativo. Para participar de um contrato, você deve declarar o contrato no manifesto do seu aplicativo, responder ao evento ativado correspondente e criar uma exibição de aplicativo especializada.