OnLaunch

Artikel
02/07/2025

Dit element geeft aan dat de implementatieservice controleert op een update naar het app-installatiebestand wanneer de app wordt gestart.

Elementhiërarchie

<AppInstaller->

<UpdateSettings>: <OnLaunch->

Syntaxis

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

Sleutel

? optioneel (nul of één)

Kenmerken en elementen

Kenmerken

Attribuut	Beschrijving	Gegevenstype	Vereist
s4:HoursBetweenUpdateChecks	HoursBetweenUpdateChecks geeft de frequentie aan waarmee de implementatieservice controleert op een update naar het app-installatiebestand. Wanneer HoursBetweenUpdateChecks is ingesteld op 0, controleert de implementatieservice telkens wanneer de toepassing wordt gestart op updates. Voor andere waarden controleert de implementatieservice alleen op updates wanneer de toepassing wordt gestart als deze niet eerder is gecontroleerd binnen het laatste aantal uren dat is opgegeven door HoursBetweenUpdateChecks. Als HoursBetweenUpdateChecks bijvoorbeeld is ingesteld op 12, controleert de implementatieservice op updates wanneer de toepassing alleen wordt gestart als deze de afgelopen 12 uur nog niet op updates heeft gecontroleerd.	Numerieke waarden tussen 0 en 255 inclusief. De standaardwaarde is 24.	Nee
s4:ShowPrompt	Geeft aan of de implementatie een prompt weergeeft, waarbij de gebruiker wordt geïnformeerd over de update. Zie de opmerkingen voor meer informatie over het gedrag van dit kenmerk. Beschikbaar in Windows 10, versie 1903 en hoger.	Booleaans	Nee
s4:UpdateBlocksActivation	Mag alleen worden gebruikt als ShowPrompt="true". Geeft aan of de implementatie de gebruiker stopt met het starten van de toepassing totdat de update is toegepast. 'UpdateBlocksActivation' = true betekent dat de gebruikersinterface die de gebruiker ziet, de update kan uitvoeren of de app kan sluiten. 'UpdateBlocksActivation' = false betekent dat de gebruikersinterface die de gebruiker ziet, de update kan uitvoeren of de app kan starten zonder bij te werken. In het laatste geval wordt de update op de achtergrond toegepast op een tijdstip. Zie de opmerkingen voor meer informatie over het gedrag van dit kenmerk. Beschikbaar in Windows 10, versie 1903 en hoger.	Booleaans	Nee

Bovenliggende elementen

Bovenliggende elementen	Beschrijving
UpdateSettings-	Een optioneel element van het appinstaller-bestand. UpdateSettings geeft aan of er al dan niet moet worden gecontroleerd op een update tijdens het starten van de app.

Opmerkingen

Als u het kenmerk ShowPrompt="true" instelt, wordt momenteel een prompt weergegeven voor UWP-toepassingen, maar niet voor desktoptoepassingen die zijn verpakt in een Windows-app-pakket (dat wil gezegd bureaubladtoepassingen die gebruikmaken van de Desktop Bridge). Voor desktoptoepassingen biedt deze functionaliteit een stille update; dezelfde standaardfunctionaliteit die wordt geleverd door het Element OnLaunch.

De kenmerken ShowPrompt en UpdateBlocksActivation hebben alleen effect wanneer de gebruiker de app start vanuit een menu-item, een tegel in het menu Start, een app-alias of een protocolhandler. Deze kenmerken hebben geen effect als de gebruiker de app start vanaf een snelkoppeling op het bureaublad of op de taakbalk.

Voorbeelden

In dit voorbeeld wordt elke keer dat de app wordt gestart, gecontroleerd op updates. Als er updates worden gevonden, wordt in de implementatie een prompt weergegeven waarin wordt opgegeven dat de gebruiker de update moet uitvoeren voordat de app wordt gestart. De app-versie kan ook worden verhoogd of afgebroken.

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

Eisen

Eis	Beschrijving
`xmlns=http://schemas.microsoft.com/appx/appinstaller/2017`	Deze naamruimte is vereist voor functies die zijn geïntroduceerd in Windows 10 versie 1709.
`xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021`	Deze naamruimte is vereist voor functies die zijn geïntroduceerd in Windows versie 21H2 build 22000
Minimale versie van het besturingssysteem	Windows 10, versie 1709

Delen via