desktop6:CustomInstall

  • Articolo

Consente all'applicazione desktop di specificare uno o più file di installazione aggiuntivi (.exe o .msi) installati con l'applicazione desktop. Ad esempio, ciò è utile per le app che aggregano un componente ridistribuibile di terze parti.

Nota

Questo elemento è attualmente destinato a essere utilizzato solo da determinati tipi di giochi per PC desktop pubblicati da Microsoft e dai nostri partner. Richiede la funzionalità con restrizionicustomInstallActions.

Gerarchia degli elementi

<Pacchetto>

    <Estensioni>

         <desktop6:Extension>

              <desktop6:CustomInstall>

Sintassi

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

Chiave

? facoltativo (zero o uno)

Attributi ed elementi

Attributi

Attributo Descrizione Tipo di dati Obbligatoria Valore predefinito
Cartella Il nome della cartella del pacchetto che contiene tutti i file richiede per tutte le azioni personalizzate. Questa cartella può contenere sottocartelle. Stringa con un valore compreso tra 1 e 256 caratteri che non può contenere questi caratteri: <, >, :, "|, ?, o *. Sì

Elementi figlio

Elemento figlio Descrizione
InstallActions Specifica i file del programma di installazione eseguiti prima del primo avvio dell'applicazione desktop.
RepairActions Specifica i file del programma di installazione eseguiti quando l'utente seleziona le opzioni di ripristino o reimpostazione nella pagina Impostazioni per l'applicazione desktop.
UninstallActions Specifica i file del programma di installazione eseguiti quando l'utente disinstalla l'applicazione desktop.

Elementi padre

Elemento padre Descrizione
desktop6:Extension Dichiara un punto di estendibilità per l'applicazione desktop.
desktop8:RunAsUser Indica se l'attività deve essere eseguita come utente corrente.

Commenti

Questo elemento richiede la funzionalità con restrizionicustomInstallActions.

Il sistema operativo usa l'attributo Name degli elementi desktop6:InstallAction, desktop6:RepairAction e desktop6:UninstallAction per identificare un set correlato di azioni di installazione, ripristino e disinstallazione. Per specificare un set correlato di azioni che devono essere eseguite in combinazione tra loro, assicurarsi che abbiano lo stesso valore per l'attributo Name . Il sistema operativo eseguirà un'azione di disinstallazione solo se è stata eseguita l'azione di installazione o ripristino corrispondente.

Esempio

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

Requisiti

Elemento valore
Spazio dei nomi http://schemas.microsoft.com/appx/manifest/desktop/windows10/6
Minimum OS Version Windows 10 versione 1903 (Build 18362)