Criando aplicativos de dispositivo UWP

Artigo
03/05/2024

Os fabricantes de dispositivo podem criar um aplicativo de dispositivo UWP que sirva como um complemento para seu dispositivo. Este tópico descreve os componentes de um aplicativo de dispositivo UWP, as etapas básicas para criar um e a ordem em que você deve enviar seus metadados de aplicativo e dispositivo para o painel da Microsoft Store e para o painel de hardware do Centro de Desenvolvimento do Windows, respectivamente. Para obter uma visão mais detalhada de cada etapa, consulte Criar um aplicativo de dispositivo UWP passo a passo.

Os blocos de construção

No nível mais básico, um aplicativo de dispositivo UWP é um aplicativo UWP associado a um dispositivo específico por meio de metadados de dispositivo. Há quatro componentes para um aplicativo de dispositivo UWP: um dispositivo, um aplicativo, um pacote de metadados de dispositivo e um driver de dispositivo. Você não precisa usar metadados de dispositivo para acessar um dispositivo periférico usando as APIs de protocolo de dispositivo (USB, HID, Bluetooth GATT e Bluetooth RFCOMM). Mas você precisa usar metadados de dispositivo para habilitar recursos especiais, como instalação automática, Reprodução Automática e atualização do dispositivo.

Componente	Descrição
Dispositivo	Este é o dispositivo físico. Os dispositivos periféricos são externos ao gabinete do PC. Dispositivos internos são aqueles que residem dentro ou estão integrados ao gabinete do PC.
Aplicativo	Um aplicativo de dispositivo UWP é um aplicativo UWP que fornece uma experiência de usuário personalizada para o dispositivo, permitindo que o usuário acesse seus recursos exclusivos. Um aplicativo de dispositivo contém um arquivo denominado StoreManifest.xml que especifica a ID da experiência. A ID da experiência é um GUID que identifica exclusivamente um pacote de metadados do dispositivo.
Metadados de dispositivo	Esta é uma versão estendida de qualquer pacote de metadados de dispositivo que você já tenha criado para o Windows 7. No Windows 8.1, os metadados do dispositivo criam um link entre o dispositivo e o aplicativo. Esse link é identificado na ID da experiência. Além do conteúdo da interface do usuário para o computador (nome do modelo, descrição e ícones fotorrealistas localizáveis), o pacote de metadados do dispositivo especifica a configuração Reprodução Automática e qual aplicativo tem privilégio para acessar o dispositivo. O Windows baixa automaticamente os metadados do dispositivo do Serviço de Metadados e Internet do Windows (WMIS).
Driver	Todos os aplicativos de dispositivo UWP usam drivers, indiretamente, para acessar dispositivos. Por exemplo, as APIs de protocolo de dispositivo do Windows Runtime, introduzidas no Windows 8.1, usam drivers nativos para permitir que seu aplicativo se comunique por USB, HID e Bluetooth. Para obter mais informações sobre os drivers usados por essas APIs, consulte Etapa 1: criar um aplicativo de dispositivo UWP.

Importante

É necessário ter aprovação da Microsoft para ter acesso ao dispositivo usando drivers personalizados. Para obter mais informações, consulte Guia de design de aplicativo de dispositivo UWP para dispositivos especializados internos ao PC.

Fluxo de trabalho de desenvolvimento

Há seis etapas para criar um aplicativo de dispositivo UWP, supondo-se que você já tenha criado seu dispositivo e enviado todos os drivers necessários para o Painel de Hardware. Clique nos links para obter mais detalhes sobre cada etapa.

the device app development workflow.

Etapa 1: criar o aplicativo. Associe seu aplicativo à Microsoft Store, desenvolva o aplicativo e teste-o.

Etapa 2: criar os metadados do dispositivo. Use o Assistente de Criação de Metadados de Dispositivo para associar seu aplicativo ao dispositivo, criar um pacote de metadados do dispositivo e criar um arquivo StoreManifest.xml (que especifica a ID da experiência).

Etapa 3: adicionar uma ID de experiência ao aplicativo. Incorpore o arquivo StoreManifest.xml em seu aplicativo.

Se seu aplicativo for um aplicativo privilegiado e não estiver configurado para instalação automática, a etapa 3 não será necessária.

