OnLaunch

Questo elemento indica che il servizio di distribuzione verificherà la presenza di un aggiornamento al file del programma di installazione app all'avvio dell'app.

Gerarchia degli elementi

<AppInstaller>

<UpdateSettings>

<OnLaunch>

Sintassi

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

Chiave

? facoltativo (zero o uno)

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatorio
s4:HoursBetweenUpdateChecks	HoursBetweenUpdateChecks specifica la frequenza con cui il servizio di distribuzione verificherà la presenza di un aggiornamento al file del programma di installazione app. Quando HoursBetweenUpdateChecks è impostato su 0, il servizio di distribuzione verificherà la disponibilità di aggiornamenti ogni volta che viene avviata l'applicazione. Per altri valori, il servizio di distribuzione verificherà la disponibilità di aggiornamenti quando l'applicazione viene avviata solo se non è stata verificata in precedenza entro l'ultimo numero di ore specificato da HoursBetweenUpdateChecks. Ad esempio, se HoursBetweenUpdateChecks è impostato su 12, il servizio distribuzioni verificherà la disponibilità di aggiornamenti quando l'applicazione viene avviata solo se non è già stata verificata la disponibilità di aggiornamenti nelle 12 ore precedenti.	Valori numerici compresi tra 0 e 255 inclusi. Il valore predefinito è 24.	No
s4:ShowPrompt	Indica se la distribuzione visualizzerà una richiesta, informando l'utente sull'aggiornamento. Per altre informazioni sul comportamento di questo attributo, vedere le osservazioni. Disponibile in Windows 10 versione 1903 e successive.	Booleano	No
s4:UpdateBlocksActivation	Deve essere usato solo se ShowPrompt="true". Indica se la distribuzione arresta l'avvio dell'applicazione da parte dell'utente fino a quando non viene applicato l'aggiornamento. "UpdateBlocksActivation" = true indica che l'interfaccia utente che l'utente visualizzerà consente all'utente di eseguire l'aggiornamento o chiudere l'app. "UpdateBlocksActivation" = false indica che l'interfaccia utente che l'utente vedrà consente all'utente di eseguire l'aggiornamento o avviare l'app senza aggiornare. In quest'ultimo caso, l'aggiornamento verrà applicato automaticamente in un momento appropriato. Per altre informazioni sul comportamento di questo attributo, vedere le osservazioni. Disponibile in Windows 10 versione 1903 e successive.	Booleano	No

Elementi padre

Elementi padre	Descrizione
UpdateSettings	Elemento facoltativo del file appinstaller. UpdateSettings indica se verificare o meno la disponibilità di un aggiornamento durante l'avvio dell'app.

Osservazioni

L'impostazione dell'attributo ShowPrompt="true" mostra attualmente una richiesta per le applicazioni UWP, ma non per le applicazioni desktop incluse in un pacchetto di app di Windows (ovvero le applicazioni desktop che usano Desktop Bridge). Per le applicazioni desktop, questa funzionalità fornisce un aggiornamento invisibile all'utente; la stessa funzionalità predefinita fornita dall'elemento OnLaunch.

Gli attributi ShowPrompt e UpdateBlocksActivation hanno effetto solo quando l'utente avvia l'app da una voce di menu, un riquadro nel menu Start, un alias dell'app o un gestore del protocollo. Questi attributi non hanno alcun effetto se l'utente avvia l'app da un collegamento desktop o dalla barra delle applicazioni.

Esempi

In questo esempio, la distribuzione verificherà la disponibilità di aggiornamenti ogni volta che viene avviata l'app. Se vengono trovati aggiornamenti, la distribuzione visualizzerà un prompt che informa l'utente che deve eseguire l'aggiornamento prima di avviare l'app. Anche la versione dell'app può essere incrementata o decrementata.

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

Fabbisogno

Requisito	Descrizione
xmlns=http://schemas.microsoft.com/appx/appinstaller/2017	Questo spazio dei nomi è obbligatorio per le funzionalità introdotte in Windows 10 versione 1709.
xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021	Questo spazio dei nomi è obbligatorio per le funzionalità introdotte in Windows versione 21H2 build 22000
Versione minima del sistema operativo	Windows 10, versione 1709