Condividi tramite


OnLaunch

Questo elemento indica che il servizio di distribuzione verificherà la presenza di un aggiornamento al file del programma di installazione app quando l'app viene avviata.

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 Richiesto
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 presenza di aggiornamenti ogni volta che l'applicazione viene avviata. Per altri valori, il servizio di distribuzione verificherà gli aggiornamenti quando l'applicazione viene avviata solo se non è stata verificata in precedenza entro l'ultimo numero di ore specificate da HoursBetweenUpdateChecks. Ad esempio, se HoursBetweenUpdateChecks è impostato su 12, il servizio distribuzioni verificherà la presenza di aggiornamenti quando l'applicazione viene avviata solo se non è già stata verificata la presenza di aggiornamenti nelle 12 ore precedenti. Valori numerici compresi tra 0 e 255. Il valore predefinito è 24. No
s4:ShowPrompt Indica se la distribuzione visualizzerà un prompt, informando l'utente sull'aggiornamento. Per altre informazioni sul comportamento di questo attributo, vedere le osservazioni. Disponibile in Windows 10 versione 1903 e versioni successive. Boolean No
s4:UpdateBlocksActivation Deve essere usato solo se ShowPrompt="true". Indica se la distribuzione arresterà l'avvio dell'applicazione fino a quando non è stato applicato l'aggiornamento. "UpdateBlocksActivation" = true indica che l'interfaccia utente visualizzerà consente all'utente di eseguire l'aggiornamento o chiudere l'app. "UpdateBlocksActivation" = false indica che l'interfaccia utente visualizzerà consente all'utente di eseguire l'aggiornamento o avviare l'app senza aggiornare. In quest'ultimo caso, l'aggiornamento verrà applicato in modo silenzioso in un momento appropriato. Per altre informazioni sul comportamento di questo attributo, vedere le osservazioni. Disponibile in Windows 10 versione 1903 e versioni successive. Boolean No

Elementi padre

Elementi padre Descrizione
UpdateSettings Elemento facoltativo del file appinstaller. UpdateSettings indica se verificare se un aggiornamento durante l'avvio dell'app.

Commenti

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

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

Esempio

In questo esempio, la distribuzione verificherà la presenza di aggiornamenti ogni volta che viene avviata l'app. Se vengono trovati aggiornamenti, la distribuzione mostrerà un prompt che indica all'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>

Requisiti

Requisito Descrizione
xmlns=http://schemas.microsoft.com/appx/appinstaller/2017 Questo spazio dei nomi è necessario 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