Etapa 4: testar os metadados do dispositivo (localmente). Use o Assistente de Criação de Metadados de Dispositivo para validar e implantar os metadados do dispositivo em sua estação de trabalho de desenvolvimento local.

Etapa 5: enviar o aplicativo para o painel da Microsoft Store. Use o painel para confirmar os detalhes da venda e indicar aos testadores que o aplicativo é um aplicativo de dispositivo UWP.

Se seu aplicativo for um aplicativo privilegiado e não estiver configurado para instalação automática, você poderá enviá-lo ao painel da Microsoft Store após a etapa 6. Para obter mais informações, consulte Sequência de envio de aplicativo privilegiado.

Etapa 6: enviar metadados do dispositivo para o painel de hardware do Centro de Desenvolvimento do Windows. Envie pacotes de metadados de dispositivo manualmente ou use o Assistente de Criação de Metadados de Dispositivo para criar um pacote de envio em massa que você pode enviar para o painel de hardware.

Sequência de submissão padrão

A primeira vez que você enviar seus metadados de aplicativo e dispositivo para os vários painéis, os eventos deverão ocorrer em uma sequência específica. A tabela a seguir também mostra quando enviar um driver de dispositivo, se aplicável.

Sequência	Descrição	Antes de continuar...
1	Envie o driver de dispositivo para o painel de hardware.	Aguarde até que o driver esteja disponível no Windows Update.
2	Envie o aplicativo para o painel da Microsoft Store.	Aguarde a aceitação e até que o aplicativo esteja ativo na Microsoft Store.
3	Envie os metadados de dispositivo para o painel de hardware. O aplicativo precisa estar na Microsoft Store para que os metadados possam passar na validação no painel de hardware.	Aguarde 10 dias para aceitação e distribuição.
4	Conclusão: os usuários podem se beneficiar de todos os recursos do aplicativo de dispositivo da Microsoft Store. Observe que os recursos do aplicativo do dispositivo, como instalação automática, Reprodução Automática e atualização de dispositivo não funcionarão até que o usuário tenha os metadados do dispositivo e o aplicativo no computador. Se o aplicativo exigir um driver que não seja fornecido pela Microsoft, esse driver também precisará estar presente para que o aplicativo funcione.

Sequência de envio de aplicativos privilegiados

Em alguns casos, os aplicativos de dispositivo UWP não precisam estar ativos na Microsoft Store para você enviar os metadados do dispositivo. Quando seu aplicativo de dispositivo UWP:

Está especificado como um aplicativo privilegiado
Não está configurado para instalação automática

Se isso for verdade sobre seu aplicativo, você poderá enviar os metadados do dispositivo para o painel de hardware antes de enviar seu aplicativo de dispositivo UWP para o painel da Microsoft Store. Nesses casos, você não precisa adicionar a ID de Experiência ao seu aplicativo. Especificar seu aplicativo como um aplicativo privilegiado nos metadados do dispositivo é suficiente para que os privilégios entrem em vigor.

Os aplicativos de dispositivo UWP para impressoras e câmeras são instalados automaticamente. Portanto, esses tipos de aplicativos de dispositivo UWP devem seguir a sequência de envio padrão e ser enviados para a Microsoft Store antes que os metadados do dispositivo sejam enviados.

Limites do aplicativo de dispositivo UWP

Os fabricantes de dispositivo são limitados no número de aplicativos UWP que podem ser especificados nos metadados do dispositivo para instalação automática e privilégio de aplicativo. Por exemplo, os fabricantes de dispositivos periféricos (IHVs) podem enviar até um aplicativo configurado para instalação automática e até um aplicativo especificado como um aplicativo privilegiado. Um IHV pode enviar um aplicativo que atenda a ambas as limitações ou aos dois aplicativos, com cada um atendendo apenas uma das limitações.

Importante

Não há limite para o número total de aplicativos de dispositivo UWP que um fabricante de dispositivo pode enviar para a Microsoft Store. Esses limites se aplicam apenas a um único pacote de metadados de dispositivo.

As operadoras de celular e os OEMs têm limites diferentes no número de aplicativos que podem especificar nos metadados do dispositivo. Para obter mais informações, os OEMs devem entrar em contato com o representante OEM da Microsoft.

Em cada pacote de metadados do dispositivo, os seguintes limites se aplicam: