Recursos e depuração do Modo de Desenvolvedor

Para habilitar o Modo de Desenvolvedor em seu dispositivo, consulte Configurações para desenvolvedores. Este artigo aborda os recursos avançados do Modo de Desenvolvedor, o Modo de Desenvolvedor em versões anteriores do Windows 10 e falhas de depuração relacionadas às instalações do Modo de Desenvolvedor.

Recursos adicionais do Modo de Desenvolvedor

Para cada família de dispositivos, podem estar disponíveis recursos adicionais para desenvolvedores. Esses recursos só estão disponíveis quando o Modo de Desenvolvedor está habilitado no dispositivo (e podem variar dependendo da versão do sistema operacional).

Esta imagem mostra os recursos do desenvolvedor para o Windows:

Portal do Dispositivo

Para saber mais sobre o Portal de Dispositivos, consulte Visão Geral do Portal de Dispositivos do Windows.

Para obter instruções de instalação específicas do dispositivo, consulte:

• Portal de Dispositivos da área de trabalho
• Portal de Dispositivos para HoloLens
• Portal de Dispositivos para Internet das Coisas
• Portal de Dispositivos para Celulares
• Portal de Dispositivos para Xbox

Se você encontrar problemas para habilitar o Modo de Desenvolvedor ou o Portal do Dispositivo, visite Falha ao instalar o pacote do Modo de Desenvolvedor para saber quais KBs do WSUS permitir para desbloquear o pacote do Modo de Desenvolvedor ou use o aplicativo Hub de Comentários para relatar problemas, conforme descrito na seção de solução de problemas abaixo.

SSH

Os serviços SSH são habilitados quando você habilita a Descoberta de Dispositivos em seu dispositivo. Isso é usado quando seu dispositivo é um destino de implantação remota para aplicativos empacotados MSIX. Os nomes dos serviços são SSH Server Broker e SSH Server Proxy.

Para aproveitar os serviços SSH, você pode habilitar a Descoberta de Dispositivos para permitir o emparelhamento de pinos. Se você pretende executar outro serviço SSH, poderá configurá-lo em uma porta diferente ou desativar os serviços SSH do Modo de Desenvolvedor. Para desativar os serviços SSH, desative a Descoberta de Dispositivos.

O logon SSH é feito por meio da conta DevToolsUser , que aceita uma senha para autenticação. Essa senha é o PIN exibido no dispositivo depois de pressionar o botão de Descoberta de Dispositivos , Par, e ele só é válido enquanto o PIN é exibido. Um subsistema SFTP também está habilitado para o gerenciamento manual da pasta DevelopmentFiles, onde as implantações de arquivos independentes são instaladas a partir do Visual Studio.

Limitações para uso de SSH

O servidor SSH existente usado no Windows ainda não está em conformidade com o protocolo. Usar um cliente SFTP ou SSH pode exigir uma configuração especial. Em particular, o subsistema SFTP é executado na versão 3 ou menos, portanto, qualquer cliente de conexão deve ser configurado para esperar um servidor antigo. O servidor SSH em dispositivos mais antigos usa ssh-dss para autenticação de chave pública (que o OpenSSH preteriu). Para se conectar a esses dispositivos, o cliente SSH deve ser configurado manualmente para aceitar ssh-dss.

Descoberta de dispositivo

Ao habilitar a Descoberta de Dispositivos, você está permitindo que seu dispositivo fique visível para outros dispositivos na rede por meio do mDNS. Esse recurso também permite que você obtenha o PIN SSH para emparelhamento com o dispositivo pressionando o botão Par exposto imediatamente após a descoberta de dispositivos ser habilitada. Esta solicitação de PIN deve ser exibida na tela para concluir sua primeira implantação do Visual Studio destinada ao dispositivo.

Descoberta de Dispositivos

Você deverá habilitar a Descoberta de Dispositivos somente se pretender tornar o dispositivo um destino de implantação. Por exemplo, se você usar o Portal de Dispositivos para implantar um aplicativo em um telefone para teste, precisará habilitar a Descoberta de Dispositivos no telefone, mas não no computador de desenvolvimento.

Otimizações para Windows Explorer, Área de Trabalho Remota e PowerShell (somente área de trabalho)

Na família de dispositivos desktop, a página de configurações Para desenvolvedores tem atalhos para otimizar seu computador para tarefas de desenvolvimento. Os controles deslizantes permitem habilitar ou desabilitar configurações facilmente desse único local.

Notes

Nas primeiras versões do Windows 10 Mobile, uma opção despejos de falhas estava presente no menu configurações do desenvolvedor . Isso foi movido para o Portal do Dispositivo para que ele possa ser usado remotamente, em vez de exclusivamente via USB.

Há várias ferramentas que você pode usar para implantar um aplicativo de um computador Windows 10 em um dispositivo Windows 10. Ambos os dispositivos devem estar conectados à mesma sub-rede da rede (por uma conexão com ou sem fio) ou devem ser conectados por USB. Essas duas opções instalam apenas o pacote do aplicativo (.appx ou .appxbundle). Eles não instalam certificados.

• Use a ferramenta Implantação de Aplicativo do Windows (WinAppDeployCmd). Saiba mais sobre a ferramenta WinAppDeployCmd.
• Você pode usar Device Portal para implantar a partir do navegador em um dispositivo móvel executando Windows 10, versão 1511 ou posterior. Use a página de aplicativos no Portal do Dispositivo para carregar um pacote de aplicativo (.appx) e instalá-lo no dispositivo.

Falha ao instalar o pacote do Modo de Desenvolvedor

