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

Pete LePage

Not: Şu anda Chrome dışındaki tarayıcılarda veri topluyoruz. Bu verileri toplamamıza yardımcı olmak veya bu sayfaya içerik eklemek istiyorsanız lütfen 4038 numaralı soruna yorum bırakın.

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ı 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?

Dikkat: Web uygulaması manifest dosyanızın adını veya konumunu değiştirmeyin. Değiştirme işlemi, tarayıcının PWA'nızı güncellemesini engelleyebilir.

Çoğu durumda değişikliklerin, manifest güncellendikten sonraki bir veya iki gün içinde kullanıma sunulması gerekir.

Masaüstü Chrome'daki güncellemeler

PWA başlatıldığında veya bir tarayıcı sekmesinde açıldığında Chrome, yerel manifestte değişiklik olup olmadığını en son ne zaman kontrol edildiğini belirler. Manifest, tarayıcının en 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ştiyse (aşağıdaki listeye bakın) Chrome yeni manifesti sıraya alır ve tüm pencereler kapatıldıktan sonra dosyayı yükler. Yüklendikten sonra, yeni manifestteki tüm alanlar (name, short_name ve icons hariç) güncellenir.

Hangi özellikler güncellemeyi tetikler?

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

Dikkat: name, short_name ve icons ile ilgili değişiklikler şu anda masaüstü Chrome'da desteklenmez, ancak bu değişiklikleri desteklemek için çalışmalar devam etmektedir.

Dikkat: start_url dokümanında yapılan değişiklikler için id manifestinin ayarlanması gerekir. Daha fazla bilgi

display alanı güncellendiğinde ne olur?

Uygulamanızın görüntüleme modunu browser yerine standalone olarak güncellerseniz mevcut kullanıcılarınızın uygulamaları güncelleme sonrasında bir pencerede açılmaz. Bir web uygulaması için, manifest dosyasındakiler (kontrolünüzdeki) ve kullanıcı tarafından kontrol edilen pencere/tarayıcı sekmesi ayarı olmak üzere iki görüntüleme ayarı vardır. Kullanıcının tercihine her zaman saygı gösterilir.

Manifest güncellemelerini test etme

chrome://web-app-internals sayfası (Chrome 85 veya sonraki sürümlerde kullanılabilir) cihazda yüklü 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şaretiyle --disable-manifest-update-throttle veya Chrome'u yeniden başlatabilirsiniz (about://restart kullanın). Bu işlem, zamanlayıcıyı sıfırlayarak PWA'nın bir sonraki lansmanında Chrome'un güncellenmiş manifesti kontrol etmesini sağlar. Sonra PWA'yı başlatın. PWA kapatıldıktan sonra yeni manifest özellikleriyle güncellenmesi gerekir.

Referanslar

• Güncellenebilir Web Manifest Alanları

Android için Chrome ile ilgili güncellemeler

PWA kullanıma sunulduğunda Chrome, yerel manifestte değişiklik olup olmadığının 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 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 alır ve tüm PWA pencereleri kapatıldıktan sonra cihaz takılı olup kablosuz ağa bağlandıktan sonra sunucudan güncellenmiş bir WebAPK'sı ister. Güncellendiğinde, yeni manifest'teki tüm alanlar kullanılır.

Hangi özellikler güncellemeyi tetikler?

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

Chrome, güncellenmiş bir manifesti sunucudan alamazsa kontroller arasındaki süre 30 güne kadar çıkabilir.

Dikkat: name, short_name ve icons ile ilgili değişiklikler şu anda Android Chrome'da desteklenmemektedir, ancak bu değişikliklerin desteklenmesi için çalışmalar devam etmektedir.

Manifest güncellemelerini test etme

about://webapks sayfasında, cihazda yüklü tüm PWA'lar hakkında ayrıntılı bilgi yer alır ve manifestin en son ne zaman güncellendiğini, ne sıklıkla güncellendiğini ve daha fazlasını görebilirsiniz.

Manifest'te manuel olarak 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 Android ayarlarındaki Uygulama panelini kullanarak PWA'yı zorla durdurun.
3. Chrome'da about://webapks uygulamasını açın ve PWA için "Güncelle" düğmesini tıklayın. "Güncelleme Durumu" "Beklemede" olarak değişecektir.
4. PWA'yı başlatın ve doğru şekilde yüklendiğini doğrulayın.
5. Android görev yöneticisini kullanarak PWA'yı kapatın, ardından Android ayarlarındaki Uygulama panelini kullanarak PWA'yı zorla durdurun.

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

Referanslar

• Android'de Chrome için UpdateReason sıralaması