Partilhar via

Como gerar um arquivo de modelo para conversões de linha de comando

Com a MSIX Packaging Tool, você pode realizar a conversão de duas maneiras: através da interface do usuário interativa ou através da nossa opção de linha de comando. Ao usar a linha de comando, você precisa fornecer um arquivo de modelo para que a conversão funcione com suas configurações e necessidades específicas. Este artigo ajudará a guiá-lo através do processo de geração de um arquivo de modelo que funciona para você.

Há duas maneiras de obter um arquivo de modelo que funcione para você:

  • Você pode usar a interface de utilizador da MSIX Packaging Tool. Nas configurações da ferramenta, você pode especificar que deseja gerar um arquivo de modelo de conversão com cada pacote MSIX criado.
  • Você pode pegar um modelo de exemplo e inserir manualmente as configurações necessárias para cada conversão.

Gere um arquivo de modelo de conversão a partir da MSIX Packaging Tool

  1. Inicie a MSIX Packaging Tool.
  2. Vá para as configurações no canto superior direito do aplicativo.
  3. Certifique-se de que a opção 'Gerar um arquivo de linha de comando com cada pacote' está selecionada.
  4. Faça quaisquer outras alterações ou modificações nas suas configurações que você precisa (por exemplo, itens de exclusão, códigos de saída).
  5. Guarde as definições
  6. Percorra o fluxo de trabalho do Pacote de Aplicativos usando um instalador.
    • Se você não selecionar um instalador, não poderá gerar um arquivo de modelo de conversão.
    • Se estiveres a usar um exe, vais precisar de passar um parâmetro silencioso ao instalador para gerar o ficheiro de modelo de conversão.
  7. No final da conversão, você terá um arquivo de modelo configurado com base no instalador que você escolheu e suas configurações atuais, que agora você pode reutilizar para conversões futuras.
    • Por padrão, o arquivo de modelo de conversão será salvo no mesmo local do pacote MSIX, mas você pode especificar um local de salvamento separado para o arquivo de modelo na página Criar pacote.
    • Você ainda precisará fazer algumas modificações com base no MSIX que pretende obter no final de cada conversão.

Editar manualmente o arquivo de modelo de conversão

Você pode editar manualmente os parâmetros de modelo para o arquivo de modelo de conversão para gerar um arquivo de modelo que funcione para você. Ao gerar o arquivo de modelo de conversão, preste atenção aos recursos que você adiciona ao arquivo de modelo, pois alguns podem exigir referências de esquema adicionais para funcionar.

Referência de parâmetros do modelo de conversão

Aqui está a lista completa de parâmetros que você pode usar no arquivo de modelo de conversão.

