desktop6:CustomInstall

Articolo
08/17/2024

Consente all'applicazione desktop di specificare uno o più file di installazione aggiuntivi (.exe o .msi) installati con l'applicazione desktop. Ad esempio, questo è utile per le app che raggruppano 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 l'customInstallActionsfunzionalità con restrizioni.

Gerarchia degli elementi

pacchetto

<desktop6:Estensione>

<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	Obbligatorio	Valore predefinito
Cartella	Nome della cartella del pacchetto che contiene tutti i file necessari 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:Estensione	Dichiara un punto di estendibilità per l'applicazione desktop.
desktop8:RunAsUser	Indica se l'attività deve essere eseguita come utente corrente.

Osservazioni

Questo elemento richiede l'customInstallActionsfunzionalità con restrizioni.

Il sistema operativo usa l'attributo Name degli elementi desktop6:InstallAction, desktop6:RepairActione elementi desktop6:UninstallAction per identificare un set correlato di azioni di installazione, ripristino e disinstallazione. Per specificare un set correlato di azioni da eseguire insieme 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.

Esempi

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

Fabbisogno

Articolo	Valore
Namespace	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/6`
versione minima del sistema operativo	Windows 10 versione 1903 (Build 18362)

Condividi tramite