desktop6:InstallAction

Artigo
08/17/2024

Especifica um arquivo do instalador (.exe ou .msi) que é executado antes do primeiro lançamento do aplicativo da área de trabalho.

Nota

No momento, esse elemento destina-se a ser usado apenas por jogos de computador da área de trabalho que são empacotados em um contêiner MSIXVC. Ele requer o customInstallActionsde funcionalidade restrita.

Hierarquia de elementos

do pacote

extensões de <>

<desktop6:Extension>

<desktop6:CustomInstall>

<desktop6:InstallActions>

<desktop6:InstallAction>

Sintaxe

<desktop6:InstallAction
  File = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  Name = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  Arguments = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' />

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dado	Necessário
de arquivo	O nome do arquivo a ser executado (.exe ou .msi). Esse arquivo deve existir em seu pacote. Você pode especificar um caminho relativo ao atributo pasta do desktop6. Elemento CustomInstall. Você não pode especificar um caminho absoluto e o caminho relativo não deve começar com um caractere `\`.	Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento que não pode conter esses caracteres: `<`, `>`, `:`, `"`, `\|`, `?`ou `*`.	Sim
Name	O nome da ação de instalação. Esse nome é usado para identificar a ação de instalação e o sistema operacional usa esse nome para rastrear quais ações foram executadas com êxito. Verifique se esse valor corresponde ao atributo `Name` do desktop6:RepairAction e desktop6:UninstallAction elementos que você deseja executar como parte da mesma sequência. Esse nome deve ser exclusivo no elemento de desktop6:InstallActions pai, mas pode ser compartilhado por outras ações nos elementos desktop6:RepairActions e desktop6:UninstallActions elementos.	Uma cadeia de caracteres com um valor entre 1 e 32767 caracteres de comprimento com um caractere não whitespace no início e no final.	Sim
argumentos	Argumentos opcionais a serem passados para o arquivo do instalador.	Uma cadeia de caracteres com um valor entre 1 e 32767 caracteres de comprimento com um caractere não whitespace no início e no final.	Não

Elementos filho

Nenhum

Elementos pai

Elemento pai	Descrição
desktop6:InstallActions	Especifica os arquivos do instalador (.exe ou .msi) que são executados antes do primeiro lançamento do aplicativo da área de trabalho.

Observações

Esse elemento requer o customInstallActionsde funcionalidade restrita.

Exemplos

<Package
  xmlns:desktop6="http://schemas.microsoft.com/appx/manifest/desktop/windows10/6"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  IgnorableNamespaces="rescap desktop6">

  <!-- ... -->
  <!-- Other entries omitted for brevity. -->
  <!-- ... -->

  <Extensions>
    <desktop6:Extension Category="windows.customInstall">
      <desktop6:CustomInstall Folder="MyInstallers">
        <desktop6:InstallActions>
          <desktop6:InstallAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/add /silent" />
        </desktop6:InstallActions>
        <desktop6:RepairActions>
          <desktop6:RepairAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/add /silent /force" />
        </desktop6:RepairActions>
        <desktop6:UninstallActions>
          <desktop6:UninstallAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/remove /silent" />
        </desktop6:UninstallActions>
      </desktop6:CustomInstall>
    </desktop6:Extension>
  </Extensions>

  <Capabilities>
    <rescap:Capability Name="customInstallActions"/>
  </Capabilities>
</Package>

Requisitos

Item	Valor
Namespace	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/6`
versão mínima do sistema operacional	Windows 10 versão 1903 (Build 18362)

Compartilhar via