PWA'nızın dönüşümünü ve kullanımını iyileştirebilecek birçok geliştirme vardır.
Uygulama kısayolları
Uygulama kısayolları, PWA'nıza ait derin bağlantıların statik bir listesidir ve manifest dosyanıza yazılır. Web Uygulaması Manifesti spesifikasyonu. PWA'nızdaki farklı bölümlere veya özelliklere ait kısayolların listesini tanımlamanıza olanak tanır. Bu kısayollar, sık erişilen bölümlere gitmeyi hızlandırır.
Uygulama kısayolları, çoğu masaüstü işletim sisteminde ve Android'de WebAPK ile kullanılabilir. Bu kısayollar, aşağıdaki resimde gösterildiği gibi ana ekran, dock veya görev çubuğundaki uygulama simgesinin bağlama dayalı menüsünde görünür:
Bu menüye erişmek için kullanıcıların PWA'nın simgesini sağ tıklaması veya simgeye uzun basması gerekir.
Kısayollar, manifest'in shortcuts
üyesinde tanımlanır. Aşağıdaki özelliklere sahip bir üye dizisi alır:
name
- Kullanıcının göreceği metin (genellikle bir bağlam menüsünde).
url
- Kullanıcı bu kısayoldan uygulamayı başlattığında uygulamanın yüklemesi gereken URL. PWA kapsamınızdaki bir URL olmalıdır ve
name
veyashort_name
'ın tanımladığı özelliğe derin bağlantı vermelidir. short_name
- (İsteğe bağlı)
name
alanının tam değerini görüntülemek için yeterli yer olmadığında kullanılan daha kısa bir ad. description
- (İsteğe bağlı) Bu kısayolun ne yapacağını açıklayan bir açıklama
icons
- (İsteğe bağlı)
src
,type
,sizes
ve isteğe bağlıpurpose
alanlarını içeren, kısayolun hangi resimlerle temsil edileceğini açıklayan bir simge nesnesi dizisi
Uygulama kısayollarını, mümkün olduğunca kullanılabilecek bir özellik olarak değerlendirmeniz gerekir. Bu, bu kısayolların tutarlı bir şekilde gösterilmesini bekleyemezsiniz. Gösterilse bile, tarayıcı tercihine bağlı olarak kaç kısayol gösterileceğini veya platformun simgeleri yoksayıp yoksayacağını bilemezsiniz. Platform başına kapsamlı bir tartışma yapmak bu makalenin kapsamı dışındadır ancak Android ve masaüstünde nasıl çalıştığına dair bir fikir edinmek için aşağıdaki bölümü inceleyebilirsiniz. Bu belirsizlikle başa çıkmanın en iyi yolu, öğeleri önceliğe göre sıralamaktır.
Aşağıdaki kod örneğinde, uygulamayı Android'de Chrome ile veya masaüstünde Edge ya da Chrome ile yüklerseniz denemeniz önerilen farklı uygulama kısayolları tanımlanmaktadır.
iOS ve iPadOS
PWA'ları yayınlarken iOS/iPadOS'teki Safari kullanıcılarının deneyimini iyileştirebilecek bazı geliştirmeler vardır.
Başlangıç ekranları
Web Uygulaması Manifesti bölümünde görüldüğü gibi Android, manifest'in değerlerine göre açılış ekranlarını otomatik olarak oluşturur. iOS ve iPadOS'te durum böyle değildir. Bu cihazlarda, HTML'deki açılış ekranlarını <link>
öğelerini kullanarak statik resimler olarak tanımlamanız gerekir.
Bu resimler Apple cihazlarda başlangıç resimleri olarak bilinir ve rel
mülkü apple-touch-startup-image
değeriyle kullanılır. Örneğin:
<link rel="apple-touch-startup-image" href="ios-startup.png">
Sorun, başlangıç resminin PWA'nızın açılışında sahip olacağı pencere boyutuyla tam olarak aynı olması gerektiğidir. Bu nedenle, farklı iOS ve iPadOS cihazlar için farklı resimlere ihtiyaç vardır. iPad'de yatay/dikey açılışlar ve PWA'nın çoklu görev modunda (ör. ekranın 1/3, 1/2 veya 2/3'ü) oluşturulması gibi daha fazla durum ele alınmalıdır.
iOS ve iPadOS ekran boyutlarının güncel listesini Apple Kullanıcı Arayüzü Kuralları'nda bulabilirsiniz.
Lansman resminin farklı sürümleri, media
özelliği içinde bir medya sorgusuyla ayarlanabilir:
<link rel="apple-touch-startup-image" href="ios-startup.png"
media="orientation: portrait">
<link rel="apple-touch-startup-image" href="ios-startup-landscape.png"
media="orientation: landscape">
iOS başlangıç resimleri için tasarım kalıpları
Başlangıç resimlerini tanımlamak zor bir iştir. Bu nedenle, otomatik oluşturma ve yapılandırma için birkaç aracımız vardır:
- Statik oluşturma, derleme sisteminizle entegre olur, tüm PNG statik resimlerini oluşturur ve belgenize yerleştirilecek
<link>
öğelerini içeren HTML kodunu verir. PWA Asset Generator bu tür bir araca örnek gösterilebilir. - İstemci tarafı oluşturucu: Başlangıç resminin bir veya daha fazla base64 sürümünü, mevcut cihazın türüne ve ekran boyutuna göre
<link>
yerleştirilmiş öğelere yerleştirebilen bir JavaScript aracıdır. Bellek içi bir kanvas kullanabilir, resmi oluşturabilir ve PNG dosyası içeren birdata:
URI'ye dönüştürebilirsiniz. PWA Compat kitaplığı, Android'in tipik başlatma ekranını kopyalayarak bu işlemi yapan, kullanımı kolay bir istemci tarafı kitaplığıdır.
Apple mobil platformlarında PWA'ları algılama
PWA'nızda aşamalı geliştirme ve özellik algılama özelliklerini kullanmanız gerekir. Ancak kullanıcının Apple mobil platformlarında bir PWA'da olup olmadığını bilmemiz gereken bazı uç durumlar olabilir. Örneğin, yükleme talimatları sunmak veya yalnızca iOS'e özgü platformlara özel uygulamalara bağlantı eklemek isteyebilirsiniz.
Kullanıcı aracısı dizesinin okunmasını önlemek için navigator
nesnesinin standalone
mülkünü kontrol edin. Bu standart olmayan özellik yalnızca iOS ve iPadOS'teki WebKit motorunda kullanılabilir.
navigator.standalone
undefined
ise kullanıcının iPadOS veya iOS cihazı kullanmadığı anlamına gelir.navigator.standalone
false
ise kullanıcının PWA'yı tarayıcıda açtığı ve orada kullandığı anlamına gelir.navigator.standalone
true
ise kullanıcının PWA'yı ana ekrandan açtığı ve bağımsız PWA deneyimini yaşadığı anlamına gelir.
Tam ekran desteği
iOS ve iPad'lerdeki Safari'de PWA'nız için görüntüleme modu olarak yalnızca display: standalone
desteklenir.
Bir sonraki resimde, solda tema rengi içeren varsayılan bağımsız bir tasarım, sağda ise durum çubuğunun arkasında içerik oluşturmanıza olanak tanıyan tam ekran iOS moduna sahip bir PWA görebilirsiniz.
HTML'nize aşağıdaki etiketi eklerseniz iOS ve iPadOS'teki PWA'nız tam ekran moduna girer. Ancak bu, Android'den farklıdır.
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
Bu modda cihazın durum çubuğu (saat, pil seviyesi ve bildirim simgelerini gördüğünüz üst kısım) görünür durumda kalır ancak içeriğinizin üzerinde şeffaf bir arka planla oluşturulur.
Bu modu kullanırken işletim sistemi simgeleri her zaman beyaz olarak oluşturacağından tasarımınıza dikkat edin. Bu nedenle, ekranın üst kısmındaki arka planlarınızı her zaman açık renkli içeriklerle kontrast oluşturacak şekilde tasarlamanız gerekir. Ayrıca, Uygulama Tasarımı Bölümünde görüldüğü gibi, içeriği güvenli alanda oluşturmak için CSS ortam değişkenlerini kullanmak da önemlidir.
Kurulum güvenilirliği
15.4'ten önceki iOS ve iPadOS sürümlerinde manifest dosyası, sayfa yüklendiğinde değil, yalnızca kullanıcı tarayıcıdaki paylaşım simgesini kullanarak paylaşım sayfasını açtığında ağdan yüklenir. Bu nedenle tarayıcı, web sitenizin PWA olup olmadığını o ana kadar kontrol etmez. Bu durum, manifest'in yüklenemediği veya çok fazla zaman aldığı ve tarayıcının bunu yoksadığı durumlara yol açabilir.
Tarayıcı manifesti zamanında yükleyemediğinde "Ana ekrana ekle"ye basıldığında ana ekrana bir simge yerleştirilir ancak uygulama deneyimi sağlanmaz. Bu simge yalnızca bir tarayıcı sekmesine kısayol olur.