Crie um pacote MSIX a partir de qualquer instalador de desktop (MSI, EXE, ClickOnce ou App-V)

Você pode usar a MSIX Packaging Tool para criar um pacote de aplicativo MSIX a partir de qualquer uma das seguintes opções:

• MSI
• EXE
• ClickOnce
• App-V
• Guião
• Instalação manual

Este documento irá orientá-lo através de como pegar quaisquer ativos existentes que você tem e convertê-los para MSIX.

Antes de iniciar a conversão, recomendamos garantir que você mesmo entenda o instalador e se este será convertido.

Também recomendamos seguir as melhores práticas para configurar o seu ambiente e a Ferramenta de Embalagem MSIX para conversão.

Quando a ferramenta for iniciada pela primeira vez, você será solicitado a fornecer consentimento para o envio de dados de telemetria. É importante notar que os dados de diagnóstico que você compartilha vêm apenas do aplicativo e nunca são usados para identificar ou entrar em contato com você.

Criar um pacote de aplicativo é a opção mais usada. É aqui que você criará um pacote MSIX a partir de um instalador ou pela instalação manual da carga útil do aplicativo.

Método de embalagem

Selecione uma opção para sua máquina de conversão:

• Se você já estiver trabalhando em um ambiente limpo, selecione Criar pacote neste computador

• Se você quiser se conectar a uma máquina virtual ou remota existente, selecione Criar pacote em uma máquina remota

  • Você precisará configurar sua máquina remota antes de poder converter nela

• Se você tiver uma máquina virtual local em sua máquina na qual deseja converter, selecione Criar pacote em uma máquina virtual local

  • Observe que só suportamos Hyper-V máquinas virtuais, se você quiser usar outro produto de virtualização, você pode se conectar usando a opção de máquina remota.

• Clique em Avançar

Preparar o computador

Em seguida, a página Preparar computador fornece opções para preparar o computador para empacotamento.

O MSIX Packaging Tool Driver é necessário e a ferramenta tentará ativá-lo automaticamente se não estiver habilitado. A ferramenta irá primeiro verificar com o DISM para ver se o driver está instalado. Se você tiver um problema, tente verificar nossa documentação de solução de problemas e, em seguida, arquivar um problema do Hub de Feedback se o problema persistir.

O Windows Update está ativo Desativaremos temporariamente o Windows Update durante o empacotamento para que não coletemos dados estranhos.

• A caixa de seleção Reinicialização pendente está desativada por padrão. Você precisará reiniciar manualmente a máquina e, em seguida, iniciar a ferramenta novamente se for solicitado que as operações pendentes precisam ser reinicializadas. Isso não é necessário, apenas recomendado.

• [Opcional] Marque a caixa de seleção Windows Search está ativo e selecione Desativar selecionado se decidir desativar o serviço de pesquisa.

  • Isso não é obrigatório, apenas recomendado.
  • Uma vez desativada, a ferramenta atualizará o campo de status para Desativado.

• [Opcional] Marque a caixa para SMS Host is Ative e selecione Desativar selecionado se optar por desativar o serviço de host.

  • Isso não é obrigatório, apenas recomendado.
  • Uma vez desativada, a ferramenta atualizará o campo de status para Desativado.

Quando terminar de preparar a máquina, clique em Avançar.

Escolha o instalador que deseja empacotar

A primeira coisa que você vai querer fazer é entender o que vai acontecer com o instalador que você deseja converter. Com qualquer um desses instaladores, você pode especificá-los aqui para simplificar seu fluxo de trabalho ou executá-lo manualmente no momento da instalação posteriormente no fluxo de trabalho.

Instaladores MSI

Se você estiver convertendo um instalador de .msi, você pode simplesmente procurar por ele e especificar o .msi. Se você tiver um arquivo .mst ou .msp acompanhante, poderá especificá-lo no campo de argumentos do instalador. Um dos benefícios de especificar o seu .msi aqui é que podemos extrair todas as informações do pacote a partir dele, economizando-lhe tempo na próxima etapa da conversão.

