Güvenilir web etkinliklerini ayarlamak, özellikle de tek yapmak istediğiniz web sitenizi göstermekse biraz zor olabilir. Bu kılavuzda, Güvenilir Web Etkinlikleri'ni kullanan temel bir proje oluşturma sürecindeki tüm püf noktaları ele alınmaktadır.
Bu rehberin sonunda:
- Güvenilir Web Etkinliği kullanan ve doğrulamayı geçen bir uygulama oluşturmak için Bubblewrap'ı kullandınız.
- İmzalama anahtarlarınızın ne zaman kullanıldığını anlayın.
- Android uygulamanızın hangi imzayla derlendiğini belirleyebilirsiniz.
- Temel bir Dijital Öğe Bağlantıları dosyasını nasıl oluşturacağınızı öğrenin.
Bu kılavuzu uygulamak için şunlar gerekir:
- Geliştirme bilgisayarında Node.js 10 veya sonraki bir sürüm yüklü olmalıdır.
- Geliştirme için bağlı ve ayarlanmış bir Android telefon veya emülatör (Fiziksel telefon kullanıyorsanız USB hata ayıklama özelliğini etkinleştirin.)
- Geliştirme telefonunuzda Güvenilir Web Etkinliği'ni destekleyen bir tarayıcı
- Güvenilir Web Etkinliği'nde görüntülemek istediğiniz bir web sitesi
Güvenilir Web Etkinliği, Android Uygulamanızın herhangi bir tarayıcı kullanıcı arayüzü olmadan tam ekran bir Tarayıcı Sekmesi başlatmasına olanak tanır. Bu özellik, sahip olduğunuz web siteleriyle sınırlıdır ve bunu Digital Asset Links'i ayarlayarak kanıtlarsınız. Bu konular hakkında daha sonra daha ayrıntılı olarak konuşacağız.
Güvenilir Web Etkinliği'ni başlattığınızda tarayıcı, Digital Asset Link'lerin doğru olup olmadığını kontrol eder. Buna doğrulama denir. Doğrulama başarısız olursa tarayıcı, web sitenizi Özel Sekme olarak göstermeye geri döner.
BubbleWrap'ı yükleme ve yapılandırma
Bubblewrap, geliştiricilerin Güvenilir Web Etkinliği'ni kullanarak Android uygulamalarında Progressive Web Uygulamaları oluşturmasına, derlemesine ve çalıştırmasına yardımcı olan Node.js için bir kitaplık ve komut satırı aracıdır (CLI).
CLI aşağıdaki komutla yüklenebilir:
Ortamı ayarlama
BubbleWrap ilk kez çalıştırıldığında gerekli harici bağımlılıkları otomatik olarak indirip yüklemeyi önerir. Bağımlılıkların doğru şekilde yapılandırılmasını garanti ettiği için bu işlemi aracın yapmasını öneririz. Mevcut bir Java Geliştirme Kiti (JDK) veya Android komut satırı araçları yüklemesini kullanmak için BubbleWrap dokümanlarına bakın.
Projeyi başlatma ve derleme
PWA'yı saran bir Android projesinin başlatılması için init komutu çalıştırılır:
Bubblewrap, Web Manifesti'ni okur, geliştiricilerden Android projesinde kullanılacak değerleri onaylamalarını ister ve projeyi bu değerleri kullanarak oluşturur. Proje oluşturulduktan sonra aşağıdaki komutu çalıştırarak APK oluşturun:
Çalıştır
Derleme adımı, app-release-signed.apk
adlı bir dosya oluşturur. Bu dosya, test için bir geliştirme cihazına yüklenebilir veya yayınlanmak üzere Play Store'a yüklenebilir.
BubbleWrap uygulamayı yerel bir cihaza yüklemek ve test etmek için bir komut sağlar. Geliştirme cihazı bilgisayara bağlıyken şunları çalıştırın:
Alternatif olarak adb aracı da kullanılabilir.
Not: **adb**
komut satırı aracı, **android_sdk/platform-tools/**
'daki Android komut satırı araçlarının içinde yer alır.
Uygulama artık cihaz başlatıcıda kullanılabilir. Uygulamayı açtığınızda web sitenizin Güvenilir Web Etkinliği olarak değil, Özel Sekme olarak başlatıldığını fark edeceksiniz. Bunun nedeni, Dijital Öğe Bağlantıları doğrulamamızı henüz ayarlamamış olmamızdır. Ancak önce...
Bubblewrap için grafik kullanıcı arayüzü (GUI) alternatifleri
PWA Builder, Güvenilir Web Etkinliği projelerinin oluşturulmasını desteklemek için BubbleWrap kitaplığını kullanan bir GUI arayüzü sunar. PWA'nızı açan bir Android uygulaması oluşturmak için PWA Builder'ı kullanmayla ilgili daha fazla talimatı bu blog yayınında bulabilirsiniz.
İmzalama anahtarlarıyla ilgili not
Dijital Öğe Bağlantıları, bir APK'nın hangi anahtarla imzalandığını dikkate alır. Doğrulamanın başarısız olmasının yaygın nedenlerinden biri yanlış imzanın kullanılmasıdır. (Doğrulamanın başarısız olması durumunda, web sitenizi, en üstte tarayıcı kullanıcı arayüzüyle Özel Sekme olarak açacağınız anlamına gelir.) Bubblewrap, uygulamayı derlediğinde init
adımında bir anahtar kurulumu içeren bir APK oluşturulur. Ancak uygulamanızı Google Play'de yayınladığınızda, imzalama anahtarlarını nasıl kullanacağınıza bağlı olarak sizin için başka bir anahtar oluşturulabilir. Anahtarları imzalama ve bunların BubbleWrap ve Google Play ile ilişkisi hakkında daha fazla bilgi edinin.
Öğe bağlantısı dosyanızı ayarlama
Dijital Öğe Bağlantıları, temel olarak web sitenizde bulunan ve uygulamanıza yönlendiren bir dosyadan ve uygulamanızda web sitenize yönlendiren bazı meta verilerden oluşur.
assetlinks.json
dosyanızı oluşturduktan sonra adresindeki web sitenize yükleyin .well-known/assetlinks.json
köke göre) eklemeniz gerekir. İmzalama anahtarınızla ilişkisi hakkında daha fazla bilgi için Digital Asset Links hakkında ayrıntılı inceleme başlıklı makaleyi inceleyin.
Tarayıcınız kontrol ediliyor
Güvenilir Web Etkinliği, kullanıcının varsayılan tarayıcı seçimine uymaya çalışır. Kullanıcının varsayılan tarayıcısı Güvenilir Web Etkinlikleri'ni destekliyorsa tarayıcı açılır. Aksi takdirde, Güvenilir Web Etkinlikleri'ni destekleyen yüklü bir tarayıcı seçilir. Son olarak, varsayılan davranış Özel Sekmeler moduna geri dönmektir.
Diğer bir deyişle, Güvenilir Web Etkinlikleri ile ilgili bir şey için hata ayıklıyorsanız, düşündüğünüz tarayıcıyı kullandığınızdan emin olmanız gerekir. Kullanılan tarayıcıyı kontrol etmek için aşağıdaki komutu kullanabilirsiniz:
Sonraki Adımlar
Bu kılavuzu uyguladıysanız Trusted Web Activity'nin çalıştığını ve doğrulama başarısız olduğunda neler olduğunu hata ayıklayacak kadar bilgi sahibi olduğunuzu umuyoruz. Aksi takdirde, web geliştiricileri için Android kavramlarına göz atın veya bu dokümanlar için GitHub'da sorun bildirin.
Sonraki adımlarınız için uygulamanız için bir simge oluşturarak başlamanızı öneririz. Bu işlemi tamamladıktan sonra uygulamanızı Play Store'a dağıtabilirsiniz.