s4:OnLaunch

Artikel
05/07/2024

BESCHREIBUNG

Gibt an, ob der Bereitstellungsdienst beim Starten der App auf ein Update der App-Installer-Datei überprüft. (s4:OnLaunch)

Elementhierarchie

s4:AppInstaller

s4:UpdateSettings;

<s4:OnLaunch>

Syntax

<s4:OnLaunch     ShowPrompt? = Boolean.
    UpdateBlocksActivation? = Boolean.
    HoursBetweenUpdateChecks? = Unsigned byte.
></s4:OnLaunch>

Schlüssel

? optional (null oder 1)

Attribute

attribute	BESCHREIBUNG	Datentyp	Erforderlich
ShowPrompt	Gibt an, ob bei der Bereitstellung eine Eingabeaufforderung angezeigt wird, die den Benutzer über das Update informiert. Weitere Informationen zum Verhalten dieses Attributs finden Sie in den Anmerkungen. Verfügbar in Windows 10, Version 1903 und höher.	Boolesch.	No
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 dem Benutzer angezeigte Benutzeroberfläche es dem Benutzer ermöglicht, das Update zu übernehmen oder die App zu schließen. "UpdateBlocksActivation" = false bedeutet, dass die dem Benutzer angezeigte Benutzeroberfläche es dem Benutzer ermöglicht, das Update durchzuführen oder die App ohne Aktualisierung zu starten. Im letzteren Fall wird das Update automatisch zu einem günstigen Zeitpunkt angewendet. Weitere Informationen zum Verhalten dieses Attributs finden Sie in den Anmerkungen. Verfügbar in Windows 10, Version 1903 und höher.	Boolesch.	No
StundenBetweenUpdateChecks	Gibt die Häufigkeit an, mit der der Bereitstellungsdienst nach einem Update der App Installer-Datei sucht. Wenn HoursBetweenUpdateChecks auf 0 festgelegt ist, sucht der Bereitstellungsdienst jedes Mal nach Updates, wenn die Anwendung gestartet wird. Bei anderen Werten sucht der Bereitstellungsdienst nur dann nach Updates, wenn die Anwendung gestartet wird, wenn sie nicht zuvor innerhalb der letzten von HoursBetweenUpdateChecks angegebenen Anzahl von Stunden überprüft wurde. Wenn z. B. HoursBetweenUpdateChecks auf 12 festgelegt ist, sucht der Bereitstellungsdienst nur dann nach Updates, wenn die Anwendung gestartet wird, wenn sie in den vorherigen 12 Stunden noch nicht auf Updates überprüft wurde.	Numerische Werte zwischen 0 und einschließlich 255. Der Standardwert ist 24.	No

Übergeordnete Elemente

Übergeordnete Elemente	BESCHREIBUNG
s4:UpdateSettings	Gibt Einstellungen im Zusammenhang mit App-Updates an.

Hinweise

Das Festlegen des ShowPrompt="true" Attributs zeigt derzeit eine Eingabeaufforderung für UWP-Anwendungen, aber nicht für Desktopanwendungen, die in einem Windows-App-Paket gepackt wurden (d. a. Desktopanwendungen, die die Desktop-Brücke verwenden). Für Desktopanwendungen bietet diese Funktion ein unbeaufsichtigtes Update. dieselbe Standardfunktionalität, die vom OnLaunch-Element bereitgestellt wird.

Die ShowPrompt Attribute und UpdateBlocksActivation haben nur Auswirkungen, wenn der Benutzer die App über ein Menüelement oder eine Kachel im Startmenü 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 jedes Mal nach Updates, wenn die App gestartet wird. Wenn Updates gefunden werden, zeigt die Bereitstellung eine Eingabeaufforderung an, die dem Benutzer mitteilt, dass er das Update vor dem Starten der App ausführen muss. Auch die App-Version kann inkrementiert oder verringert werden.

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

Anforderungen

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

Freigeben über