desktop6:CustomInstall

Permite que seu aplicativo da área de trabalho especifique um ou mais arquivos de instalador adicionais (.exe ou .msi) instalados com seu aplicativo da área de trabalho. Por exemplo, isso é útil para aplicativos que agrupam um componente redistribuível de terceiros.

Observação

No momento, esse elemento destina-se a ser usado apenas por determinados tipos de jogos de computador da área de trabalho que são publicados pela Microsoft e por nossos parceiros. Ele requer a funcionalidaderestrita customInstallActions.

Hierarquia de elementos

<Pacote>

    <Extensões>

         <desktop6:Extension>

              <desktop6:CustomInstall>

Syntax

<desktop6:CustomInstall
  Folder = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.' 
  desktop8:RunAsUser = 'An optional boolean value.'>

  <!-- Child elements -->
  desktop6:InstallActions
  desktop6:RepairActions
  desktop6:UninstallActions?

</desktop6:CustomInstall>

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Obrigatório	Valor padrão
Pasta	O nome da pasta de pacote que contém todos os arquivos necessários para todas as ações personalizadas. Essa pasta pode conter subpastas.	Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento que não pode conter esses caracteres: <, >, :, , ", |?ou *.	Yes

Elementos filho

Elemento filho	Descrição
InstallActions	Especifica os arquivos do instalador executados antes do primeiro lançamento do aplicativo da área de trabalho.
RepairActions	Especifica os arquivos do instalador que são executados quando o usuário seleciona as opções de reparo ou redefinição na página Configurações do aplicativo da área de trabalho.
DesinstalarActions	Especifica arquivos do instalador que são executados quando o usuário desinstala seu aplicativo da área de trabalho.

Elementos pai

Elemento pai	Descrição
desktop6:Extension	Declara um ponto de extensibilidade para o aplicativo da área de trabalho.
desktop8:RunAsUser	Indica se a tarefa deve ser executada como o usuário atual.

Comentários

Esse elemento requer a funcionalidade restritacustomInstallActions.

O sistema operacional usa o Name atributo dos elementos desktop6:InstallAction, desktop6:RepairAction e desktop6:UninstallAction para identificar um conjunto relacionado de ações de instalação, reparo e desinstalação. Para especificar um conjunto relacionado de ações que devem ser executadas em conjunto entre si, verifique se elas têm o mesmo valor para o Name atributo . O sistema operacional executará uma ação de desinstalação somente se a ação de instalação ou reparo correspondente tiver sido executada.

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
Minimum OS Version	Windows 10 versão 1903 (Build 18362)