OnLaunch

Artikel
02/07/2025

Dieses Element gibt an, dass der Bereitstellungsdienst beim Starten der App auf eine Aktualisierung der App-Installer-Datei überprüft.

Elementhierarchie

<AppInstaller->

<UpdateSettings>: <OnLaunch->

Syntax

<OnLaunch s4:HoursBetweenUpdateChecks? = String with numeric values between 0 and 255 inclusive.
    s4:ShowPrompt? = Boolean
    s4:UpdateBlocksActivation? = Boolean />

Schlüssel

? optional (null oder eins)

Attribute und Elemente

Attribute

Attribut	Beschreibung	Datentyp	Erforderlich
s4:HoursBetweenUpdateChecks	HoursBetweenUpdateChecks gibt die Häufigkeit an, mit der der Bereitstellungsdienst auf ein Update der App-Installer-Datei überprüft. Wenn HoursBetweenUpdateChecks auf 0 festgelegt ist, sucht der Bereitstellungsdienst bei jedem Start der Anwendung nach Updates. Bei anderen Werten sucht der Bereitstellungsdienst nach Updates, wenn die Anwendung nur gestartet wird, wenn sie nicht innerhalb der letzten Von HoursBetweenUpdateChecks angegebenen Anzahl von Stunden überprüft wurde. Wenn "HoursBetweenUpdateChecks" beispielsweise auf 12 festgelegt ist, sucht der Bereitstellungsdienst nach Updates, wenn die Anwendung nur gestartet wird, wenn sie in den vorherigen 12 Stunden noch nicht auf Updates überprüft wurde.	Numerische Werte zwischen 0 und 255 (einschließlich). Der Standardwert ist 24.	Nein
s4:ShowPrompt	Gibt an, ob die Bereitstellung eine Eingabeaufforderung anzeigt und den Benutzer über das Update informiert. Weitere Informationen zum Verhalten dieses Attributs finden Sie in den Hinweisen. Verfügbar in Windows 10, Version 1903 und höher.	Boolesch	Nein
s4:UpdateBlocksActivation	Sollte nur verwendet werden, wenn ShowPrompt="true". Gibt an, ob die Bereitstellung verhindert, dass der Benutzer die Anwendung startet, bis das Update angewendet wurde. "UpdateBlocksActivation" = true bedeutet, dass die Benutzeroberfläche, die der Benutzer sehen wird, dem Benutzer die Möglichkeit gibt, das Update zu übernehmen oder die App zu schließen. "UpdateBlocksActivation" = "false" bedeutet, dass die Benutzeroberfläche, die der Benutzer sehen kann, das Update ausführen oder die App ohne Aktualisierung starten kann. Im letzteren Fall wird das Update automatisch zu einem opportune-Zeitpunkt angewendet. Weitere Informationen zum Verhalten dieses Attributs finden Sie in den Hinweisen. Verfügbar in Windows 10, Version 1903 und höher.	Boolesch	Nein

Übergeordnete Elemente

Übergeordnete Elemente	Beschreibung
UpdateSettings-	Ein optionales Element der Appinstaller-Datei. UpdateSettings gibt an, ob während des App-Starts nach einem Update gesucht werden soll.

Bemerkungen

Das Festlegen des attributs ShowPrompt="true" zeigt derzeit eine Eingabeaufforderung für UWP-Anwendungen, jedoch nicht für Desktopanwendungen an, die in einem Windows-App-Paket verpackt wurden (d. d. b. Desktopanwendungen, die die Desktop-Brücke verwenden). Für Desktopanwendungen bietet diese Funktion ein automatisches Update; die gleiche Standardfunktionalität, die vom OnLaunch-Element bereitgestellt wird.

Die attribute ShowPrompt und UpdateBlocksActivation wirken sich nur aus, wenn der Benutzer die App über ein Menüelement, eine Kachel im Startmenü, einen App-Alias oder einen Protokollhandler startet. Diese Attribute haben keine Auswirkungen, wenn der Benutzer die App über eine Desktopverknüpfung oder über die Taskleiste startet.

Beispiele

In diesem Beispiel sucht die Bereitstellung bei jedem Start der App nach Updates. Wenn Updates gefunden werden, zeigt die Bereitstellung eine Eingabeaufforderung an, die dem Benutzer mitteilt, dass er das Update vor dem Starten der App übernehmen muss. Außerdem kann die App-Version erhöht oder verringert werden.

<UpdateSettings> 
    <OnLaunch s4:HoursBetweenUpdateChecks="0" s4:ShowPrompt="true" s4:UpdateBlocksActivation="true"/>
    <s4:ForceUpdateFromAnyVersion>true</s4:ForceUpdateFromAnyVersion>
</UpdateSettings>

Anforderungen

Anforderung	Beschreibung
`xmlns=http://schemas.microsoft.com/appx/appinstaller/2017`	Dieser Namespace ist für Features erforderlich, die in Windows 10, Version 1709, eingeführt wurden.
`xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021`	Dieser Namespace ist für Features erforderlich, die in Windows Version 21H2 Build 22000 eingeführt wurden.
Mindestversion des Betriebssystems	Windows 10, Version 1709

Freigeben über