ConversionSettings Descrição
Configurações:: AllowTelemetry [opcional] Habilita o log de telemetria para essa invocação da ferramenta.
Configurações:: AplicarTodasAsCorreçõesDePreparaçãoDoComputador [opcional] Aplica todas as correções de preparação do computador recomendadas. Não pode ser definido quando outros atributos são usados.
Configurações:: GerarFicheiroDeLinhaDeComando [opcional] Copia a entrada do arquivo de modelo para o diretório SaveLocation para uso futuro.
Configurações:: AllowPromptForPassword [opcional] Instrui a ferramenta a solicitar que o usuário insira senhas para a Máquina Virtual e para o certificado de assinatura, se for necessário e não especificado.
Configurações:: EnforceMicrosoftStoreVersioningRequirements [opcional] Instrui a ferramenta a impor o esquema de controle de versão de pacotes necessário para a implantação da Microsoft Store e da Microsoft Store para Empresas.
Configurações:: Número da Porta do Servidor [opcional] Usado ao se conectar a uma máquina remota. Requerem a versão 2 do esquema de modelo.
Configurações:: AdicionarIntegridadeDoPacote [opcional] Adiciona integridade de pacote a cada MSIX gerado. Requer v5 do esquema de modelo.
Códigos de Saída Válidos do Instalador [opcional] 0 ou mais elementos ValidInstallerExitCode. Requerem a versão 2 do esquema de modelo.
ValidInstallerExitCodes:: ValidInstallerExitCode [opcional] Especifique os códigos de saída do instalador com os quais a ferramenta pode não estar familiarizada ou exigir uma reinicialização. Requerem a versão 2 do esquema de modelo.
ValidInstallerExitCodes:: ValidInstallerExitCode:: Reiniciar [opcional] Especifique se um código de saída deve acionar uma reinicialização durante a conversão. Requer a versão 3 do esquema do modelo.
Itens de Exclusão [opcional] 0 ou mais elementos FileExclusion ou RegistryExclusion. Todos os elementos FileExclusion devem aparecer antes de qualquer elemento RegistryExclusion.
[no translation changes are made since the original retains necessary technical terminology] [opcional] Um arquivo a ser excluído para empacotamento.
It is not proposed to change the technical code identifiers, so maintaining "ExclusionItems::FileExclusion::ExcludePath" is appropriate in this context. Caminho para o ficheiro a excluir do pacote.
ItensExclusão::ExclusãoRegisto [opcional] Uma chave do Registro a ser excluída para empacotamento.
ExclusionItems::RegistryExclusion::ExcludePath Caminho para o registo a ser excluído para embalagem.
PrepareComputer::D isableDefragService [opcional] Desativa o Desfragmentador do Windows enquanto o aplicativo está sendo convertido. Se definido como false, substitui ApplyAllPrepareComputerFixes.
PrepareComputer:: DesativarServiçoDePesquisaDoWindows [opcional] Desabilita o Windows Search enquanto o aplicativo está sendo convertido. Se definido como false, substitui ApplyAllPrepareComputerFixes.
PrepareComputer:: DisableSmsHostService [opcional] Desativa o SMS Host enquanto o aplicativo está sendo convertido. Se definido como false, substitui ApplyAllPrepareComputerFixes.
PrepararComputador:: DisableWindowsUpdateService [opcional] Desabilita o Windows Update enquanto o aplicativo está sendo convertido. Se definido como false, substitui ApplyAllPrepareComputerFixes.
SalvarLocalização [opcional] Um elemento para especificar o local de salvamento da ferramenta. Se não for especificado, o pacote será salvo na pasta Desktop.
SaveLocation::P ackagePath [opcional] O caminho para o arquivo ou pasta onde o pacote MSIX resultante é salvo.
SaveLocation::TemplatePath [opcional] O caminho para o arquivo ou pasta onde o modelo de linha de comando resultante é salvo.
Instalador::Path O caminho para o instalador do aplicativo.
Instalador::Argumentos [opcional] Os argumentos a serem passados para o instalador. A ferramenta executará automaticamente, de forma silenciosa, os instaladores MSI, usando o argumento "/qn /norestart INSTALLSTARTMENUSHORTCUTS=1 DISABLEADVTSHORTCUTS=1". Nota: deves passar os argumentos para que o instalador funcione em modo silencioso se estiveres a usar instaladores .exe.
Instalador::InstallLocation [opcional] O caminho completo para a pasta raiz do seu aplicativo para os arquivos instalados, se ele foi instalado (por exemplo, "C:\Program Files (x86)\MyAppInstalllocation").
Instalador::IsUnattendedInstallWithoutArgument [opcional] Este atributo deve ser usado se o aplicativo permitir a instalação 'autônoma' sem argumentos silenciosos. Este atributo é usado apenas para .exe instaladores.
Máquina virtual [opcional] Um elemento para especificar que a conversão será executada em uma máquina virtual local.
VirtualMachine::Nome O nome da máquina virtual a ser usada para o ambiente de conversão.
VirtualMachine::Nome de usuário O nome de usuário da máquina virtual a ser usada para o ambiente de conversão.
Máquina Remota [opcional] Um elemento para especificar que a conversão será executada em uma máquina remota. Requerem a versão 2 do esquema de modelo.
RemoteMachine:: Nome do Computador O nome da máquina remota a ser usada para o ambiente de conversão. Requerem a versão 2 do esquema de modelo.
RemoteMachine:: Nome de usuário O nome de usuário da máquina remota a ser usada para o ambiente de conversão. Requerem a versão 2 do esquema de modelo.
RemoteMachine:: EnableAutoLogon [opcional] Isso fará o login automático novamente ao executar uma conversão que requer uma reinicialização em uma máquina remota para que sua conversão continue perfeitamente. Requer V3 do esquema de modelo.
PackageInformation::P ackageName O nome do pacote para o seu pacote MSIX.
PackageInformation::P ackageDisplayName O Nome de Exibição do Pacote para seu pacote MSIX.
PackageInformation::P ublisherName O Publisher para o seu pacote MSIX.
PackageInformation::P ublisherDisplayName O Nome de Exibição do Editor para seu pacote MSIX.
PackageInformation::Versão O número da versão do seu pacote MSIX.
PackageInformation::P ackageDescrição [opcional] A descrição do seu pacote MSIX. Requer a versão 4 do esquema do modelo.
InformaçõesDoPacote:: NomePrincipalDoPacoteParaPacoteDeModificação [opcional] O nome de identidade do pacote principal. Isso é usado ao criar um pacote de modificação que depende de um aplicativo principal (pai).
Informações de Assinatura [opcional] Um elemento para especificar informações de assinatura para assinatura do Device Guard. Requer a versão 4 do esquema do modelo.
SigningInformation:: DeviceGuardSigning [opcional] Um elemento para especificar as informações de assinatura do Device Guard. Requer a versão 4 do esquema do modelo.
DeviceGuardSigning:: TokenFile O token de acesso necessário do Azure AD para a assinatura do Device Guard no formato JSON. Requer esquema de modelo v4.
DeviceGuardSigning:: TimestampUrl [opcional] Fornece um carimbo de data/hora no momento da assinatura com o Device Guard para garantir que seu aplicativo seja instalado além do tempo de vida do certificado. Requer a versão 4 do esquema do modelo.
Aplicações [opcional] 0 ou mais elementos de aplicativo para configurar as entradas de aplicativo em seu pacote MSIX.
Aplicação::Id O ID do aplicativo para seu aplicativo MSIX. Esse ID será usado para a entrada do aplicativo detetada que corresponde ao ExecutableName especificado. Você pode ter vários valores de ID de aplicativo para executáveis no pacote.