App-V instaladores

Se você estiver convertendo usando um App-V, este é um processo muito simples para você. Tudo o que precisas fazer é especificar um arquivo App-V, e és imediatamente direcionado para a criação de uma página MSIX. Isso ocorre porque o manifesto do pacote simplesmente precisa ser traduzido para um pacote MSIX e, em seguida, ele funciona apenas como um MSIX. A ressalva aqui é que a ferramenta só suporta App-V 5.1 - se o seu App-V é a versão 4.x, recomendamos que você pegue o instalador de origem e, em seguida, convertê-lo diretamente para MSIX.

Instaladores EXE

Se estiver a converter um instalador .exe, pode especificar o instalador neste momento. Devido à falta de consistência de formato com um exe, você precisará inserir manualmente as informações do pacote para o seu instalador.

Instaladores ClickOnce

Se você estiver convertendo um instalador ClickOnce, você pode especificar o instalador neste ponto. Como um .exe, você precisará inserir manualmente as informações do pacote para o seu instalador.

Roteiros

Se você estiver usando um script para instalar seu aplicativo, você pode especificar a linha de comando aqui. Como alternativa, você pode deixar esse campo em branco e executar o script manualmente durante a fase de instalação.

Instalação manual

Se desejar executar manualmente o instalador ou executar as ações do instalador manualmente, você pode deixar o campo do instalador em branco e, durante a fase de instalação, executar as ações necessárias para o instalador.

Se você estiver tentando gerar um arquivo de modelo de conversão, não poderá fazê-lo sem especificar um instalador.

Se você tiver quaisquer argumentos de instalador, você pode inserir o argumento desejado no campo fornecido. Este campo aceita qualquer cadeia de caracteres.

Preferência de assinatura

Em Preferência de assinatura, selecione uma opção de assinatura. Você também pode definir isso como padrão em suas configurações, o que salvará algumas etapas cada vez que você converter.

• Assinar com a assinatura do Device Guard Esta opção permite-lhe iniciar sessão na sua conta do Microsoft Ative Directory que configurou para utilizar com a assinatura do Device Guard, que é um serviço de assinatura que a Microsoft fornece onde não precisa de fornecer o seu próprio certificado. Saiba mais sobre como configurar sua conta e sobre a assinatura do Device Guard aqui.
• Assinar com um certificado(.pfx) Procure e selecione seu arquivo de certificado .pfx. Se o certificado estiver protegido por senha, digite a senha na caixa senha.
• Especificar um arquivo .cer (não assina) Esta opção permite-lhe especificar um ficheiro .cer. Isso é útil quando você não deseja assinar o pacote, mas deseja garantir que as informações do editor correspondam ao assunto do certificado que será usado para assinatura.
• Não assine o pacote Selecione esta opção se você vai assinar seu pacote em um momento posterior. Observação : você não pode instalar um pacote MSIX se ele não estiver assinado
• Ao assinar, é altamente recomendável adicionar um carimbo de data/hora ao seu certificado para que a validade do seu certificado possa durar mais do que a data de validade. O formato aceito é uma URL do servidor de carimbo de data/hora RFC 3161.

Clique Avançar para continuar.

Informações sobre o pacote

Depois de optar por empacotar seu aplicativo em uma máquina virtual existente, você deve fornecer informações sobre o aplicativo. A ferramenta tentará preencher automaticamente esses campos com base nas informações disponíveis do instalador. Você sempre terá a opção de atualizar as entradas conforme necessário. Se o campo for um asterisco*, é obrigatório. A ajuda em linha é fornecida se a entrada não for válida.

• Nome do pacote:
  • Obrigatório e corresponde ao Nome da identidade do pacote no manifesto para descrever o conteúdo do pacote.
  • Não é mostrado ao utilizador final.
  • É sensível a maiúsculas e não pode conter espaços.
  • Pode aceitar seqüência entre 3 e 50 caracteres de comprimento que consiste em caracteres alfanuméricos, ponto e traço.
  • Não pode terminar com um ponto final e ser um destes: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8" e "LPT9".
