Güvenilir Web Etkinlikleri'ni ayarlamak, özellikle tek yapmak istediğiniz web sitenizi görüntülemekse biraz zor olabilir. Bu kılavuz, Güvenilir Web Etkinlikleri kullanan temel bir proje oluşturma konusunda size yol göstererek tüm fırsatları ele almanızı sağlayacaktır.
Bu kılavuzun sonunda:
- Güvenilir Web Etkinliği kullanan ve doğrulamadan geçen bir uygulama derlemek için Bubblewrap kullanıldı.
- İmza anahtarlarınızın ne zaman kullanıldığını anlayın.
- Android Uygulamanızı oluştururken kullanılan imzayı belirleyebilmeniz.
- Temel bir Digital Asset Links dosyasının nasıl oluşturulacağını öğrenin.
Bu kılavuzu izlemek için şunlara ihtiyacınız vardır:
- Geliştirme bilgisayarına Node.js 10 veya sonraki bir sürüm yüklü.
- Bağlı ve geliştirme için ayarlanmış bir Android telefon veya emülatörü (Fiziksel telefon kullanıyorsanız USB hata ayıklamasını etkinleştirin).
- Geliştirme telefonunuzda Güvenilir Web Etkinliği'ni destekleyen bir tarayıcı Chrome 72 veya sonraki sürümler çalışır. Diğer tarayıcılarda da destek sunulmaya başlandı.
- 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 Tarayıcı Sekmesi başlatmasına olanak tanır. Bu özellik, sahip olduğunuz web siteleriyle sınırlıdır ve Dijital Öğe Bağlantıları oluşturarak bunu kanıtlarsınız. Bunlar hakkında daha sonra daha fazla bilgi vereceğiz.
Bir Güvenilir Web Etkinliği başlattığınızda tarayıcı, Digital Asset Link ödeme işleminin yapıldığını kontrol eder. Buna doğrulama denir. Doğrulama başarısız olursa tarayıcı, web sitenizi Özel Sekme olarak görüntüler.
Bubblewrap'ı yükleme ve yapılandırma
Bubblewrap, Node.js için geliştiricilerin Güvenilir Web Etkinliği'ni kullanarak Android uygulamaları içinde Progresif Web Uygulamaları oluşturmasına, oluşturmasına ve çalıştırmasına yardımcı olan bir kitaplık seti ve bir komut satırı aracıdır (CLI).
CLI, aşağıdaki komutla yüklenebilir:
npm i -g @bubblewrap/cli
Ortamı Ayarlama
Bubblewrap ilk kez çalıştırıldığında gerekli harici bağımlılıkların otomatik olarak indirilmesini ve yüklenmesini teklif eder. Bağımlılıkların doğru şekilde yapılandırıldığından emin olacağı için aracın bunu yapmasına izin vermenizi öneririz. Mevcut bir Java Geliştirme Kiti (JDK) veya Android komut satırı aracı yüklemesini kullanmak için Bubblewrap dokümanlarına göz atın.
Projeyi başlatma ve derleme
PWA'yı sarmalayan bir Android projesini başlatma işlemi, init komutu çalıştırılarak yapılır:
bubblewrap init --manifest=https://my-twa.com/manifest.json
Bubblewrap Web Manifest'i okur, geliştiricilerden Android projesinde kullanılacak değerleri onaylamalarını ister ve bu değerleri kullanarak projeyi oluşturur. Proje oluşturulduktan sonra, aşağıdaki komutu çalıştırarak bir APK oluşturun:
bubblewrap build
Çalıştır
Derleme adımında, app-release-signed.apk adlı bir dosya oluşturulur. 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ükleyip test etmek için bir komut sağlar. Bilgisayara bağlı geliştirme cihazıyla şunları çalıştırın:
bubblewrap install
Alternatif olarak adb aracı kullanılabilir.
adb install app-release-signed.apk
Uygulama artık cihaz başlatıcıda kullanılabilir. Uygulamayı açarken web sitenizin Güvenilir Web Etkinliği 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. Bunun nedeni, öncelikle...
Bubblewrap için Grafik Kullanıcı Arayüzü (GUI) alternatifleri
PWA Builder, Güvenilir Web Etkinliği projelerinin oluşturulmasına güç vermek için Bubblewrap kitaplığını kullanan bir GUI arayüzü sağlar. PWA'nızı açan bir Android uygulaması oluşturmak için PWA Builder'ı nasıl kullanacağınız hakkında daha fazla talimatı bu blog yayınında bulabilirsiniz.
İmzalama anahtarlarıyla ilgili bir not
Digital Asset Links, APK'nın imzalandığı anahtarı dikkate alır. Doğrulamanın başarısız olmasının yaygın bir nedeni de yanlış imza kullanmaktır. (Doğrulama işleminin başarısız olması, web sitenizi, sayfanın üst kısmında tarayıcı kullanıcı arayüzü bulunan bir Özel Sekme olarak açacağınız anlamına gelir.) Bubblewrap uygulama derlerken init adımı sırasında anahtar kurulumu ile bir APK oluşturulur. Ancak uygulamanızı Google Play'de yayınladığınızda, imzalama anahtarlarını nasıl ele alacağınızı seçtiğinize bağlı olarak sizin için başka bir anahtar oluşturulabilir. Anahtarları imzalama ve anahtarların Bubblewrap ve Google Play ile ilişkisi hakkında daha fazla bilgi edinin.
Öğe bağlantısı dosyanızı oluşturma
Digital Asset Link temel olarak, web sitenizde bulunan ve uygulamanıza yönlendiren bir dosyadan ve web sitenize yönlendiren bazı meta verilerden oluşur.
assetlinks.json dosyanızı oluşturduktan sonra, bu dosyayı web sitenize (köke göre .well-known/assetlinks.json bağlantısından) yükleyin. Böylece, uygulamanız tarayıcı tarafından doğru bir şekilde doğrulanabilir. Bu bağlantının imzalama anahtarınızla nasıl alakalı olduğu hakkında daha fazla bilgi edinmek için Digital Asset Links hakkında ayrıntılı bilgi bulabilirsiniz.
Tarayıcınız kontrol ediliyor
Güvenilir Web Etkinliği, kullanıcının varsayılan tarayıcı seçimine bağlı kalmaya çalışır. Kullanıcının varsayılan tarayıcısı Güvenilir Web Etkinlikleri'ni destekliyorsa bu hizmet başlatılır. Bu ayar etkinleştirilmezse, güvenilir Web Etkinlikleri'ni destekleyen yüklü tarayıcılar seçilir. Son olarak, varsayılan davranış Özel Sekmeler moduna geri dönmektir.
Bu, Güvenilir Web Etkinlikleri ile ilgili bir hata ayıklama işlemi gerçekleştiriyorsanız, doğru olduğunu düşündüğünüz tarayıcıyı kullandığınızdan emin olmanız gerekir. Hangi tarayıcının kullanıldığını kontrol etmek için aşağıdaki komutu kullanabilirsiniz:
> adb logcat -v brief | grep -e TWAProviderPicker
D/TWAProviderPicker(17168): Found TWA provider, finishing search: com.google.android.apps.chrome
Sonraki adımlar
Bu kılavuzu uyguladıysanız çalışan bir Güvenilir Web Etkinliğiniz olduğunu ve doğrulama başarısız olduğunda ne olup bittiği konusunda hata ayıklama konusunda yeterli bilgiye sahip olacağınızı umuyoruz. Değilse web geliştiricileri için Android kavramlarına göz atın veya bu belgelere dayanarak GitHub sorunu oluşturun.
Sonraki adımlarınızda uygulamanız için bir simge oluşturarak başlamanızı öneririm. Bunun ardından, uygulamanızı Play Store'a dağıtmayı düşünebilirsiniz.