desktop6:CustomInstall

Artigo
08/17/2024

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.

Nota

No momento, esse elemento destina-se a ser usado apenas por determinados tipos de jogos de computador desktop que são publicados pela Microsoft e por nossos parceiros. Ele requer o customInstallActionsde funcionalidade restrita.

Hierarquia de elementos

do pacote

extensões de <>

<desktop6:Extension>

<desktop6:CustomInstall>

Sintaxe

<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 dado	Necessário	Valor padrão
da 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 `*`.	Sim

Elementos filho

Elemento filho	Descrição
InstallActions	Especifica os arquivos do instalador que são 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.
de Desinstalação	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.

Observações

Esse elemento requer o customInstallActionsde funcionalidade restrita.

O sistema operacional usa o atributo Name dos elementos desktop6:InstallAction, desktop6:RepairActione desktop6:UninstallAction elementos 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 atributo Name. 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`
versão mínima do sistema operacional	Windows 10 versão 1903 (Build 18362)

Compartilhar via