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. Tetapi bagaimana jika Anda perlu memperbarui pintasan {i>app<i} atau mencoba warna tema yang baru? Kapan dan bagaimana perubahan tersebut ditampilkan pada 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 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 saat kolom display diperbarui?

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

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 diupdate secara manual, Anda dapat meluncurkan Chrome dengan tanda command line --disable-manifest-update-throttle atau memulai ulang Chrome (gunakan about://restart). Tindakan ini akan mereset timer sehingga Chrome akan memeriksa manifes yang telah diupdate saat berikutnya PWA diluncurkan. Kemudian, luncurkan PWA. Setelah ditutup, PWA harus 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 diupdate 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 tidak dapat memperoleh manifes yang diupdate dari server, Chrome dapat menambah waktu antar-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, lakukan 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, lalu klik tombol "Update" untuk PWA. "Status Pembaruan" akan berubah menjadi "Menunggu keputusan".
  4. Luncurkan PWA, dan pastikan itu 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