Configurações para desenvolvedores

A página System > Advanced nas configurações de Windows inclui o Modo de Desenvolvedor e recursos adicionais que você pode usar quando o Modo de Desenvolvedor está habilitado. O Modo de Desenvolvedor desbloqueia ferramentas, configurações e recursos projetados para criar, implantar e testar aplicativos em Windows.

Uma captura de tela das configurações avançadas do Windows para desenvolvedores, mostrando o Modo de Desenvolvedor, o Portal de Dispositivos e a Descoberta de Dispositivos.

Habilitar o Modo de Desenvolvedor

Se você estiver escrevendo software com Visual Studio, will precisará habilitar o Modo de Desenvolvedor no pc de desenvolvimento e em qualquer dispositivo que você usará para testar seu código.

Para habilitar o Modo de Desenvolvedor ou acessar outras configurações:

1. Abra Windows Configurações.

2. Pesquise Avançado ou vá para o Sistema > Avançado e, em seguida, role até a seção Para desenvolvedores.

3. Alterne a configuração do Modo de Desenvolvedor na parte superior da seção For developers .

4. Leia o aviso de isenção de responsabilidade. Clique em Sim para aceitar a alteração.

   caixa de diálogo

Se você tentar criar um projeto do Windows no Visual Studio quando o Modo de Desenvolvedor não está habilitado, a seguinte caixa de diálogo aparecerá:

Se você vir essa caixa de diálogo, selecione configurações para desenvolvedores para abrir a página de configurações System > Advanced.

Recursos do Modo de Desenvolvedor

O Modo de Desenvolvedor substitui os requisitos de uma licença de desenvolvedor. Além do carregamento lateral, a configuração do Modo de Desenvolvedor habilita a depuração e opções adicionais de implantação. Isso inclui iniciar um serviço SSH para permitir a implantação neste dispositivo. Para interromper esse serviço, você precisa desabilitar o Modo de Desenvolvedor.

Quando você habilita o Modo de Desenvolvedor na área de trabalho, um pacote de recursos é instalado, incluindo:

• Windows Device Portal: o Portal do Dispositivo só está habilitado (e as regras de firewall só são configuradas para ele) quando a opção Enable Device Portal está ativada.
• Instala e configura regras de firewall para serviços SSH que permitem a instalação remota de aplicativos. Habilitar a Descoberta de Dispositivo ativará o servidor SSH.

Portal do Dispositivo

Para saber mais sobre o Portal do Dispositivo, consulte Windows Visão geral do Portal do Dispositivo.

Para obter instruções de instalação específicas, consulte o Portal de Dispositivos para área de trabalho.

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. Este prompt de PIN deve ser exibido na tela para concluir sua primeira implantação do Visual Studio no dispositivo.

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 do Dispositivo para implantar um aplicativo em um tablet para teste, precisará habilitar a Descoberta de Dispositivos no tablet, mas não no computador de desenvolvimento.

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 em que implantações de arquivos soltos são instaladas pelo 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.

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 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 ser localizado em 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 Windows no Settings → Updates and Security → Windows Updates.

4. Verifique se o pacote modo de desenvolvedor do Windows está presente em Configurações → Sistema → Recursos opcionais → Adicionar um recurso (em versões anteriores à Windows 10 22H2, procure em Configurações→Aplicativos→Aplicativos e recursos→ Recursos opcionais→Adicionar um recurso). Se ele estiver ausente, 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 de Windows e o pacote do Modo de Desenvolvedor.

Para corrigir esse problema:

1. Verifique se há atualizações Windows no Settings → Updates and Security → 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, é recomendável 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 de área de trabalho Windows para desenvolvimento.

Você pode usar gpedit.msc para definir as políticas de grupo para habilitar seu dispositivo, a menos que você tenha Windows 10 Home ou 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. Acesse Local Computer Policy → Computer Configuration → Administrative Templates → Windows Components → App Package Deployment.

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

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

   OU

   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

   OU

   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"
   

   OU

   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"