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

Importante

O uso de um arquivo Instalador de Aplicativo está disponível Windows versão 10.0.21300.0. Para usar esse recurso, verifique se MaxVersionTested está referenciando este ou uma versão mais recente do sistema operacional Windows sistema operacional.

O Instalador de Aplicativo arquivo fornece um caminho de atualização que um aplicativo Windows pode percorrer pesquisando atualizações e reparos.

Ao usar o Visual Studio para criar e publicar seu aplicativo Windows com um arquivo Instalador de Aplicativo inserido, você deve garantir que o SDK do Windows 10 2104 (ou mais novo) tenha sido instalado e que as propriedades do projeto têm Windows 10 21H1 (ou mais recentes) como as versões com destino (MaxVersionTested e MinVersion). Se isso não tiver sido configurado, o Windows aplicativo não definirá as configurações inseridas do AppInstaller para o dispositivo quando o aplicativo Windows estiver instalado.

Como - Ferramenta de Empacotamento MSIX

As etapas a seguir orientarão você sobre como usar a Ferramenta de Empacotamento MSIX para editar um aplicativo de Windows existente para incluir um aplicativo Instalador de Aplicativo inserido.

Observação

As diretrizes a seguir pressuem que você criou anteriormente o arquivo Instalador de Aplicativo usando o Visual Studio para automatizar a criação de um arquivo Instalador de Aplicativo, com o uso do Toolkit MSIX ou manualmente. Para obter diretrizes sobre como criar um Instalador de Aplicativo, visite um dos seguintes artigos do Docs:

Abra o Windows para Edição

As etapas a seguir orientarão você sobre como usar o Aplicativo da Ferramenta de Empacotamento MSIX da Microsoft para começar a editar um Windows aplicativo.

  1. Iniciar a Ferramenta de Empacotamento MSIX da Microsoft (disponível no Microsoft Store: Ferramenta de Empacotamento MSIX).
  2. Selecione o botão Editor de pacotes para editar um pacote existente.
  3. Selecione o botão Procurar e, na janela solicitada, localize seu Windows aplicativo e selecione o botão Abrir.
  4. Selecione o botão Abrir Pacote.

Importar o Instalador de Aplicativo para o aplicativo Windows aplicativo

As etapas a seguir orientarão você sobre como inserir um arquivo Instalador de Aplicativo em um aplicativo de Windows existente usando o Aplicativo microsoft MSIX Packaging Tool. Essas etapas pressuem que você já tenha aberto seu aplicativo Windows para edição usando o aplicativo Microsoft MSIX Packaging Tool.

  1. No lado esquerdo da Ferramenta de Empacotamento MSIX,selecione Arquivos de pacote.
  2. Expanda a entrada Pacote dentro do 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 dentro da janela solicitado, navegue até o arquivo Instalador de Aplicativo e selecione o botão Abrir.
  5. Selecione o botão Salvar.

Atualizar o AppxManifest

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

  1. No lado esquerdo da Ferramenta de Empacotamento MSIX,selecione Informações do pacote.
  2. Role até a parte inferior da seção Informações do pacote.
  3. Selecione o botão Abrir arquivo para abrir o AppxManifest em uma Bloco de notas janela.
  4. Verifique se <Package> as 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> parâmetros filho e :
    <Properties>
        ...
        <uap13:AutoUpdate>
            <uap13:AppInstaller File="Update.appinstaller" />
        </uap13:AutoUpdate>
    </Properties>
    
  6. Salve as alterações feitas no AppxManifest.
  7. Feche a janela Bloco de notas AppxManifest e retorne à Ferramenta de Empacotamento MSIX.

Observação

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

Fechar e empacote o Windows aplicativo

As etapas a seguir orientarão você durante o empacotamento Windows aplicativo como uma versão mais recente. Essas etapas pressuem que você tenha configurado suas Preferências de Assinatura para atender aos requisitos de sua organização ou cliente.

  1. Na Ferramenta de Empacotamento MSIX, selecione o botão Salvar.
  2. Na janela solicitado, selecione o botão Sim, Incrementar.
  3. Navegue até o local em que deseja salvar seu aplicativo Windows e selecione o botão Salvar.
  4. Selecione o botão Fechar .
  5. Feche a janela Ferramenta de Empacotamento MSIX.

Como - Visual Studio

Antes de começar, verifique se você está trabalhando em um dispositivo Windows 10 com o SDK Windows 10 2104 ou superior instalado. Esse SDK é necessário para garantir que as propriedades Versão de Destino e Versão Mínima sejam definidas com os valores apropriados à medida que você cria seu aplicativo.

Inserir o arquivo Instalador de Aplicativo dados

As etapas a seguir orientarão você na Instalador de Aplicativo arquivo Windows aplicativo (UWP) Visual Studio projeto.

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

Atualizando o AppxManifest

As etapas a seguir fornecerão diretrizes sobre como atualizar o AppxManifest em seu projeto Visual Studio para direcionar o arquivo de Instalador de Aplicativo inserido recentemente.

Este guia pressupo:

  • O Windows 10 SDK 2104 ou superior está instalado
  • As propriedades do projeto são definidas como Windows 10, versão 2104 ou superior.
  • O nome do arquivo Instalador de Aplicativo é Update.appinstaller
  1. No projeto Visual Studio ,selecione Criar no menu superior.
  2. Selecione Criar Solução no menu suspenso. Certifique-se de que Windows build do aplicativo foi bem-sucedido.
  3. Selecione Computador Local na faixa de opções para testar a funcionalidade do Windows aplicativo.
  4. Feche o Windows logo após o lançamento e pare a depuração.
  5. No Gerenciador de Soluções, clique com o botão direito do mouse em Package.appxmanifest
  6. Selecione Exibir Código no menu suspenso.
  7. Verifique se <Package> as 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> parâmetros filho e :
    <Properties>
        ...
        <uap13:AutoUpdate>
            <uap13:AppInstaller File="Update.appinstaller" />
        </uap13:AutoUpdate>
    </Properties>
    
  9. Salve suas alterações no arquivo e feche.

Criando seu Windows aplicativo

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

  1. No projeto Visual Studio ,clique com o botão direito do mouse no Windows do aplicativo.
  2. Selecione PublicarCriar Pacotes de Aplicativos... no menu suspenso.
  3. Selecione o botão de opção Sideloading, na nova janela de diálogo Criar Pacotes de Aplicativos.
  4. Selecione o botão Avançar.
  5. Selecione o botão de opção Sim, use o certificado atual: .
  6. Importe um Certificado existente ou gere automaticamente um certificado para assinar seu Windows aplicativo.
  7. Selecione o botão Avançar.
  8. Especifique a Configuração da Solução, a versão e o build opcional de um pacote Windows aplicativo para seu Windows aplicativo.
  9. Selecione o botão Criar.