DeploymentOptions Enumerazione

Definizione

Specifica le opzioni di distribuzione del pacchetto.

Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.

public enum class DeploymentOptions
/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class DeploymentOptions
[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum DeploymentOptions
var value = Windows.Management.Deployment.DeploymentOptions.none
Public Enum DeploymentOptions
Ereditarietà
DeploymentOptions
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Campi

DevelopmentMode 2

Quando si imposta questa opzione, l'app viene installata in modalità di sviluppo. Per informazioni sulla modalità di sviluppo, vedi Osservazioni. Usare questa opzione per abilitare gli scenari di sviluppo delle app principali. Non è possibile usare questa opzione insieme a un pacchetto bundle. Se si usa questa opzione con un pacchetto bundle, la chiamata restituisce ERROR_INSTALL_FAILED.

ForceApplicationShutdown 1

Se questo pacchetto, o qualsiasi pacchetto che dipende da questo pacchetto, è attualmente in uso, i processi associati al pacchetto vengono arrestati forzatamente in modo che la registrazione possa continuare.

ForceTargetApplicationShutdown 64

Se questo pacchetto è attualmente in uso, i processi associati al pacchetto vengono arrestati forzatamente in modo che la registrazione possa continuare.

ForceUpdateFromAnyVersion 262144

Forzare la gestione temporanea o la registrazione di una versione specifica di un pacchetto, indipendentemente dal fatto che una versione successiva sia già in fase/registrata.

InstallAllResources 32

Quando si imposta questa opzione, all'app viene richiesto di ignorare i controlli di applicabilità delle risorse. In questo modo si registrano in modo efficace tutti i pacchetti di risorse che un utente passa al comando, forzando l'applicabilità per tutti i pacchetti contenuti in un bundle. Se un utente passa un bundle, verranno registrati tutti i pacchetti di risorse contenuti. Solo Windows.

None 0

Viene usato il comportamento predefinito.

RequiredContentGroupOnly 256

Quando si imposta questa opzione, verrà eseguito il staging solo del gruppo di contenuto richiesto. Un'app può essere installata come pacchetto solo con il gruppo di contenuto richiesto.

RetainFilesOnFailure 2097152

Nel caso di una distribuzione non riuscita, non rimuovere i file creati nel computer di destinazione durante il processo di installazione.

StageInPlace 4194304

Quando si imposta questa opzione, il pacchetto verrà inserito in staging. Questo campo è utile per notificare al sistema di preparare la registrazione dell'app negli scenari di desktop virtuale.

Commenti

È possibile usare l'opzione DevelopmentMode per installare le app senza richiedere un pacchetto dell'app. Al contrario, il motore di distribuzione elabora direttamente il file AppxManifest.xml, che consente un ciclo di sviluppo più rapido. I file BlockMap.xml, [Content_Types].xml e firma digitale non sono necessari per l'installazione dell'app in DevelopmentMode.

Per installare correttamente un'app in DevelopmentMode, deve soddisfare queste condizioni aggiuntive oltre a quanto in genere richiesto per le app UWP:

  • L'app deve essere univoca per l'account utente corrente. Nessun altro utente può avere un'app con lo stesso nome della famiglia di pacchetti installata nel computer.
  • Se è stata installata una versione precedente dell'app, è necessario installare anche la versione precedente in DevelopmentMode. Le app UWP non possono essere aggiornate con un'app DevelopmentMode e viceversa.
  • L'app deve trovarsi in una partizione NTFS (Microsoft Windows NT File System). Le partizioni con altri formati non sono supportate.
  • L'app deve trovarsi in un'unità locale. L'installazione da percorsi di rete non è supportata.
  • L'app deve trovarsi in una posizione non crittografata. L'installazione dalle directory crittografate non è supportata.
  • L'app non può essere installata dalla directory WindowsApps. Se una delle condizioni precedenti non viene soddisfatta, l'installazione non riesce.

Inoltre, per semplificare e migliorare l'esperienza di sviluppo delle app, questi comportamenti chiave del sistema operativo vengono modificati quando un'app viene installata in DevelopmentMode:

  • I file di payload dell'app possono essere modificati. Se modifichi un file di payload dell'app, le modifiche vengono riflesse al successivo avvio dell'app. Non è necessario reinstallare l'app a meno che non si modifichi il file AppxManifest.xml.
  • La generazione di bytecode e NGEN sono disabilitate. La generazione di bytecode JS e .NET binary NGEN sono disabilitate nei pacchetti DevelopmentMode per consentire di modificare i file di payload senza reinstallare l'app.
  • I file di payload dell'app non vengono rimossi quando l'app viene disinstallata. Poiché questi file sono potenzialmente il codice sorgente, Windows non elimina questi file quando un'app viene disinstallata.
  • Il loopback di rete è consentito. È necessario acconsentire esplicitamente al loopback di rete come descritto in Come abilitare il loopback e risolvere i problemi di isolamento di rete.
  • L'app può essere avviata in DesignMode. Per informazioni sulla classe DesignMode, vedi Classe DesignMode.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1703 15063 RequiredContentGroupOnly
1809 17763 ForceUpdateFromAnyVersion
1903 18362 RetainFilesOnFailure
2004 19041 StageInPlace

Si applica a

Vedi anche