s4:OnLaunch

Artikel
05/07/2024

Deskripsi

Menentukan apakah layanan penyebaran akan memeriksa pembaruan ke file Penginstal Aplikasi pada peluncuran aplikasi. (s4:OnLaunch)

Hierarki Elemen

s4:AppInstaller

s4:UpdateSettings;

<s4:OnLaunch>

Sintaks

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

Kunci

? opsional (nol atau satu)

Atribut

Atribut	Deskripsi	Jenis Data	Diperlukan
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
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

Elemen Induk

Elemen Induk	Deskripsi
s4:UpdateSettings	Menentukan pengaturan yang terkait dengan pembaruan aplikasi.

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, fungsi 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.

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

Persyaratan

Persyaratan	Nilai
`xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021`	Namespace ini diperlukan untuk fitur yang diperkenalkan di Windows versi 21H2 build 22000
Versi OS minimum	Windows versi 21H2 build 22000

Bagikan melalui