Compartilhar via

Usar um arquivo do Instalador de Aplicativo incorporado para atualizar seu aplicativo

  • Artigo

Importante

O uso de um arquivo do Instalador de Aplicativo incorporado está disponível no Windows versão 10.0.21300.0. Verifique se o MaxVersionTested está se referindo a esta ou a uma versão mais recente do sistema operacional Windows para usar esse recurso.

O arquivo do Instalador de Aplicativo oferece um caminho de atualização que um aplicativo do Windows pode percorrer em busca de atualizações e reparos.

Ao usar o Visual Studio para criar e publicar o aplicativo do Windows com um arquivo do Instalador de Aplicativo incorporado, é preciso garantir que o SDK 2104 do Windows 10 (ou mais recente) tenha sido instalado e que as propriedades do projeto tenham o Windows 10 21H1 (ou mais recente) como as versões direcionadas (MaxVersionTested e MinVersion). Se isso não tiver sido configurado, o aplicativo do Windows não definirá as configurações incorporadas do AppInstaller para o dispositivo quando o aplicativo do Windows for instalado.

Instruções da Ferramenta de Empacotamento MSIX

As etapas a seguir guiarão você sobre as instruções da Ferramenta de Empacotamento MSIX para editar um aplicativo do Windows pré-existente para incluir um aplicativo incorporado do Instalador de Aplicativo.

Observação

A diretriz a seguir supõe que você tenha criado antes o arquivo do Instalador de Aplicativo usando o Visual Studio para automatizar a criação de um arquivo do Instalador de Aplicativo, com o uso do MSIX Toolkit ou manualmente. Para obter diretrizes sobre a criação de um arquivo do Instalador de Aplicativo, visite um dos seguintes artigos do Docs:

Abra o aplicativo do Windows para edição

As etapas a seguir guiarão você sobre como usar o aplicativo Microsoft MSIX Packaging Tool para começar a editar um aplicativo do Windows.

  1. Inicie o Microsoft MSIX Packaging Tool (disponível na Microsoft Store: MSIX Packaging Tool).
  2. Selecione o botão Editor de pacote para editar um pacote existente.
  3. Selecione o botão Procurar e, na janela do prompt, localize o aplicativo do Windows e selecione o botão Abrir.
  4. Selecione o botão Abrir pacote.

Importar o arquivo do Instalador de Aplicativo para o aplicativo do Windows

As etapas a seguir guiarão você sobre como inserir um arquivo do Instalador de Aplicativo em um aplicativo do Windows pré-existente usando o aplicativo Microsoft MSIX Packaging Tool. Essas etapas supõem que você já abriu o aplicativo do Windows para edição usando o aplicativo Microsoft MSIX Packaging Tool.

  1. Do lado esquerdo do MSIX Packaging Tool, selecione Arquivos de pacote.
  2. Expanda a entrada do Pacote pelo modo de exibição de árvore.
  3. Clique com o botão direito do mouse em Pacote e selecione Adicionar arquivo no menu suspenso.
  4. Selecione o botão Procurar na janela do prompt, navegue até o arquivo do Instalador de Aplicativo, selecione-o e, depois, selecione o botão Abrir.
  5. Selecione o botão Salvar.

Atualizar o AppxManifest

As etapas a seguir guiarão você pela atualização do AppxManifest para apontar para o arquivo do Instalador de Aplicativo adicionado anteriormente ao aplicativo do Windows.

  1. Do lado esquerdo do MSIX Packaging Tool, selecione Informações do pacote.
  2. Role até a parte de baixo da seção Informações do pacote.
  3. Selecione o botão Abrir arquivo para abrir o AppxManifest em uma janela do bloco de notas.
  4. Verifique se as <Package> propriedades incluem os seguintes Namespaces e Namespaces Ignoráveis: 
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  5. Dentro do <Properties> inclua os seguintes <uap13:AutoUpdate> e os parâmetros de criança: 
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  6. Salve todas as alterações feitas no AppxManifest.
  7. Feche a janela do bloco de notas do AppxManifest e retorne ao MSIX Packaging Tool.

