Cara Chrome menangani update untuk manifes aplikasi web

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

Adriana Jara
François 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. Namun, 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 satu atau dua hari setelah PWA diluncurkan, setelah manifes diperbarui.

Update di Chrome desktop

Saat PWA diluncurkan, atau dibuka di tab browser, Chrome menentukan waktu terakhir manifes lokal diperiksa untuk mengetahui perubahan. Jika manifes belum diperiksa sejak browser terakhir kali 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, menginstalnya. Setelah diinstal, semua kolom dari manifes baru kecuali icons akan diperbarui.

Properti mana yang akan memicu pembaruan?

  • name
  • short_name
  • 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 ke standalone, pengguna lama tidak akan membuka aplikasi mereka di jendela setelah mengupdate. Ada dua setelan tampilan untuk aplikasi web, yaitu setelan 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 diperbarui, dan lainnya.

Untuk memaksa Chrome memeriksa manifes yang diperbarui secara manual, Anda dapat meluncurkan Chrome dengan flag command line --disable-manifest-update-throttle atau memulai ulang Chrome (gunakan about://restart). Tindakan ini akan mereset timer sehingga Chrome akan memeriksa manifes yang diperbarui saat PWA diluncurkan berikutnya. Kemudian, luncurkan PWA. Setelah ditutup, PWA akan diperbarui dengan properti manifes baru.

Referensi

Update di Chrome untuk Android

Saat PWA diluncurkan, Chrome menentukan kapan terakhir kali manifes lokal diperiksa untuk mengetahui perubahan. 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 akan mengantrekan manifes baru, dan setelah semua jendela PWA ditutup, perangkat dicolokkan, dan terhubung ke Wi-Fi, Chrome akan meminta WebAPK yang telah diperbarui dari server. Setelah diperbarui, semua kolom dari manifes baru akan digunakan.

Properti mana yang akan memicu pembaruan?

  • name
  • short_name
  • icons
  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

Jika Chrome tidak dapat mendapatkan manifes yang diperbarui dari server, Chrome dapat meningkatkan waktu antara pemeriksaan 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 kali diperbarui, seberapa sering diupdate, dan lainnya.

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

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

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

Referensi