Implantar uma aplicação por meio de registro de ficheiro solto

O registo de ficheiros soltos permite-lhe validar e partilhar a sua aplicação durante o desenvolvimento sem passar pelo processo completo de embalagem. Registe uma pasta contendo o conteúdo da tua aplicação e o Windows trata-a como um pacote instalado.

Warning

O registo de layout de ficheiros soltos é apenas para desenvolvimento e testes. Não use esta abordagem para distribuição em produção. Realize sempre a validação final numa aplicação embalada que esteja assinada com um certificado de confiança.

O que é um layout de ficheiro solto?

Um layout de ficheiro solto coloca o conteúdo da sua aplicação numa pasta em vez de construir um pacote MSIX. O conteúdo do pacote está disponível "solto" numa pasta e não está empacotado.

Vantagens

  • Validação rápida — como os ficheiros da aplicação já estão desempacotados, pode registar o layout e lançar a aplicação imediatamente. Use a aplicação tal como foi desenhada, sem esperar pelo passo de embalagem.
  • Distribuição fácil na rede — se os ficheiros soltos estiverem numa partilha de rede, pode enviar o caminho da partilha para outros utilizadores que tenham acesso à rede. Eles registam o layout e executam a aplicação, o que permite que várias pessoas validem a aplicação em simultâneo.
  • Colaboração — o registo de ficheiros soltos permite que programadores e designers trabalhem em ativos visuais enquanto a aplicação está registada. Os utilizadores veem ativos estáticos atualizados quando reiniciam a aplicação. Para atualizar código ou conteúdo criado dinamicamente, deve recompilar a aplicação.

Pré-requisitos

Importante

O registo de ficheiros soltos está disponível apenas em dispositivos que suportam o protocolo SMB (Network Share) — Desktop e Xbox.

Registe-se com o WinAppDeployCmd

Se usar ferramentas SDK correspondentes ao Windows 10 versão 1809 ou posterior, use o WinAppDeployCmd comando num prompt de comandos:

WinAppDeployCmd.exe registerfiles -remotedeploydir <NetworkPath> -ip <IPAddress> -pin <PIN>
  • NetworkPath — o caminho para os ficheiros soltos da aplicação.
  • IPAddress — o endereço IP da máquina alvo.
  • PIN — um PIN se necessário para autenticação. Consulte a Descoberta de Dispositivos para saber como obter um PIN.

Registe-se no Portal de Dispositivos Windows

  1. Ligue-se ao Portal de Dispositivos seguindo os passos na visão geral do Portal de Dispositivos Windows.
  2. No separador Gestor de Apps , selecione Registar-se a partir da Partilha de Rede.
  3. Introduza o caminho da partilha de rede para a estrutura de ficheiros solta.
  4. Se o dispositivo anfitrião não tiver acesso à partilha de rede, introduza as credenciais necessárias quando solicitado.
  5. Depois de concluído o registo, inicie a aplicação.

Também pode registar pacotes opcionais selecionando a caixa de seleção Quero especificar pacotes opcionais e fornecendo os caminhos de partilha de rede.

Registe-se com o PowerShell

O Windows PowerShell permite-lhe registar estruturas de ficheiros não compactados no dispositivo local. Para registar um layout num dispositivo remoto, use um dos outros métodos.

Add-AppxPackage -Register <path-to-manifest-file>

Troubleshooting

Issue Solução
Unidades de rede mapeadas Discos mapeados não são suportados para registo de ficheiros soltos. Use o caminho completo de partilha de rede (por exemplo, \\server\share\myapp).
Falha no registo Verifique se o dispositivo tem acesso ao layout do ficheiro. Se o layout estiver numa partilha de rede, verifique se o dispositivo tem as permissões necessárias.
As alterações aos recursos visuais não carregam A aplicação carrega os recursos visuais no momento do lançamento. Se modificares os assets após o lançamento, reinicia a aplicação para veres as alterações.