Cara Chrome menangani update untuk manifes aplikasi web

Yang diperlukan untuk mengubah ikon, pintasan, warna, dan metadata lainnya untuk PWA Anda

Adriana Gunawan
Prancis Beaufort
François Beaufort
GitHub
Pete LePage

Saat PWA diinstal, browser menggunakan informasi dari manifes aplikasi web untuk nama aplikasi, ikon yang harus digunakan aplikasi, dan URL yang harus dibuka saat aplikasi diluncurkan. Tetapi bagaimana jika Anda perlu memperbarui pintasan aplikasi atau mencoba warna tema baru? Kapan dan bagaimana perubahan tersebut ditampilkan di browser?

Pada umumnya, perubahan akan terlihat dalam waktu satu atau dua hari setelah PWA diluncurkan, setelah manifes diperbarui.

Update di Chrome desktop

Saat PWA diluncurkan, atau dibuka di tab browser, Chrome akan menentukan kapan terakhir kali manifes lokal diperiksa perubahannya. Jika manifes belum diperiksa sejak browser terakhir dimulai, atau belum diperiksa dalam 24 jam terakhir, Chrome akan membuat permintaan jaringan untuk manifes, lalu membandingkannya dengan salinan lokal.

Jika properti tertentu dalam manifes telah berubah (lihat daftar di bawah), Chrome akan mengantrekan manifes baru, dan setelah semua jendela ditutup, akan menginstalnya. Setelah diinstal, semua kolom dari manifes baru (kecuali name, short_name, dan icons) akan diupdate.

Properti mana yang akan memicu pembaruan?

  • display (lihat di bawah)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

Apa yang terjadi jika kolom display diperbarui?

Jika Anda mengupdate mode tampilan aplikasi dari browser menjadi standalone, aplikasi yang ada tidak akan terbuka di jendela setelah update dilakukan. Ada dua setelan tampilan untuk aplikasi web, satu dari manifes (yang Anda kontrol) dan setelan tab jendela/browser yang dikontrol oleh pengguna. Preferensi pengguna selalu dihormati.

Menguji update manifes

Halaman chrome://web-app-internals (tersedia di Chrome 85 atau yang lebih baru), menyertakan informasi mendetail tentang semua PWA yang diinstal di perangkat, dan dapat membantu Anda memahami kapan manifes terakhir diperbarui, seberapa sering diupdate, dan lainnya.

Untuk memaksa Chrome memeriksa manifes yang diperbarui secara manual, Anda dapat meluncurkan Chrome dengan tanda command line --disable-manifest-update-throttle atau memulai ulang Chrome (menggunakan about://restart), tindakan ini akan menyetel ulang timer sehingga Chrome akan memeriksa manifes yang telah diperbarui saat PWA berikutnya diluncurkan. Kemudian luncurkan {i>PWA<i}. Setelah ditutup, PWA harus diupdate dengan properti manifes yang baru.

Referensi

Update pada Chrome untuk Android

Saat PWA diluncurkan, Chrome menentukan kapan terakhir kali manifes lokal diperiksa perubahannya. Jika manifes belum diperiksa dalam 24 jam terakhir, Chrome akan menjadwalkan permintaan jaringan untuk manifes, lalu membandingkannya dengan salinan lokal.

Jika properti tertentu dalam manifes telah berubah (lihat daftar di bawah), Chrome mengantrekan manifes baru, dan setelah semua jendela PWA ditutup, perangkat dicolokkan, dan terhubung ke Wi-Fi, Chrome akan meminta WebAPK yang diperbarui dari server. Setelah diupdate, semua kolom dari manifes baru akan digunakan.

Properti mana yang akan memicu pembaruan?

  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

Jika Chrome tidak bisa mendapatkan manifes yang diupdate dari server, waktu antar-pemeriksaan dapat ditambah menjadi 30 hari.

Menguji update manifes

Halaman about://webapks menyertakan informasi mendetail tentang semua PWA yang diinstal di perangkat, dan dapat memberi tahu Anda kapan manifes terakhir diupdate, seberapa sering manifes diperbarui, dan banyak lagi.

Untuk menjadwalkan update ke manifes secara manual, ganti timer dan manifes lokal, lakukan hal berikut:

  1. Colokkan perangkat dan pastikan perangkat terhubung ke Wi-Fi.
  2. Gunakan pengelola tugas Android untuk menonaktifkan PWA, lalu gunakan panel Aplikasi di setelan Android untuk memaksa PWA berhenti.
  3. Di Chrome, buka about://webapks lalu klik tombol "Update" untuk PWA. "Status Pembaruan" akan berubah menjadi "Tertunda".
  4. Luncurkan PWA, dan pastikan PWA dimuat dengan benar.
  5. Gunakan pengelola tugas Android untuk menonaktifkan PWA, lalu gunakan panel Aplikasi di setelan Android untuk memaksa PWA berhenti.

PWA biasanya diupdate dalam beberapa menit. Setelah update selesai, "Status Update" akan berubah menjadi "Berhasil"

Referensi