Compartir a través de

desktop6:CustomInstall

  • Artículo

Permite que la aplicación de escritorio especifique 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á diseñado para ser utilizado solo por determinados tipos de juegos de pc de escritorio publicados por Microsoft y nuestros asociados. Requiere funcionalidad restringida customInstallActions.

Jerarquía de elementos

del paquete de

     <extensiones>

          <escritorio6:extensión>

               <desktop6:CustomInstall>

Sintaxis

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

Llave

? opcional (cero o uno)

Atributos y elementos

Atributos

Atributo Descripción Tipo de dato Obligatorio Valor predeterminado
carpeta de 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 de entre 1 y 256 caracteres que no pueden 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 de 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 de Especifica los archivos del instalador que se ejecutan cuando el usuario desinstala la aplicación de escritorio.

Elementos primarios

Elemento primario Descripción
escritorio6:extensión Declara un punto de extensibilidad para la aplicación de escritorio.
desktop8:RunAsUser Indica si la tarea debe ejecutarse como el usuario actual.

Observaciones

Este elemento requiere la funcionalidad customInstallActionsrestringida.

El sistema operativo usa el atributo Name del desktop6:InstallAction, desktop6:RepairActiony elementos 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 atributo Name. 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

Artículo Valor
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/6
versión mínima del sistema operativo Windows 10 versión 1903 (compilación 18362)