• Nome de exibição do pacote:
  • Obrigatório e corresponde ao pacote no manifesto para exibir um nome de pacote amigável para o usuário, no menu Iniciar e páginas de configurações.
  • O campo aceita uma cadeia de caracteres entre 1 e 256 caracteres e é localizável.
• Nome do editor:
  • Obrigatório e corresponde ao pacote que descreve as informações do editor.
  • O atributo Publisher deve corresponder às informações de assunto do editor do certificado usado para assinar um pacote.
  • Este campo aceita uma cadeia de caracteres entre 1 e 8192 caracteres que se ajusta à expressão regular de um nome distinto : "(CN | L | O | OU | E | C | S | RUA | T | G | I | SN | DC | NÚMERO DE SÉRIE | Descrição | Código Postal | POBox | Telefone | X21Endereço | dnQualificador | (OID.(0 | [1-9][0-9])(.(0 | [1-9][0-9]))+))=(([^,+="<>#;])+ | ".")(, ((CN | L | O | OU | E | C | S | RUA | T | G | I | SN | DC | NÚMERO DE SÉRIE | Descrição | Código Postal | POBox | Telefone | X21Endereço | dnQualificador | (OID.(0 | [1-9][0-9])(.(0 | [1-9][0-9]))+))=(([^,+="<>#;])+ | ".")))*".
• Nome de exibição do editor:
  • Obrigatório e corresponde ao pacote no manifesto para exibir um nome de editor amigável para o usuário, nas páginas Instalador do aplicativo e configurações.
  • O campo aceita uma cadeia de caracteres entre 1 e 256 caracteres e é localizável.
• Versão:
  • Obrigatório e corresponde ao pacote no ficheiro manifest para indicar o número da versão do pacote.
  • Este campo aceita uma cadeia de caracteres de versão em notação quádrupla: "Major.Minor.Build.Revision".
• Descrição:
  • Este campo é opcional.
• Local de instalação:
  • Este é o local para o qual o instalador vai copiar a carga útil do aplicativo (geralmente a pasta Arquivos de Programas).
  • Este campo é opcional, mas recomendado quando a carga útil do aplicativo está sendo instalada fora das pastas Arquivos de Programas.
  • Navegue e selecione um caminho de pasta.
  • Certifique-se de que este ficheiro corresponde à localização de instalação do instalador enquanto efetua a operação de instalação da aplicação.
• Adicione suporte para MSIX Core a este pacote.
  • Quando selecionada, essa caixa de seleção revelará uma lista suspensa que permitirá que você selecione uma versão do Windows para suporte ao MSIX Core para o pacote que você está gerando.

Instalação

• Esta é a fase de instalação onde a ferramenta está monitorando e capturando as operações de instalação do aplicativo.
• A ferramenta iniciará o instalador no ambiente especificado anteriormente e você precisará passar pelo assistente do instalador para instalar o aplicativo.
  • Verifique se o caminho de instalação corresponde ao que foi definido anteriormente na página de informações do pacote.
  • Talvez seja necessário criar um atalho na área de trabalho para o aplicativo recém-instalado.
  • Depois de concluir o assistente de instalação do aplicativo, certifique-se de concluir ou fechar o assistente de instalação.
  • Se você precisar executar vários instaladores, você pode fazer isso manualmente neste ponto.
  • Se o aplicativo precisar de outros pré-requisitos, você precisará instalá-los agora.
  • Se o aplicativo precisar do .Net 3.5/20, adicione o recurso opcional ao Windows.
• Se você não especificou um instalador anteriormente, aqui é onde você pode executar manualmente o instalador ou script.
• Se o instalador exigir uma reinicialização, você pode executar uma reinicialização manual ou usar o botão 'reiniciar' para executar a reinicialização, e você retornará a este ponto no processo de conversão após a reinicialização.
• Quando concluir a instalação do aplicativo, clique em Avançar.

Gerenciar as primeiras tarefas de inicialização

Esta página mostra os executáveis do aplicativo que a ferramenta capturou. Recomendamos iniciar o aplicativo pelo menos uma vez para capturar as primeiras tarefas de inicialização.

Você pode iniciar o executável selecionando-o e clicando em executar. Você também pode remover quaisquer pontos de entrada desnecessários selecionando-os e clicando em remover.

Se houver vários aplicativos, marque a caixa que corresponde ao ponto de entrada principal. Se não vires a aplicação .exe aqui, navega manualmente e executa-a. Em seguida, atualize a lista.

Clique em Avançar Você será solicitado com um pop-up solicitando a confirmação de que terminou a instalação do aplicativo e o gerenciamento das primeiras tarefas de inicialização.

• Se tiver terminado, clique em Sim, seguir em frente.
• Se não tiver terminado, clique em Não, não terminei. Você será levado de volta para a última página onde você pode iniciar aplicativos, instalar ou copiar outros arquivos e dlls/executáveis.

Relatório de serviços

A partir da versão 1.2019.1220.0 da MSIX Packaging Tool, você pode converter um instalador com serviços e, por isso, adicionamos uma página de relatório de Serviços. Se nenhum serviço for detetado, você ainda verá esta página, mas ela ficará vazia com uma mensagem informando que nenhum serviço foi detetado na parte superior da página.

A página Relatório de serviços lista os serviços que foram detetados no instalador durante a conversão. Os serviços que têm todas as informações de que precisam e são suportados serão mostrados na tabela Incluídos . Os serviços que precisam de informações adicionais, precisam de uma correção ou não são suportados serão mostrados na tabela Excluídos .

Para corrigir um serviço ou ver dados adicionais sobre o serviço, clique duas vezes na entrada de serviço na tabela para exibir um pop-up com mais informações sobre o serviço. Você pode editar algumas dessas informações, se necessário.

• Nome da chave: O nome do serviço. Isso não é editável.
• Descrição: A descrição da entrada de serviço.
• Nome para exibição: O nome para exibição do serviço.
• Caminho da imagem: Localização do executável do serviço. Isso não é editável.
• Iniciar conta: A conta inicial para o serviço.
• Tipo de inicialização: Tipo de inicialização para o serviço. Suporta automático, manual e desativado.
• Argumentos: Argumentos a serem executados quando o serviço for iniciado.
• Dependências: Dependências para o serviço.

Depois que um serviço for corrigido, você poderá movê-lo para a tabela Incluído ou optar por deixá-lo na tabela Excluído se não quiser que ele seja incluído no pacote final. Para obter informações adicionais, consulte a documentação dos serviços.

Criar pacote

• Forneça um local para salvar o pacote MSIX.
• Por padrão, os pacotes são salvos na pasta de dados do aplicativo local.
• Você pode definir o local de salvamento padrão no menu Configurações.
• Se você estiver gerando um arquivo de modelo de conversão, também poderá especificar um local de salvamento diferente para esse arquivo de modelo se não quiser que ele esteja no mesmo local do pacote MSIX.
• Se quiser continuar a editar o conteúdo e as propriedades do pacote antes de salvar o pacote MSIX, você pode selecionar Editor de pacotes e ser levado para o editor de pacotes.
• Clique em Criar para criar o pacote MSIX.

Você receberá um pop-up quando o pacote for criado. Esse pop-up incluirá o local de salvamento, vinculado ao local do arquivo do pacote recém-criado. Ele também inclui um link para o local dos arquivos de log para a MSIX Packaging Tool. Você pode fechar este pop-up e ser redirecionado para a página de boas-vindas. Você também pode selecionar Editor de pacotes para ver e modificar o conteúdo e as propriedades do pacote.