desktop6:CustomInstall

Permite a la aplicación de escritorio especificar uno o varios archivos de instalador adicionales (.exe o .msi) que se instalan con la aplicación de escritorio. Por ejemplo, esto es útil para las aplicaciones que agrupan un componente redistribuible de terceros.

Nota

Actualmente, este elemento está pensado para ser utilizado solo por determinados tipos de juegos de pc de escritorio publicados por Microsoft y nuestros asociados. Requiere la funcionalidad restringidacustomInstallActions.

Jerarquía de elemento

<Paquete>

    <Extensiones>

         <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>

Clave

? opcional (cero o uno)

Atributos y elementos

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio	Valor predeterminado
Carpeta	El nombre de la carpeta del paquete que contiene todos los archivos requiere para todas las acciones personalizadas. Esta carpeta puede contener subcarpetas.	Cadena con un valor entre 1 y 256 caracteres de longitud que no puede contener estos caracteres: <, >, :, ", |, ?o *.	Sí

Elementos secundarios

Elemento secundario	Descripción
InstallActions	Especifica los archivos del instalador que se ejecutan antes del primer inicio de la aplicación de escritorio.
RepairActions	Especifica los archivos del instalador que se ejecutan cuando el usuario selecciona las opciones de reparación o restablecimiento en la página Configuración de la aplicación de escritorio.
UninstallActions	Especifica los archivos del instalador que se ejecutan cuando el usuario desinstala la aplicación de escritorio.

Elementos primarios

Elemento primario	Descripción
desktop6:Extension	Declara un punto de extensibilidad para la aplicación de escritorio.
desktop8:RunAsUser	Indica si la tarea se debe ejecutar como el usuario actual.

Comentarios

Este elemento requiere la funcionalidad restringidacustomInstallActions.

El sistema operativo usa el Name atributo de los elementos desktop6:InstallAction, desktop6:RepairAction y desktop6:UninstallAction para identificar un conjunto relacionado de acciones de instalación, reparación y desinstalación. Para especificar un conjunto relacionado de acciones que se deben ejecutar entre sí, asegúrese de que tienen el mismo valor para el Name atributo . El sistema operativo ejecutará una acción de desinstalación solo si se ha ejecutado la acción de instalación o reparación correspondiente.

Ejemplos

<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

Elemento	Value
Espacio de nombres	http://schemas.microsoft.com/appx/manifest/desktop/windows10/6
Minimum OS Version	Windows 10 versión 1903 (compilación 18362)