Esse valor é o identificador exclusivo do aplicativo dentro do pacote. Esse valor às vezes é chamado de PRAID (identificador de aplicativo relativo ao pacote). O ID deve ser exclusivo dentro do pacote (o mesmo ID não pode ser usado mais de uma vez no mesmo pacote). No entanto, o ID não deve ser exclusivo globalmente. Pode haver outro pacote no sistema que usa o mesmo ID.

Esta cadeia de caracteres contém campos alfanuméricos separados por pontos. Cada campo deve começar com um caractere alfabético ASCII. Não é possível usá-los como valores de campo: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8" e "LPT9".
Aplicação::DisplayName O Nome de Exibição do Aplicativo para seu pacote MSIX. Esse Nome de Exibição será usado para a entrada do aplicativo detetada que corresponde ao ExecutableName especificado
Aplicação::ExecutableName O nome executável da aplicação MSIX que será adicionado ao manifesto do pacote. A entrada do aplicativo correspondente será ignorada se nenhum aplicativo com esse nome for detetado.
Aplicação::Descrição [opcional] A descrição do aplicativo para seu aplicativo MSIX. Se não for usado, o Application DisplayName será usado. Esta descrição será usada para a entrada do aplicativo detetada que corresponde ao ExecutableName especificado
Capacidades [opcional] 0 ou mais elementos de capacidade para adicionar funcionalidades customizadas ao seu pacote MSIX. O recurso "runFullTrust" é adicionado por padrão durante a conversão.
Capacidade::Nome A possibilidade de adicionar ao seu pacote MSIX.

Exemplo de arquivo de modelo de conversão

<MsixPackagingToolTemplate
    xmlns="http://schemas.microsoft.com/appx/msixpackagingtool/template/2018"
    xmlns:V2="http://schemas.microsoft.com/msix/msixpackagingtool/template/1904"
    xmlns:V3="http://schemas.microsoft.com/msix/msixpackagingtool/template/1907"
    xmlns:V4="http://schemas.microsoft.com/msix/msixpackagingtool/template/1910"
    xmlns:V5="http://schemas.microsoft.com/msix/msixpackagingtool/template/2001">
