Buat agar mudah diinstal

Pete LePage

Error ini berisi manifes web dengan kolom yang diperlukan untuk membuat Aplikasi Web dapat diinstal.

Halaman ini juga memiliki tombol instal yang disembunyikan secara default.

Memproses peristiwa beforeinstallprompt

Saat browser memicu peristiwa beforeinstallprompt, hal ini menunjukkan bahwa Aplikasi Web dapat diinstal dan tombol instal dapat ditampilkan kepada pengguna. Peristiwa beforeinstallprompt diaktifkan saat aplikasi memenuhi kriteria kemampuan penginstalan.

Dengan merekam peristiwa, developer dapat menyesuaikan penginstalan dan meminta pengguna untuk menginstal saat mereka menganggapnya sebagai waktu terbaik.

  1. Klik Remix to Edit agar project dapat diedit.
  2. Tambahkan pengendali peristiwa beforeinstallprompt ke objek window.
  3. Simpan event sebagai variabel global; kita akan membutuhkannya nanti untuk menampilkan perintah.
  4. Tampilkan tombol instal.

Kode:

window.addEventListener('beforeinstallprompt', (event) => {
  // Prevent the mini-infobar from appearing on mobile.
  event.preventDefault();
  console.log('👍', 'beforeinstallprompt', event);
  // Stash the event so it can be triggered later.
  window.deferredPrompt = event;
  // Remove the 'hidden' class from the install button container.
  divInstall.classList.toggle('hidden', false);
});

Menangani klik tombol instal

Untuk menampilkan perintah penginstalan, panggil prompt() pada peristiwa beforeinstallprompt yang disimpan. Memanggil prompt() dilakukan di pengendali klik tombol instal karena prompt() harus dipanggil dari gestur pengguna.

  1. Menambahkan pengendali peristiwa klik untuk tombol instal.
  2. Panggil prompt() pada peristiwa beforeinstallprompt yang disimpan.
  3. Catat hasil perintah.
  4. Tetapkan peristiwa beforeinstallprompt yang disimpan ke null.
  5. Sembunyikan tombol instal.

Kode:

butInstall.addEventListener('click', async () => {
  console.log('👍', 'butInstall-clicked');
  const promptEvent = window.deferredPrompt;
  if (!promptEvent) {
    // The deferred prompt isn't available.
    return;
  }
  // Show the install prompt.
  promptEvent.prompt();
  // Log the result
  const result = await promptEvent.userChoice;
  console.log('👍', 'userChoice', result);
  // Reset the deferred prompt variable, since
  // prompt() can only be called once.
  window.deferredPrompt = null;
  // Hide the install button.
  divInstall.classList.toggle('hidden', true);
});

Melacak peristiwa penginstalan

Menginstal Aplikasi Web melalui tombol instal hanyalah salah satu cara pengguna dapat menginstalnya. Mereka juga dapat menggunakan menu Chrome, mini-infobar, dan melalui ikon di omnibox. Anda dapat melacak semua cara penginstalan ini dengan memproses peristiwa appinstalled.

  1. Tambahkan pengendali peristiwa appinstalled ke objek window.
  2. Catat peristiwa penginstalan ke analisis atau mekanisme lainnya.

Kode:

window.addEventListener('appinstalled', (event) => {
  console.log('👍', 'appinstalled', event);
  // Clear the deferredPrompt so it can be garbage collected
  window.deferredPrompt = null;
});

Bacaan lebih lanjut

Selamat, aplikasi Anda sekarang dapat diinstal.

Berikut beberapa hal tambahan yang dapat Anda lakukan: