Cara Chrome menangani update untuk manifes aplikasi web

Hal 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 aplikasi web untuk nama aplikasi, ikon yang harus digunakan aplikasi, dan URL yang akan dibuka saat aplikasi diluncurkan. Namun, bagaimana jika Anda perlu mengupdate pintasan aplikasi atau mencoba warna tema baru? Kapan dan bagaimana perubahan tersebut ditampilkan pada browser?

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

Update di Chrome desktop

Saat PWA diluncurkan, atau dibuka di tab browser, Chrome akan menentukan terakhir kali manifes lokal diperiksa untuk mengetahui perubahan. Jika manifes belum telah diperiksa sejak browser terakhir kali dimulai, atau belum melakukan pemeriksaan 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 mengantrekan manifes baru, dan setelah semua jendela ditutup, menginstalnya. Setelah diinstal, semua kolom dari manifes baru (kecuali name, short_name, dan icons) diperbarui.

Properti mana yang akan memicu pembaruan?

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

Apa yang terjadi saat kolom display diperbarui?

Jika Anda memperbarui mode tampilan aplikasi dari browser menjadi standalone aplikasi pengguna yang ada tidak akan terbuka di jendela setelah diupdate. Ada dua pengaturan tampilan untuk aplikasi web, satu dari manifes (yang ) dan setelan jendela/tab browser yang dikontrol oleh pengguna. Pengguna preferensinya selalu dijaga.

Menguji update manifes

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

Untuk memaksa Chrome secara manual memeriksa manifes yang diupdate, 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 diperbarui saat berikutnya PWA diluncurkan. Lalu luncurkan PWA. Setelah ditutup, PWA harus diperbarui dengan manifes baru properti baru.

Referensi

Update di Chrome untuk Android

Saat PWA diluncurkan, Chrome akan menentukan kapan terakhir kali manifes lokal diperiksa apakah ada perubahan. Jika manifes belum diperiksa dalam 24 jam terakhir jam, Chrome akan menjadwalkan permintaan jaringan untuk manifes, lalu membandingkan terhadap salinan lokal.

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

Properti mana yang akan memicu pembaruan?

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

Jika Chrome tidak dapat memperoleh manifes yang diupdate dari server, Chrome mungkin menambah waktu antarpemeriksaan 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 itu terakhir diperbarui, seberapa sering pembaruan diperbarui, dan banyak lagi.

Untuk menjadwalkan update ke manifes secara manual, ganti timer dan manifes lokal 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 memaksa PWA berhenti.
  3. Di Chrome, buka about://webapks dan klik "Perbarui" untuk PWA. "Status Pembaruan" akan berubah menjadi "Tertunda".
  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 memaksa PWA berhenti.

PWA biasanya diupdate dalam beberapa menit, setelah update selesai, "Status Pembaruan" harus diubah menjadi "Berhasil"

Referensi