Desenvolver um aplicativo por meio de registro de arquivos soltos

O registro de arquivo flexível permite validar e compartilhar seu aplicativo durante o desenvolvimento sem passar pelo processo de empacotamento completo. Registre uma pasta que contém o conteúdo do aplicativo e Windows a trata como um pacote instalado.

Warning

O registro de layout de arquivo flexível é somente para desenvolvimento e teste. Não use essa abordagem para distribuição de produção. Sempre execute a validação final em um aplicativo empacotado assinado com um certificado confiável.

O que é um layout de arquivo solto?

Um layout de arquivo flexível coloca o conteúdo do aplicativo em uma pasta em vez de criar um pacote MSIX. O conteúdo do pacote está disponível de forma avulsa em uma pasta e não está empacotado.

Advantages

  • Validação rápida – como os arquivos do aplicativo já estão desempacotados, você pode registrar o layout e iniciar o aplicativo imediatamente. Use o aplicativo como projetado sem esperar por uma etapa de empacotamento.
  • Distribuição de rede fácil – se os arquivos soltos estiverem em um compartilhamento de rede, você poderá enviar o caminho de compartilhamento para outros usuários que têm acesso à rede. Eles registram o layout e executam o aplicativo, o que permite que várias pessoas validem o aplicativo simultaneamente.
  • Colaboração – o registro de arquivo flexível permite que desenvolvedores e designers trabalhem em ativos visuais enquanto o aplicativo está registrado. Os usuários veem ativos estáticos atualizados quando relançam o aplicativo. Para atualizar o código ou o conteúdo criado dinamicamente, você deve recompilar o aplicativo.

Pré-requisitos

Importante

O registro de arquivo flexível só está disponível em dispositivos que dão suporte ao protocolo SMB (Compartilhamento de Rede) — Desktop e Xbox.

Registrar-se com WinAppDeployCmd

Se você usar as ferramentas do SDK correspondentes ao Windows 10 versão 1809 ou posterior, use o WinAppDeployCmd comando em um prompt de comando:

WinAppDeployCmd.exe registerfiles -remotedeploydir <NetworkPath> -ip <IPAddress> -pin <PIN>
  • NetworkPath – o caminho para os arquivos soltos do aplicativo.
  • IPAddress – o endereço IP do computador de destino.
  • PIN — um PIN, se necessário, para autenticação. Consulte a Descoberta de Dispositivos para saber como obter um PIN.

Registrar-se no Portal do Dispositivo Windows

  1. Conecte-se ao Portal do Dispositivo seguindo as etapas na visão geral do Portal do Dispositivo do Windows.
  2. Na guia Gerenciador de Aplicativos , selecione Registrar no Compartilhamento de Rede.
  3. Insira o caminho de compartilhamento de rede para o layout de arquivo solto.
  4. Se o dispositivo host não tiver acesso ao compartilhamento de rede, insira as credenciais necessárias quando solicitado.
  5. Após a conclusão do registro, inicie o aplicativo.

Você também pode registrar pacotes opcionais selecionando a caixa de seleção Quero especificar pacotes opcionais e fornecendo os caminhos dos compartilhamentos de rede.

Cadastre-se com o PowerShell

Windows PowerShell permite que você registre layouts de arquivo soltos no dispositivo local. Para registrar um layout em um dispositivo remoto, use um dos outros métodos.

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

Resolução de problemas

Issue Solution
Unidades de rede mapeadas Unidades mapeadas não são compatíveis com o registro de arquivos avulsos. Em vez disso, use o caminho de compartilhamento de rede completo (por exemplo, \\server\share\myapp).
Falha no registo Verifique se o dispositivo tem acesso ao layout do arquivo. Se o layout estiver em um compartilhamento de rede, verifique se o dispositivo tem as permissões necessárias.
Alterações de ativo visual que não estão sendo carregadas O aplicativo carrega ativos visuais no momento da inicialização. Se você modificar ativos após iniciar o aplicativo, reinicie o aplicativo para ver as alterações.

Conteúdo relacionado

  • Last updated on