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ılırken açılması gereken URL için web uygulaması manifest'indeki 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, manifest güncellendikten sonra değişiklikler PWA'nın kullanıma sunulmasından bir veya iki gün sonra yansıtılır.

Masaüstü Chrome'da güncellemeler

PWA başlatıldığında veya bir tarayıcı sekmesinde açıldığında Chrome, yerel manifest'in son ne zaman değişiklik açısından 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'teki belirli özellikler değişirse (aşağıdaki listeye bakın) Chrome yeni manifest'i sıraya alır ve tüm pencereler kapatıldıktan sonra yükler. Yüklendikten sonra yeni manifest'te bulunan icons hariç tüm alanlar güncellenir.

Hangi özellikler güncellemeyi tetikler?

  • name
  • short_name
  • 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ılabilir), cihaza yüklü tüm PWA'lar hakkında ayrıntılı bilgiler içerir ve manifest'in 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. Ardından 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 başlatılırken Chrome, yerel manifest'in son ne zaman değişiklikler açısından kontrol edildiğ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şirse (aşağıdaki listeye bakın) Chrome yeni manifest'i sıraya alır. PWA'nın tüm pencereleri kapatıldıktan, cihaz prize takıldıktan ve 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 mülkler güncelleme tetikler?

  • name
  • short_name
  • icons
  • 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ı, cihaza yüklenen tüm PWA'lar hakkında ayrıntılı bilgiler içerir. Ayrıca manifest'in en son ne zaman güncellendiğini, ne sıklıkta güncellendiğini ve daha fazlasını öğrenebilirsiniz.

Zamanlayıcıyı ve yerel manifesti geçersiz kılarak manifest güncellemesini manuel olarak planlamak için 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 simgesini 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ğini doğrulayın.
  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 "Güncelleme Durumu" "Başarılı" olarak değişir.

Referanslar