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?

Biasanya, perubahan akan terlihat dalam satu atau dua hari setelah PWA diluncurkan, setelah manifes diperbarui.

Pembaruan di Chrome desktop

Saat PWA diluncurkan, atau dibuka di tab browser, Chrome akan menentukan terakhir kali manifes lokal diperiksa perubahannya. 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, Chrome akan 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 Perhatian: Perubahan pada start_url memerlukan setelan id manifes. Pelajari lebih lanjut.
  • theme_color
  • file_handlers

Apa yang terjadi saat 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 jendela serta tab 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), mencakup informasi mendetail tentang semua PWA yang diinstal di perangkat, dan dapat membantu Anda memahami kapan terakhir kali manifes diperbarui, seberapa sering manifes 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 diupdate saat PWA diluncurkan berikutnya. Kemudian, luncurkan PWA. Setelah menutup PWA, PWA harus diperbarui dengan properti manifes baru.

Referensi

Update di Chrome untuk Android

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

Properti mana yang 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 diupdate dari server, Chrome dapat meningkatkan waktu antara pemeriksaan menjadi 30 hari.

Menguji update manifes

Halaman about://webapks mencakup informasi mendetail tentang semua PWA yang diinstal di perangkat, dan dapat memberi tahu Anda kapan terakhir kali manifes diperbarui, seberapa sering manifes diperbarui, dan lainnya.

Untuk menjadwalkan update ke manifes secara manual, menggantikan 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. "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