Chrome, web uygulaması manifest dosyasında yapılan güncellemeleri nasıl işler?

PWA'nız için simgeleri, kısayolları, renkleri ve diğer meta verileri değiştirmek için gerekenler

Adriana Jara
François Beaufort
François Beaufort
GitHub
Pete LePage

Bir PWA yüklendiğinde tarayıcı, uygulama adı, uygulamanın kullanması gereken simgeler ve uygulama başlatıldığında açılması gereken URL için web uygulaması manifestindeki bilgileri kullanır. Peki uygulama kısayollarını güncellemeniz veya yeni bir tema rengi denemeniz gerekirse ne olur? Bu değişiklikler tarayıcıya ne zaman ve nasıl yansıtılır?

Çoğu durumda değişiklikler, manifest güncellendikten sonra, kullanıma sunulan PWA'nın bir veya iki gün içinde yansıtılmalıdır.

Masaüstü Chrome'daki güncellemeler

PWA başlatıldığında veya bir tarayıcı sekmesinde açıldığında Chrome, yerel manifestteki değişikliklerin en son ne zaman kontrol edildiğini belirler. Manifest, tarayıcının son başlatılmasından bu yana kontrol edilmemişse veya son 24 saat içinde kontrol edilmemişse Chrome, manifest için bir ağ isteğinde bulunur ve ardından yerel kopyayla karşılaştırır.

Manifest dosyasındaki belirli özellikler değiştiyse (aşağıdaki listeye bakın) Chrome, yeni manifesti sıraya alır ve tüm pencereler kapatıldıktan sonra yükler. Yüklendikten sonra yeni manifestteki tüm alanlar (name, short_name ve icons hariç) güncellenir.

Hangi mülkler güncelleme tetikler?

  • display (aşağıya bakın)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

display alanı güncellendiğinde ne olur?

Uygulamanızın browser olan görüntüleme modunu standalone olarak güncellerseniz mevcut kullanıcılarınız güncellemeden sonra uygulamaları pencerede açılmaz. Bir web uygulaması için iki görüntüleme ayarı bulunur: biri manifest dosyasından (kontrolünüzdeki) biri, diğeri kullanıcı tarafından kontrol edilen pencere/tarayıcı sekmesi ayarıdır. Kullanıcının tercihi her zaman dikkate alınır.

Manifest güncellemelerini test etme

chrome://web-app-internals sayfası (Chrome 85 veya sonraki sürümlerde kullanıma sunulmuştur), cihazda yüklü tüm PWA'lar hakkında ayrıntılı bilgi içerir ve manifestin en son ne zaman güncellendiğini, ne sıklıkta güncellendiğini ve daha fazlasını anlamanıza yardımcı olabilir.

Chrome'u güncellenmiş bir manifestoyu manuel olarak kontrol etmeye zorlamak için Chrome'u komut satırı işareti --disable-manifest-update-throttle ile başlatabilir veya Chrome'u yeniden başlatabilirsiniz (about://restart kullanın). Böylece zamanlayıcı sıfırlanır ve PWA bir sonraki kullanıma sunulduğunda Chrome güncellenmiş manifesti kontrol eder. Sonra PWA'yı başlatın. PWA kapatıldıktan sonra yeni manifest özellikleriyle güncellenmesi gerekir.

Referanslar

Android için Chrome'daki güncellemeler

PWA kullanıma sunulduğunda Chrome, yerel manifestin değişikliklerin en son ne zaman kontrol edileceğini belirler. Manifest son 24 saat içinde kontrol edilmemişse Chrome, manifest için bir ağ isteği planlar ve ardından bunu yerel kopyayla karşılaştırır.

Manifest'teki belirli özellikler değiştiyse (aşağıdaki listeye bakın) Chrome yeni manifesti sıraya koyar ve tüm PWA pencereleri kapatıldıktan sonra cihaz takılıp kablosuz ağa bağlanıldığında Chrome, sunucudan güncellenmiş bir WebAPK ister. Güncellendikten sonra yeni manifestteki tüm alanlar kullanılır.

Hangi mülkler güncelleme tetikler?

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

Chrome, sunucudan güncellenmiş bir manifest alamazsa kontroller arasındaki süreyi 30 güne uzatabilir.

Manifest güncellemelerini test etme

about://webapks sayfasında, cihazda yüklü tüm PWA'lar hakkında ayrıntılı bilgiler yer alır. Bu sayfada manifestin en son ne zaman güncellendiği, ne sıklıkta güncellendiği ve daha fazlası yer alır.

Manifestte manuel olarak bir güncelleme planlamak için zamanlayıcıyı ve yerel manifesti geçersiz kılarak aşağıdakileri yapın:

  1. Cihazı fişe takın ve kablosuz ağa bağlı olduğundan emin olun.
  2. Android görev yöneticisini kullanarak PWA'yı kapatın, ardından PWA'yı zorla durdurmak için Android ayarlarındaki uygulama panelini kullanın.
  3. Chrome'da about://webapks sayfasını açın ve PWA için "Güncelle" düğmesini tıklayın. "Güncelleme Durumu" "Beklemede" olarak değişir.
  4. PWA'yı başlatın ve düzgün şekilde yüklendiğinden emin olun.
  5. Android görev yöneticisini kullanarak PWA'yı kapatın, ardından PWA'yı zorla durdurmak için Android ayarlarındaki uygulama panelini kullanın.

PWA genellikle birkaç dakika içinde güncellenir. Güncelleme tamamlandıktan sonra "Durumu Güncelle" seçeneği "Başarılı" olarak değişir.

Referanslar