Etapa 1: criar um aplicativo de dispositivo UWP
Este tópico descreve o processo básico para criar um aplicativo de dispositivo UWP usando o Microsoft Visual Studio. Saiba mais sobre as tarefas comuns a todos os aplicativos de dispositivo UWP.
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
Este guia passo a passo pressupõe que você criou um projeto de aplicativo UWP e que todos os drivers de dispositivo necessários já existem.
Criando o projeto de aplicativo da Microsoft Store
Antes de começar, você precisa ter instalado o Visual Studio e criado um projeto de aplicativo UWP. Se você ainda não tiver feito isso, poderá baixar as ferramentas aqui. Para começar a usar o Microsoft Visual Studio, consulte Desenvolver aplicativos UWP usando o Visual Studio.
Requisitos do driver de dispositivo
Algumas APIs e aplicativos de dispositivo UWP requerem que o dispositivo tenha suporte de um driver fornecido pela Microsoft ou que o driver tenha suporte de um modelo de driver específico. Esta tabela lista os requisitos de driver para alguns aplicativos de dispositivo e APIs.
| Aplicativo de dispositivo ou API | Informações do driver |
|---|---|
| Aplicativos de dispositivo UWP para câmera | O driver da câmera deve usar o modelo de driver AvStream. Para obter mais informações sobre o modelo de driver AvStream, consulte Visão geral do AVStream no Kit de Driver do Windows. Um componente adicional, conhecido como MFT de Driver (uma media foundation transform), pode ser fornecido com o pacote de instalação do driver para fornecer efeitos personalizados para a câmera. Para obter mais informações, consulte Aplicativos de dispositivo da Windows Store para câmeras. |
| Aplicativos de dispositivo UWP para impressoras | As impressoras devem usar o driver de Impressora v4. Consulte Desenvolvendo o driver de impressão v4 para obter mais informações. |
| APIs USB | Para usar as APIs Windows.Devices.Usb do Windows Update, seu dispositivo deve ser compatível com o driver Winusb.sys. |
| APIs do dispositivo de interface humana (HID) | As APIs HID foram projetadas para uso em USB, Bluetooth, Bluetooth Smart e transportes I2C. Para usar as APIs Windows.Devices.HumanInterfaceDevice do Windows Update, seu dispositivo deve ser compatível com o driver HIDClass.sys e o driver exigido pelo transporte. Para obter mais informações, consulte Arquitetura HID. |
| APIs Bluetooth GATT | Para usar as APIs Bluetooth GATT do Windows Update, Windows.Devices.Bluetooth.GenericAttributeProfile, seu dispositivo deve ser compatível com o driver BthLEEnum.sys. |
| APIs Bluetooth RFCOMM | Para usar as APIs RFCOMM Bluetooth do Windows Update, Windows.Devices.Bluetooth.Rfcomm, seu dispositivo deve ser compatível com os drivers Rfcomm.sys e BthEnum.sys. |
Importante
É necessário ter aprovação da Microsoft para ter acesso ao dispositivo usando drivers personalizados. Os OEMs e IHVs que desejam implementar o acesso a dispositivos para um dispositivo especializado usando um driver personalizado devem primeiro contatar o contato da Microsoft para discutir seu cenário com a equipe do Ecossistema do Windows. Para obter mais informações, consulte a seção Modelo de Acesso de Driver Personalizado no guia de design de aplicativo de dispositivo UWP para dispositivos especializados internos ao PC.
Criar uma conta da Microsoft Store
É necessário ter uma conta de desenvolvedor na Microsoft Store. Você precisará do nome do editor ao criar o manifesto do aplicativo e os metadados do dispositivo em etapas posteriores. Você também pode reservar um nome para seu aplicativo depois de criar um perfil de loja.
Para criar uma conta da Microsoft Store, vá para a página de inscrição de aplicativos UWP e clique em Inscrever-se.
Ao inserir o nome de exibição do editor, insira o nome sob o qual seus aplicativos devem ser listados na Microsoft Store. Você não poderá alterar esse nome até que a verificação da sua conta seja concluída. Escolha o nome com cautela, pois os clientes verão esse nome ao navegar e conhecerão seus aplicativos por esse nome.
Associar seu aplicativo à Microsoft Store
Depois de criar uma conta da Microsoft Store e selecionar um nome de editor, associe seu aplicativo à Microsoft Store. Isso baixará automaticamente os seguintes valores para o arquivo de manifesto do pacote do aplicativo local, denominado Package.appxmanifest.
Nome de exibição do pacote
Nome do pacote
ID do Editor
Nome para exibição do editor
Se você já tiver desenvolvido metadados de dispositivo, depois de associar o aplicativo à Microsoft Store, você precisará atualizar os metadados do dispositivo com os valores do manifesto do aplicativo.
Para associar seu aplicativo à Microsoft Store
No Gerenciador de Soluções, clique com o botão direito do mouse em seu projeto e selecione Loja > Associar Aplicativo à Loja.
Na caixa de diálogo Associar seu aplicativo à Microsoft Store, clique em Avançar. Será solicitado que você entre na Microsoft Store.
Na página Entrar, entre na Microsoft Store e clique em Avançar.
Na página Selecionar um nome de aplicativo para este pacote, selecione o Nome do Aplicativo que você reservou. Você também pode clicar em Reservar Nome para ir para a Microsoft Store para reservar um.
Depois que um nome de aplicativo for selecionado, clique em Avançar.
Na página de resumo, revise os valores selecionados. Se parecer satisfatório, clique em Associar. Caso contrário, clique em Anterior para voltar e corrigir os erros. Clicar em Associar baixa automaticamente o nome de exibição do editor e outros valores no manifesto do pacote do aplicativo.
Revisar o manifesto do pacote do aplicativo
Depois de associar seu aplicativo à Microsoft Store, revise o manifesto do pacote do aplicativo para ver se o nome de exibição do editor e outros valores foram inseridos conforme o esperado. Verifique se o título e o nome do aplicativo demonstram uma conexão forte com o dispositivo. Observe também que apenas um aplicativo é permitido no pacote do aplicativo.
Para revisar o manifesto do pacote do aplicativo
No Gerenciador de Soluções, clique duas vezes no arquivo package.appxmanifest. O Designer de Manifesto é aberto. O Designer de Manifesto é uma interface gráfica do usuário para o arquivo XML subjacente.
Depois que o arquivo for aberto no Designer de Manifesto, clique na guia Empacotamento para ver as informações do Pacote e do Editor.
Para ver as mesmas informações em XML, clique com o botão direito do mouse em package.appxmanifest e selecione Abrir com > Editor XML (Texto).
Anote o Nome do Pacote, o Nome do Editor e a ID do Aplicativo. Você precisará deles para a próxima etapa, Etapa 2: criar metadados do dispositivo.
Escolher um certificado de editor
Enquanto estiver revisando o manifesto do pacote do aplicativo com o Designer de Manifesto, escolha um certificado de editor que corresponda ao nome do Editor no manifesto. Enquanto o Designer de Manifesto está aberto na guia Empacotamento, clique em Escolher Certificado para selecionar o certificado apropriado.
Desenvolver seu aplicativo de dispositivo UWP
Ao começar a desenvolver seu aplicativo de dispositivo UWP, considere os seguintes pontos.
Funcionalidades de dispositivo
Para acessar seu dispositivo, talvez seja necessário especificar um recurso do dispositivo no manifesto do pacote do aplicativo. Eles são especificados com o elemento DeviceCapability do arquivo Package.appxmanifest no projeto do seu aplicativo. Alguns recursos do dispositivo devem ser especificados manualmente. Para obter mais informações, consulte Como especificar recursos do dispositivo no manifesto do pacote.
Reprodução Automática para aplicativos de dispositivo UWP
A Reprodução Automática inicia o aplicativo por padrão quando o dispositivo está conectado. Para usar esse recurso, você precisará editar o manifesto do pacote do aplicativo e os metadados do dispositivo. Para obter mais informações, consulte Reprodução Automática para aplicativos de dispositivo UWP.
Sincronizar ou atualizar o dispositivo no segundo plano
Você pode sincronizar ou atualizar seu dispositivo a partir de um aplicativo de dispositivo UWP usando tarefas em segundo plano do dispositivo. Para usar esse recurso, você precisará especificar seu aplicativo como um aplicativo privilegiado nos metadados do dispositivo. Para obter mais informações, consulte Sincronização e atualização de dispositivos para aplicativos de dispositivo UWP.
Saiba mais
Aplicativos de dispositivo UWP para impressoras: exiba o status da impressora e estenda a experiência de configurações de impressão. A partir do Windows 8.1, o aplicativo também pode gerenciar trabalhos de impressão e executar a manutenção da impressora.
Aplicativos de dispositivo UWP para câmeras: estenda a experiência de opções de câmera. Seu aplicativo também pode fornecer efeitos personalizados com um MFT de Driver.
Integrando dispositivos: saiba mais sobre as APIs do Windows Runtime para USB, HID, Bluetooth, Digitalização e muito mais.
Aplicativos de dispositivo UWP para dispositivos internos: saiba como os OEMs podem escrever aplicativos de dispositivo para dispositivos internos ao PC.
Usar o Kit de Certificação de Aplicativos Windows
Para aumentar as chances de seu aplicativo ser certificado, valide e teste-o no computador antes de enviá-lo para certificação e de listá-lo na Microsoft Store. Para obter mais informações, consulte Kit de certificação de aplicativos do Windows.
Próxima etapa
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de