Partilhar via


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

Important

Os metadados do dispositivo foram preteridos e serão removidos numa versão futura do Windows. Para obter informações sobre a substituição dessa funcionalidade, consulte Metadados de Contêiner do Pacote de Driver.

fluxo de trabalho do aplicativo de dispositivo, etapa 2.

Este artigo descreve como usar o Assistente de Criação de Metadados do Dispositivo para criar novos metadados de dispositivo que associam seu aplicativo de dispositivo UWP a um dispositivo. The wizard can also create a StoreManifest.xml file that you might need to add to your app in the next step.

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

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

Antes de começar

Para usar o Assistente de Criação de Metadados do 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 artigo. 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 do dispositivo

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

Para criar novos metadados do dispositivo

  1. Inicie o Assistente de Criação de Metadados do Dispositivo de %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86, dando um duplo clique no DeviceMetadataWizard.exe.

  2. Selecione Novos Metadados do Dispositivo.

  3. Na página Selecionar o tipo de pacote de metadados , selecione metadados do aplicativo de dispositivo UWP e selecione 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 primária pode ser atribuída. Select Next.

  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. Select Next.

  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 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 para sua empresa. A ID do modelo é um GUID e é a maneira recomendada de associar metadados de dispositivo a dispositivos que dão suporte a uma ID de modelo. Select Next.

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

    • If you want to enable automatic installation for your device app, or extend the camera or printer experience (which requires automatic installation), enter the Microsoft Store app information in the UWP device app box. Selecione Importar arquivo de manifesto do aplicativo UWP para inserir automaticamente o nome do pacote, o nome do Publicador e a ID do aplicativo UWP.

      Warning

      É 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 acham essa experiência confusa e frustrante e dão ao seu aplicativo uma classificação ruim.

    • If your app is registering for printer notifications, fill out the Notification handlers box. In Event ID, enter the name of the print event handler. In Event Asset, enter the name of the file where that code resides.

    • If you want to specify your app as a privileged app, enter that information in the Privileged application box. The privileged app designation lets a UWP device app perform device updates, such as firmware updates. It also lets OEMs and component suppliers develop apps for internal devices.

  9. When you're finished specifying any automatic installation and privileged app details, select Next

  10. Na página Especificar as configurações do Windows , você pode configurar se o dispositivo é mostrado no Gerenciador de Dispositivos quando 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 de 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 na Reprodução Automática para aplicativos de dispositivo UWP).

    • Package name: In the app package manifest, the Name attribute of the Identity element.

    • Publisher name: In the app package manifest, the Publisher attribute of the Identity element.

    • App ID: In the app package manifest, the ID attribute of the Application element.

    • Verb: The identifier for the AutoPlay activation. Seu aplicativo o usa para determinar se a ativação veio do seu dispositivo. You can use any value for the Verb setting, except for open, which is reserved.

    • Tipo de evento de Reprodução Automática: Sair como Dispositivo. Nos metadados do dispositivo, o assistente especifica automaticamente a ID da 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. When you're ready to continue, select Next.

  12. Na página Revisar o pacote de metadados do dispositivo , verifique se todas as configurações estão corretas. Se você quiser que esse pacote de metadados do dispositivo esteja disponível no repositório de metadados local, selecione Copiar o pacote de metadados do dispositivo para o repositório de metadados na caixa de seleção do computador local e selecione 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.

Next step

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