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ı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. Tarayıcı en son başlatıldıktan sonra manifest kontrol edilmediyse veya son 24 saat içinde kontrol edilmediyse Chrome, manifest için bir ağ isteği gönderir ve ardından manifest'i 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, icons hariç yeni manifest'teki 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 görüntüleme modunu browser'ten standalone'e güncellerseniz mevcut kullanıcılarınızın uygulamaları, güncellemeden sonra pencerede açılmaz. Bir web uygulaması için iki görüntüleme ayarı vardır: manifest'ten (kontrol ettiğiniz) ve kullanıcı tarafından kontrol edilen bir pencere/tarayıcı sekmesi ayarı. Kullanıcı tercihine her zaman saygı duyulur.

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 manifest olup olmadığını 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ırlayarak Chrome'un PWA bir sonraki kez açıldığında güncellenmiş bir manifest olup olmadığını kontrol etmesini sağlar. 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ılırken Chrome, yerel manifest'in son ne zaman değişiklik açısından kontrol edildiğini belirler. Manifest son 24 saat içinde kontrol edilmediyse Chrome, manifest için bir ağ isteği planlar ve ardından manifest'i 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üncelleme yapıldıktan sonra yeni manifest'teki 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üncel 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. PWA'yı kapatmak için Android görev yöneticisini, 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. PWA'yı kapatmak için Android görev yöneticisini, 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