OnLaunch

Artikel
07/20/2023

Elemen ini menandakan bahwa layanan penyebaran akan memeriksa pembaruan ke file Penginstal Aplikasi saat aplikasi diluncurkan.

Hierarki elemen

<AppInstaller>

<UpdateSettings>: <OnLaunch>

Sintaks

<OnLaunch HoursBetweenUpdateChecks? = String with numeric values between 0 and 255 inclusive. />

Kunci

? opsional (nol atau satu)

Atribut dan Elemen

Atribut

Atribut	Deskripsi	Jenis Data	Diperlukan
HoursBetweenUpdateChecks	HoursBetweenUpdateChecks menentukan frekuensi di mana layanan penyebaran akan memeriksa pembaruan ke file Penginstal Aplikasi. Ketika HoursBetweenUpdateChecks diatur ke 0, layanan penyebaran akan memeriksa pembaruan setiap kali aplikasi diluncurkan. Untuk nilai lain, layanan penyebaran akan memeriksa pembaruan ketika aplikasi diluncurkan hanya jika sebelumnya belum diperiksa dalam jumlah jam terakhir yang ditentukan oleh HoursBetweenUpdateChecks. Misalnya, jika HoursBetweenUpdateChecks diatur ke 12, layanan penyebaran akan memeriksa pembaruan ketika aplikasi diluncurkan hanya jika belum memeriksa pembaruan dalam 12 jam sebelumnya.	Nilai numerik antara 0 dan 255 inklusif. Defaultnya adalah 24.	Tidak
ShowPrompt	Menunjukkan apakah penyebaran akan menampilkan perintah, memberi tahu pengguna tentang pembaruan. Untuk informasi selengkapnya tentang perilaku atribut ini, lihat keterangan. Tersedia di Windows 10, versi 1903 dan yang lebih baru.	Boolean	Tidak
UpdateBlocksActivation	Hanya boleh digunakan jika ShowPrompt="true". Menunjukkan apakah penyebaran akan menghentikan pengguna meluncurkan aplikasi hingga pembaruan diterapkan. "UpdateBlocksActivation" = true berarti UI yang akan dilihat pengguna memungkinkan pengguna untuk melakukan pembaruan atau menutup aplikasi. "UpdateBlocksActivation" = false berarti UI yang akan dilihat pengguna memungkinkan pengguna untuk melakukan pembaruan atau memulai aplikasi tanpa memperbarui. Dalam kasus terakhir, pembaruan akan diterapkan secara diam-diam pada waktu yang tepat. Untuk informasi selengkapnya tentang perilaku atribut ini, lihat keterangan. Tersedia di Windows 10, versi 1903 dan yang lebih baru.	Boolean	Tidak

Elemen Induk

Elemen Induk	Deskripsi
UpdateSettings	Elemen opsional dari file appinstaller. UpdateSettings menandakan apakah akan memeriksa pembaruan selama peluncuran aplikasi atau tidak.

Keterangan

ShowPrompt="true" Mengatur atribut saat ini menunjukkan permintaan untuk aplikasi UWP tetapi tidak untuk aplikasi desktop yang telah dipaketkan dalam paket aplikasi Windows (yaitu, aplikasi desktop yang menggunakan Desktop Bridge). Untuk aplikasi desktop, fungsionalitas ini menyediakan pembaruan senyap; fungsionalitas default yang sama yang disediakan oleh elemen OnLaunch.

Atribut ShowPrompt dan UpdateBlocksActivation hanya berpengaruh saat pengguna memulai aplikasi dari item menu atau petak peta di menu Mulai. Atribut ini tidak berpengaruh jika pengguna memulai aplikasi dari pintasan desktop atau dari Taskbar.

Contoh

Dalam contoh ini, penyebaran akan memeriksa pembaruan setiap kali aplikasi diluncurkan. Jika pembaruan ditemukan, penyebaran akan menampilkan perintah yang memberi tahu pengguna bahwa mereka harus melakukan pembaruan sebelum meluncurkan aplikasi. Juga versi aplikasi dapat ditambahkan atau direkrementasi.

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

Persyaratan untuk HoursBetweenUpdateChecks

	Nilai
Ruang nama	`http://schemas.microsoft.com/appx/appinstaller/2017/2`

Persyaratan untuk ShowPrompt dan UpdateBlocksActivation

	Nilai
Ruang nama	`http://schemas.microsoft.com/appx/appinstaller/2018`