Observação

As instruções acima supõem que o nome do arquivo do Instalador de Aplicativo é "Update.appinstaller".

Fechar e empacotar o aplicativo do Windows

As etapas a seguir guiarão você pelo empacotamento do aplicativo do Windows como uma versão mais recente. Essas etapas supõem que você configurou as Preferências de assinatura para atender aos requisitos da sua organização ou do cliente.

  1. Selecione o botão Salvar no MSIX Packaging Tool.
  2. Na janela do prompt, selecione o botão Sim, Incremento.
  3. Navegue até o local em que deseja salvar o aplicativo do Windows recém-atualizado e selecione o botão Salvar.
  4. Selecione o botão Fechar.
  5. Feche a janela do MSIX Packaging Tool.

Instruções do Visual Studio

Para começar, verifique se está trabalhando em um dispositivo Windows 10 com o Windows 10 SDK 2104 ou superior instalado. Esse SDK é necessário para garantir que as propriedades de versão direcionada e de versão mínima sejam configuradas com os valores adequados à medida que você compila seu aplicativo.

Inserir o arquivo do instalador de aplicativo

As etapas a seguir guiarão você na inserção do arquivo do Instalador de Aplicativo no projeto do Visual Studio do aplicativo do Windows (UWP).

  1. No projeto do Visual Studio, no Gerenciador de soluções, clique com o botão direito do mouse no nome do aplicativo do Windows.
  2. Selecione Adicionar>>Item existente no menu suspenso.
  3. Navegue até o arquivo do Instalador de Aplicativo, selecione-o e, depois, selecione o botão Adicionar.
  4. No Gerenciador de Soluções, clique duas vezes em Update.appinstaller para abrir o arquivo para análise.
  5. Confirme se o arquivo do Instalador de Aplicativo está correto e feche o arquivo.

Atualizar o AppxManifest

As etapas a seguir fornecem diretrizes sobre as instruções de atualização do AppxManifest em seu projeto do Visual Studio para direcionar o arquivo do Instalador de Aplicativo recém-incorporado.

Este guia supõe que:

  • O Windows 10 SDK 2104 ou superior está instalado
  • As propriedades do projeto estão configuradas para o Windows 10, versão 2104 ou superior.
  • O nome do arquivo do Instalador de Aplicativo é Update.appinstaller
  1. No projeto do Visual Studio, selecione Compilação no menu superior.
  2. Selecione Compilar solução no menu suspenso. Verifique se a compilação do aplicativo do Windows foi bem-sucedida.
  3. Selecione Computador Local na faixa de opções para testar a funcionalidade do aplicativo do Windows.
  4. Feche o aplicativo do Windows logo após iniciar e pare a depuração.
  5. No Gerenciador de Soluções, clique com o botão direito do mouse no Package.appxmanifest
  6. Selecione Exibir código no menu suspenso.
  7. Verifique se as <Package> propriedades incluem os seguintes Namespaces e Namespaces Ignoráveis: 
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  8. Dentro do <Properties> inclua os seguintes <uap13:AutoUpdate> e os parâmetros de criança: 
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  9. Salve as alterações do arquivo e feche.

Compilar o seu aplicativo do Windows

As etapas a seguir guiarão você na criação do pacote de aplicativo do Windows para instalação em sistemas operacionais com suporte.

  1. No projeto do Visual Studio, clique com o botão direito do mouse no nome do aplicativo do Windows.
  2. Selecione Publicar>>Criar pacote do aplicativo no menu suspenso.
  3. Selecione o botão de rádio Sideload, na nova janela de diálogo Criar pacotes do aplicativo.
  4. Selecione o botão Avançar.
  5. Selecione Sim, usar o certificado atual: botão de rádio.
  6. Importe um certificado existente ou gere automaticamente um certificado para assinar seu aplicativo do Windows.
  7. Selecione o botão Avançar.
  8. Especifique a Configuração de Solução, a versão e a compilação opcional de um lote de aplicativo do Windows para seu aplicativo do Windows.
  9. Selecione o botão Criar.