DeploymentOptions Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Paketbereitstellungsoptionen an.
Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.
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
- Vererbung
-
DeploymentOptions
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Felder
DevelopmentMode | 2 | Wenn Sie diese Option festlegen, wird die App im Entwicklungsmodus installiert. Informationen zum Entwicklungsmodus finden Sie unter Hinweise. Verwenden Sie diese Option, um wichtige Anwendungsentwicklungsszenarien zu aktivieren. Sie können diese Option nicht in Verbindung mit einem Paketpaket verwenden. Wenn Sie diese Option mit einem Paketpaket verwenden, gibt Ihr Anruf ERROR_INSTALL_FAILED zurück. |
ForceApplicationShutdown | 1 | Wenn dieses Paket oder ein von diesem Paket abhängiges Paket derzeit verwendet wird, werden die dem Paket zugeordneten Prozesse gewaltsam heruntergefahren, sodass die Registrierung fortgesetzt werden kann. |
ForceTargetApplicationShutdown | 64 | Wenn dieses Paket derzeit verwendet wird, werden die dem Paket zugeordneten Prozesse gewaltsam heruntergefahren, sodass die Registrierung fortgesetzt werden kann. |
ForceUpdateFromAnyVersion | 262144 | Erzwingen Sie, dass eine bestimmte Version eines Pakets bereitgestellt/registriert wird, unabhängig davon, ob eine höhere Version bereits bereitgestellt/registriert ist. |
InstallAllResources | 32 | Wenn Sie diese Option festlegen, wird die App angewiesen, Überprüfungen der Ressourcen anwendbar zu überspringen. Dadurch werden effektiv alle Ressourcenpakete, die ein Benutzer an den Befehl übergibt, schrittweise oder registriert, was die Anwendbarkeit für alle pakete erzwingt, die in einem Bündel enthalten sind. Wenn ein Benutzer ein Paket übergibt, werden alle enthaltenen Ressourcenpakete registriert. Nur Windows |
None | 0 | Das Standardverhalten wird verwendet. |
RequiredContentGroupOnly | 256 | Wenn Sie diese Option festlegen, wird nur die erforderliche Inhaltsgruppe inszeniert. Eine App kann als Paket mit der erforderlichen Inhaltsgruppe allein installiert werden. |
RetainFilesOnFailure | 2097152 | Entfernen Sie bei einer fehlgeschlagenen Bereitstellung keine Dateien, die während des Installationsvorgangs auf dem Zielcomputer erstellt wurden. |
StageInPlace | 4194304 | Wenn Sie diese Option festlegen, wird das Paket an Ort und Stelle bereitgestellt. Dieses Feld ist nützlich, um das System zu benachrichtigen, um die App-Registrierung in Virtuellen Desktopszenarien vorzubereiten. |
Hinweise
Sie können die DevelopmentMode-Option verwenden, um Apps zu installieren, ohne ein App-Paket zu benötigen. Stattdessen verarbeitet die Bereitstellungs-Engine die AppxManifest.xml-Datei direkt, was einen schnelleren Entwicklungszyklus ermöglicht. Die dateien BlockMap.xml, [Content_Types].xml und digitale Signatur sind für die App-Installation in DevelopmentMode nicht erforderlich.
Um eine App erfolgreich in DevelopmentMode installieren zu können, muss sie diese zusätzlichen Bedingungen erfüllen, die über die üblicherweise für UWP-Apps hinausgehen:
- Die App muss für das aktuelle Benutzerkonto eindeutig sein. Kein anderer Benutzer kann eine App mit demselben Paketfamiliennamen auf dem Computer installiert haben.
- Wenn eine frühere Version der App installiert wurde, muss die vorherige Version auch in DevelopmentMode installiert werden. UWP-Apps können nicht mit einer DevelopmentMode-App aktualisiert werden und umgekehrt.
- Die App muss sich auf einer NTFS-Partition (Microsoft Windows NT File System) befinden. Partitionen mit anderen Formaten werden nicht unterstützt.
- Die App muss sich auf einem lokalen Laufwerk befinden. Die Installation von Netzwerkstandorten wird nicht unterstützt.
- Die App muss sich an einem unverschlüsselten Speicherort befinden. Die Installation aus verschlüsselten Verzeichnissen wird nicht unterstützt.
- Die App kann nicht über das WindowsApps-Verzeichnis installiert werden. Wenn eine der vorherigen Bedingungen nicht erfüllt ist, schlägt die Installation fehl.
Um die App-Entwicklung zu vereinfachen und zu verbessern, werden außerdem die folgenden wichtigen Betriebssystemverhaltensänderungen vorgenommen, wenn eine App im DevelopmentMode installiert wird:
- App-Nutzlastdateien können geändert werden. Wenn Sie eine App-Nutzlastdatei ändern, werden die Änderungen beim nächsten Start der App berücksichtigt. Sie müssen die App nicht erneut installieren, es sei denn, Sie ändern die AppxManifest.xml-Datei.
- Bytecodegenerierung und NGEN sind deaktiviert. JS-Bytecodegenerierung und binäre .NET-NGEN sind in DevelopmentMode-Paketen deaktiviert, damit Sie Nutzlastdateien ändern können, ohne Ihre App neu zu installieren.
- App-Nutzlastdateien werden nicht entfernt, wenn die App deinstalliert wird. Da diese Dateien möglicherweise Ihr Quellcode sind, löscht Windows diese Dateien nicht, wenn eine App deinstalliert wird.
- Das Netzwerkschleifenback ist zulässig. Sie müssen sich für das Netzwerkschleifenback anmelden, wie unter Aktivieren des Loopbacks und Problembehandlung für die Netzwerkisolation beschrieben.
- Die App kann in DesignMode gestartet werden. Informationen zur DesignMode-Klasse finden Sie unter DesignMode-Klasse.
Versionsverlauf
Windows-Version | SDK-Version | Wertschöpfung |
---|---|---|
1703 | 15063 | RequiredContentGroupOnly |
1809 | 17763 | ForceUpdateFromAnyVersion |
1903 | 18362 | RetainFilesOnFailure |
2004 | 19041 | StageInPlace |