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.

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)