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

PWA'nızın simgelerini, kısayollarını, renklerini ve diğer meta verilerini 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. Ancak uygulama kısayollarını güncellemeniz veya yeni bir tema rengi denemeniz gerekirse ne yapmalısınız? Bu değişiklikler tarayıcıya ne zaman ve nasıl yansıtılır?

Çoğu durumda, manifest güncellendikten sonra PWA başlatıldıktan sonraki bir veya iki gün içinde değişiklikler yansıtılır.

Masaüstü Chrome'daki güncellemeler

PWA başlatıldığında veya bir tarayıcı sekmesinde açıldığında Chrome, yerel manifestin en son ne zaman değişiklikler için kontrol edildiğini belirler. Manifest, tarayıcı son başlatıldığından beri veya son 24 saat içinde kontrol edilmediyse Chrome, manifest için bir ağ isteğinde bulunur ve ardından bunu yerel kopya ile karşılaştırır.

Manifestteki 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, icons dışındaki yeni manifestteki tüm alanlar güncellenir.

Hangi özellikler güncellemeyi tetikler?

  • name
  • short_name
  • display (aşağıya bakın)
  • scope
  • shortcuts
  • start_url Dikkat: start_url ile ilgili değişiklikler için manifest id ayarlanmalıdır. Daha fazla bilgi
  • theme_color
  • file_handlers

display alanı güncellendiğinde ne olur?

Uygulamanızın görüntüleme modunu browser'dan standalone'ya güncellerseniz mevcut kullanıcılarınız uygulamalarını güncelledikten sonra pencerede açamaz. Web uygulamaları için iki görüntüleme ayarı vardır: manifest dosyasındaki (sizin kontrol ettiğiniz) ayar ve kullanıcı tarafından kontrol edilen pencere ve tarayıcı sekmesi ayarı. Kullanıcı 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ılabilir), cihaza yüklenen tüm PWA'lar hakkında ayrıntılı bilgiler 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 manifesti kontrol etmeye manuel olarak 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). Bu işlem, zamanlayıcıyı sıfırlar. Böylece Chrome, PWA bir sonraki başlatıldığında güncellenmiş bir manifesti kontrol eder. Ardından PWA'yı başlatın. PWA kapatıldıktan sonra yeni manifest özellikleriyle güncellenmelidir.

Referanslar

Android için Chrome'daki güncellemeler

PWA başlatıldığında Chrome, yerel manifestin değişiklikler için en son ne zaman kontrol edildiğini belirler. Manifest son 24 saat içinde kontrol edilmediyse Chrome, manifest için bir ağ isteği planlar ve ardından bunu yerel kopya ile 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 PWA'nın tüm pencereleri kapatıldıktan, cihaz prize takılıp kablosuz ağa bağlandıktan sonra Chrome, sunucudan güncellenmiş bir WebAPK ister. Güncellendikten sonra yeni manifestteki tüm alanlar kullanılır.

Hangi özellikler güncellemeyi tetikler?

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

Chrome, sunucudan güncellenmiş bir manifest alamıyorsa denetimler arasındaki süreyi 30 güne çıkarabilir.

Manifest güncellemelerini test etme

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

Manifest dosyasında güncellemeyi manuel olarak planlamak, zamanlayıcıyı ve yerel manifesti geçersiz kılmak için aşağıdakileri yapın:

  1. Cihazı prize takın ve kablosuz ağa bağlı olduğundan emin olun.
  2. PWA'yı kapatmak için Android görev yöneticisini kullanın, ardından PWA'yı durdurmaya zorlamak için Android ayarlarındaki Uygulama panelini kullanın.
  3. Chrome'da about://webapks simgesini açın ve PWA için "Güncelle" düğmesini tıklayın. "Durumu Güncelle" seçeneği "Beklemede" olarak değişmelidir.
  4. PWA'yı başlatın ve düzgün şekilde yüklendiğini doğrulayın.
  5. PWA'yı kapatmak için Android görev yöneticisini kullanın, ardından PWA'yı durdurmaya zorlamak için Android ayarlarındaki Uygulama panelini kullanın.

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

Referanslar