Etapa 2: criar metadados de dispositivo para seu aplicativo de dispositivo UWP

Este tópico descreve como usar o Assistente de Criação de Metadados de Dispositivo para criar novos metadados de dispositivo que associam seu aplicativo de dispositivo UWP a um dispositivo. O assistente também pode criar um arquivo StoreManifest.xml que talvez você precise adicionar ao seu aplicativo na próxima etapa.

Um aplicativo de dispositivo UWP é um tipo especial de aplicativo UWP que os fabricantes de dispositivo criam para servir como um complemento para seu dispositivo interno ou periférico. Usando metadados do dispositivo, os aplicativos do dispositivo podem executar operações privilegiadas e instalar automaticamente quando um dispositivo é conectado. Para obter mais informações sobre aplicativos de dispositivo UWP, consulte Conhecer os aplicativos de dispositivo UWP.

Este tópico faz parte de uma série de passo a passo. Consulte Criar um aplicativo de dispositivo UWP passo a passo para obter a introdução.

Antes de começar

Para usar o Assistente de Criação de Metadados de Dispositivo, você deve instalar o Microsoft Visual Studio Professional, o Microsoft Visual Studio Ultimate ou o SDK autônomo para Windows 8.1, antes de concluir as etapas neste tópico. A instalação do Microsoft Visual Studio Express para Windows instala uma versão do SDK que não inclui o assistente.

Criar novos metadados de dispositivo

O Assistente de Criação de Metadados de Dispositivo é usado para criar novos metadados de dispositivo.

Para criar novos metadados de dispositivo

1. Inicie o Assistente de Criação de Metadados de Dispositivo em %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86, clicando duas vezes em DeviceMetadataWizard.exe.

2. Clique em Novos Metadados de Dispositivo.

3. Na página Selecione o tipo de pacote de metadados, clique em Metadados do aplicativo de dispositivo UWP e clique em Avançar.

4. Na página Selecionar as categorias de dispositivo, selecione as categorias de dispositivo que devem ser atribuídas ao seu dispositivo. Um dispositivo pode pertencer a várias categorias de dispositivo, mas apenas uma categoria principal pode ser atribuída. Clique em Avançar.

5. Na página Especificar as localidades, selecione pelo menos uma localidade que deve ser associada ao pacote de metadados do dispositivo. Você também pode definir uma localidade padrão que é usada quando um pacote específico de localidade não está disponível no computador. Clique em Avançar.

6. Na página Descrever o dispositivo, insira as informações mostradas aos usuários finais que conectam seu dispositivo. Um nome de modelo e um fabricante são necessários para cada localidade.

7. Na página Especificar as informações de hardware, adicione pelo menos uma ID de hardware e uma ID de modelo. A ID de hardware deve incluir a ID do fornecedor da sua empresa. A ID do modelo é um GUID e é a maneira recomendada de associar metadados do dispositivo a dispositivos que têm suporte para uma ID de modelo. Clique em Avançar.

8. Na página Especificar informações do aplicativo de dispositivo UWP:

   • Se você quiser habilitar a instalação automática para seu aplicativo de dispositivo ou estender a experiência da câmera ou da impressora (o que requer a instalação automática), insira as informações do aplicativo da Microsoft Store na caixa Aplicativo de dispositivo UWP. Clique em Importar arquivo de manifesto do aplicativo UWP para inserir automaticamente o Nome do pacote, o Nome do editor e a ID de aplicativo UWP.

     Aviso

     É importante considerar que o recurso de instalação automática não fornece uma notificação ao usuário quando o aplicativo é instalado. Alguns usuários podem achar essa experiência confusa e frustrante e atribuir uma classificação ruim ao seu aplicativo.

   • Se seu aplicativo estiver registrado para receber notificações de impressora, preencha a caixa Manipuladores de notificação. Em ID do evento, insira o nome do manipulador de eventos de impressão. Em Ativo de Evento, insira o nome do arquivo em que esse código reside.

   • Se você quiser especificar seu aplicativo como um aplicativo privilegiado, insira essas informações na caixa Aplicativo privilegiado. A designação de aplicativo privilegiado permite que um aplicativo de dispositivo UWP execute atualizações de dispositivo, como atualizações de firmware. Ele também permite que OEMs e fornecedores de componentes desenvolvam aplicativos para dispositivos internos.

9. Quando terminar de especificar qualquer instalação automática e detalhes do aplicativo privilegiado, clique em Avançar.

10. Na página Especificar as configurações do Windows, você pode configurar se o dispositivo é mostrado no Gerenciador de Dispositivos quando ele está desconectado e como o dispositivo deve responder a uma ativação de Reprodução Automática.

    Se você quiser especificar um aplicativo para ser o manipulador de Reprodução Automática padrão para seu dispositivo, selecione Usar um aplicativo de dispositivo UWP na caixa Manipulador de Reprodução Automática. Você pode selecionar qualquer aplicativo UWP ou aplicativo de dispositivo UWP, mas esse aplicativo deve manipular a ativação de Reprodução Automática para seu dispositivo e especificar a ID de experiência correspondente no manifesto do pacote do aplicativo (conforme descrito em Reprodução Automática para aplicativos de dispositivo UWP).

    • Nome do pacote: no manifesto do pacote do aplicativo, esse é o atributo Name do elemento Identity.

    • Nome do editor: no manifesto do pacote do aplicativo, esse é o atributo Publisher do elemento Identity.

    • ID do aplicativo: no manifesto do pacote do aplicativo, esse é o atributo ID do elemento Application.

    • Verbo: este é o identificador para a ativação de Reprodução Automática. Seu aplicativo o utilizará para determinar se a ativação veio do seu dispositivo. Você também pode usar qualquer valor para a configuração Verbo exceto open, que está reservado.

    • Tipo de evento de Reprodução Automática: deixe isso como Dispositivo. Nos metadados do dispositivo, o assistente especificará automaticamente o ID de experiência associada ao seu aplicativo de dispositivo UWP.

    Se você quiser permitir que outros aplicativos atuem como manipuladores de Reprodução Automática para seu dispositivo, selecione Habilitar Reprodução Automática para aplicativos registrados.

    Para obter mais informações sobre a Reprodução Automática, consulte Reprodução Automática para aplicativos de dispositivo UWP.

11. Quando estiver pronto para continuar, clique em Próximo.

12. Na página Revisar o pacote de metadados do dispositivo, verifique se todas as configurações estão corretas. Se desejar que esse pacote de metadados de dispositivo esteja disponível no repositório de metadados local, marque a caixa de seleção Copiar o pacote de metadados de dispositivo para o repositório de metadados no computador local e clique em Salvar.

13. Quando estiver pronto para enviar o pacote de metadados do dispositivo ou se precisar editá-lo, use o arquivo .devicemanifest-ms. O arquivo .devicemetadata-ms deve ser usado apenas para testar metadados do dispositivo localmente.

Próxima etapa

Etapa 3: adicionar uma ID de experiência ao aplicativo

Tópicos relacionados

Criando aplicativos de dispositivo UWP

Sincronização e atualização de dispositivos para aplicativos de dispositivo UWP

Aplicativos de dispositivo UWP para dispositivos internos