<!--Note: You only need to include xmlns:v2 - xmlns:v5 if you are using one of the features that use those schemas -->

    <Settings
        AllowTelemetry="true"
        ApplyAllPrepareComputerFixes="true"
        GenerateCommandLineFile="true"
        AllowPromptForPassword="false" 
	    EnforceMicrosoftStoreVersioningRequirements="false"
        v2:ServerPortNumber="1599"
        v5:AddPackageIntegrity="true">    

	<!--Note: Exclusion items are optional and if declared take precedence over the default tool exclusion items
        <ExclusionItems>
            <FileExclusion ExcludePath="[{CryptoKeys}]" />
            <FileExclusion ExcludePath="[{Common AppData}]\Microsoft\Crypto" />
            <FileExclusion ExcludePath="[{Common AppData}]\Microsoft\Search\Data" />
            <FileExclusion ExcludePath="[{Cookies}]" />
            <FileExclusion ExcludePath="[{History}]" />
            <FileExclusion ExcludePath="[{Cache}]" />
            <FileExclusion ExcludePath="[{Personal}]" />
            <FileExclusion ExcludePath="[{Profile}]\Local Settings" />
            <FileExclusion ExcludePath="[{Profile}]\NTUSER.DAT.LOG1" />
            <FileExclusion ExcludePath="[{Profile}]\ NTUSER.DAT.LOG2" />
            <FileExclusion ExcludePath="[{Recent}]" />
            <FileExclusion ExcludePath="[{Windows}]\debug" />
            <FileExclusion ExcludePath="[{Windows}]\Logs\CBS" />
            <FileExclusion ExcludePath="[{Windows}]\Temp" />
            <FileExclusion ExcludePath="[{Windows}]\WinSxS\ManifestCache" />
            <FileExclusion ExcludePath="[{Windows}]\WindowsUpdate.log" />
	    <FileExclusion ExcludePath="[{Windows}]\Installer" />
            <FileExclusion ExcludePath="[{AppVPackageDrive}]\$Recycle.Bin " />
            <FileExclusion ExcludePath="[{AppVPackageDrive}]\System Volume Information" />
	    <FileExclusion ExcludePath="[{AppVPackageDrive}]\Config.Msi" />
            <FileExclusion ExcludePath="[{AppData}]\Microsoft\AppV" />
            <FileExclusion ExcludePath="[{Common AppData}]\Microsoft\Microsoft Security Client" />
            <FileExclusion ExcludePath="[{Common AppData}]\Microsoft\Microsoft Antimalware" />
            <FileExclusion ExcludePath="[{Common AppData}]\Microsoft\Windows Defender" />
            <FileExclusion ExcludePath="[{ProgramFiles}]\Microsoft Security Client" />
            <FileExclusion ExcludePath="[{ProgramFiles}]\Windows Defender" />
	    <FileExclusion ExcludePath="[{ProgramFiles}]\WindowsApps" />
            <FileExclusion ExcludePath="[{Local AppData}]\Temp" />
	    <FileExclusion ExcludePath="[{Local AppData}]\Microsoft\Windows" />
	    <FileExclusion ExcludePath="[{Local AppData}]\Packages" />

            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Wow6432Node\Microsoft\Cryptography" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Microsoft\Cryptography" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Microsoft\Microsoft Antimalware" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Microsoft\Microsoft Antimalware Setup" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Microsoft\Microsoft Security Client" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Policies\Microsoft\Microsoft Antimalware" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Policies\Microsoft\Windows Defender" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Microsoft\Windows\CurrentVersion\Explorer\StreamMRU" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Explorer\StreamMRU" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Microsoft\Windows\CurrentVersion\Explorer\Streams" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Explorer\Streams" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Microsoft\AppV" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Wow6432Node\Microsoft\AppV" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Microsoft\AppV" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Wow6432Node\Microsoft\AppV" />
        </ExclusionItems>
	-->
    
    <!--Note: Specifying an installer exit code will allow you to automatically trigger a reboot during your conversion
      <v2:ValidInstallerExitCodes>
        <V2:ValidInstallerExitCode ExitCode="3010" V3:Reboot="true"/>
        <V2:ValidInstallerExitCode ExitCode="1641"/>
      </v2:ValidInstallerExitCodes>
    -->
	    
    </Settings>

    <!--Note: this section takes precedence over the Settings::ApplyAllPrepareComputerFixes attribute and is optional
    <PrepareComputer
        DisableDefragService="true"
        DisableWindowsSearchService="true"
        DisableSmsHostService="true"
        DisableWindowsUpdateService="true"/>
    -->

    <SaveLocation
        PackagePath="C:\users\user\Desktop\MyPackage.msix" 
        TemplatePath="C:\users\user\Desktop\MyTemplate.xml" />

    <Installer
        Path="C:\MyAppInstaller.msi"
        InstallLocation="C:\Program Files\MyAppInstallLocation" />
	
    <!--NOTE: This section specifies that the conversion will be run on a local Virtual Machine. This is optional if you want to change your conversion environment from the default local machine.
    <VirtualMachine Name="vmname" Username="vmusername"/>
    -->

    <!--NOTE: This section specifies that the conversion will be run on a remote machine.This is optional if you want to change your conversion environment from the default local machine.
    <v2:RemoteMachine ComputerName="vmname" Username="vmusername" v3:EnableAutoLogon="true"/>
    -->

    <PackageInformation
        PackageName="MyAppPackageName"
        PackageDisplayName="MyApp Display Name"
        PublisherName="CN=MyPublisher"
        PublisherDisplayName="MyPublisher Display Name"
        Version="1.1.0.0"
        MainPackageNameForModificationPackage="MainPackageIdentityName">

    <!--Note: This is optional, if you want to sign your package with Device Guard signing
        <v4:SigningInformation>
            <v4:DeviceGuardSigning
                Tokenfile="tokenfile.json"
                TimestampUrl="https://mytimestamp.com"/>
        </v4:SigningInformation>
    -->
        
	<!--NOTE: This ID will be used if the Application entry detected matches the specified ExecutableName
        <Applications>
            <Application
                Id="MyApp1"
                Description="MyApp"
                DisplayName="My App"
                ExecutableName="MyApp.exe"/>
        </Applications>
	-->

	<!--NOTE: This is optional as “runFullTrust” capability is added by default during conversion
        <Capabilities>
            <Capability Name="runFullTrust" />
        </Capabilities>
	-->
	    
    </PackageInformation>
</MsixPackagingToolTemplate>
  • Last updated on