Às vezes, devido a problemas de rede ou administrativos, o Modo de Desenvolvedor não será instalado corretamente. O pacote do Modo de Desenvolvedor é necessário para implantação remota neste computador (usando o Portal do Dispositivo de um navegador ou descoberta de dispositivo para habilitar o SSH), mas não para desenvolvimento local. Mesmo se você encontrar esses problemas, ainda poderá implantar seu aplicativo localmente usando o Visual Studio (ou deste dispositivo para outro dispositivo).

Se o Modo de Desenvolvedor não for instalado corretamente, recomendamos que você registre uma solicitação de comentários usando o aplicativo Hub de Comentários.

Falha ao localizar o pacote

O pacote do Modo de Desenvolvedor não pôde estar localizado no Windows Update. Código de erro 0x80004005. Saiba mais.

Esse erro pode ocorrer devido a um problema de conectividade de rede, configurações corporativas ou o pacote pode estar ausente.

Para corrigir esse problema:

1. Verifique se o computador está conectado à Internet.

2. Se você estiver em um computador conectado ao domínio, fale com o administrador da rede. O pacote modo de desenvolvedor (como todos os recursos sob demanda) é bloqueado por padrão no WSUS 2.1. Para desbloquear o pacote do Modo de Desenvolvedor nas versões atuais e anteriores, os seguintes KBs devem ser permitidos no WSUS:

   • 4016509
   • 3180030
   • 3197985

3. Verifique se há atualizações do Windows em Configurações → Atualização e Segurança → Atualizações do Windows.

4. Verifique se o pacote do Modo de Desenvolvedor do Windows está presente em Configurações → Recursos opcionais → Recursos opcionais → Adicionar um recurso (em versões anteriores ao Windows 10 22H2, procure em Configurações→Apps→Apps &recursos→ Recursos opcionais→Dou um recurso). Se ele estiver ausente, o Windows não poderá encontrar o pacote correto para seu computador.

5. Depois de executar as etapas acima, desabilite e, em seguida, reabilite o Modo de Desenvolvedor para verificar a correção.

Falha ao instalar o pacote

O pacote modo de desenvolvedor não foi instalado. Código de erro 0x80004005. Saiba mais.

Esse erro pode ocorrer devido a incompatibilidades entre o build do Windows e o pacote do Modo de Desenvolvedor.

Para corrigir esse problema:

1. Verifique se há atualizações do Windows em Configurações → Atualizações e Segurança → Windows Updates.
2. Reinicie o computador para garantir que todas as atualizações sejam aplicadas.

Usar políticas de grupo ou chaves do Registro para habilitar um dispositivo

Para a maioria dos desenvolvedores, você desejará usar as Configurações do Windows para habilitar seu dispositivo para depuração. Em determinados cenários (como testes automatizados), você pode usar outras maneiras de habilitar seu dispositivo da área de trabalho do Windows para desenvolvimento.

Você pode usar gpedit.msc para definir as políticas de grupo para habilitar seu dispositivo, a menos que você tenha o Windows 10 Home ou o Windows 11 Home. Se você fizer isso, precisará usar comandos regedit ou PowerShell para definir as chaves do Registro diretamente para habilitar seu dispositivo.

Usar gpedit para habilitar seu dispositivo

1. Execute gpedit.msc.

2. Vá para Política de Computador Local → Configuração do Computador → Modelos Administrativos → Componentes do Windows → Implantação de Pacote de Aplicativo.

3. Edite as seguintes políticas para habilitar o sideload:

   • Permitir que todos os aplicativos confiáveis sejam instalados.

   OR

   Edite as seguintes políticas para habilitar o sideload e o modo de desenvolvedor:

   • Permitir que todos os aplicativos confiáveis sejam instalados.
   • Permite o desenvolvimento de aplicativos UWP e a instalação a partir de um IDE (Ambiente de Desenvolvimento Integrado) .
   • Reinicialize o computador.

Usar regedit para habilitar seu dispositivo

1. Execute regedit.

2. Para habilitar o sideload, defina o valor desse DWORD como 1:

   HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock\AllowAllTrustedApps

   OR

   Para habilitar o modo de desenvolvedor, defina os valores disso DWORD como 1:

   HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock\AllowDevelopmentWithoutDevLicense

Usar o PowerShell para habilitar seu dispositivo

1. Execute o PowerShell com privilégios de administrador.

2. Para habilitar o carregamento lateral, execute este comando:

   PS C:\WINDOWS\system32> reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowAllTrustedApps" /d "1"
   

   OR

   Para habilitar o modo de desenvolvedor, execute este comando:

   PS C:\WINDOWS\system32> reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowDevelopmentWithoutDevLicense" /d "1"
   

Atualizar seu dispositivo do Windows 8.1 para o Windows 10 ou 11

Ao criar ou fazer sideload de aplicativos em seu dispositivo Windows 8.1, você precisará instalar uma licença de desenvolvedor. Se você atualizar seu dispositivo do Windows 8.1 para o Windows 10 ou 11, essas informações permanecerão. Execute o comando a seguir para remover essas informações do dispositivo Windows atualizado.

Para cancelar o registro de uma licença de desenvolvedor

1. Execute o PowerShell com privilégios de administrador.

2. Execute este comando:

   unregister-windowsdeveloperlicense
   

Depois de cancelar o registro de sua licença, você precisará habilitar seu dispositivo para desenvolvimento (conforme descrito em Configurações para desenvolvedores) para que você possa continuar a desenvolver neste dispositivo. Se não o fizer, você poderá receber um erro ao depurar seu aplicativo (ou se tentar criar um pacote para ele). Este é um exemplo deste erro:

Erro: DEP0700: falha no registro do aplicativo.