Güvenilir web etkinliklerini ayarlamak, özellikle de tek amacınız web sitenizi göstermekse biraz zor olabilir. Bu kılavuz, Güvenilir Web Etkinliklerini kullanan ve tüm kazanımları kapsayan temel bir proje oluşturma konusunda size yol gösterecektir.
Bu kılavuzun sonunda:
- Güvenilir Web Etkinliği kullanan ve doğrulamayı geçen bir uygulama geliştirmek için BubbleWrap kullanmış olmanız gerekir.
- İ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ılavuza uymak için şunlara ihtiyacınız vardır:
- 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ı. Chrome 72 veya sonraki sürümler kullanılabilir. Diğer tarayıcılarda destek yakında kullanıma sunulacaktır.
- 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 kontrol edilip edilmediğini 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
Bubblepack, geliştiricilerin Güvenilir Web Etkinliği'ni kullanarak Android uygulamaları içinde Progresif Web Uygulamaları oluşturmasına, geliştirmesine ve çalıştırmasına yardımcı olan Node.js'ye yönelik bir kitaplık ve komut satırı aracıdır.
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ı otomatik olarak indirip yüklemeyi teklif eder. Bağımlılıkların doğru şekilde yapılandırılmasını garanti ettiği için aracın bunu yapmasına izin vermenizi öneririz. Mevcut bir Java Development Kit (JDK) veya Android komut satırı araçları yüklemesini kullanmak için Bubblewrap belgelerini inceleyin.
Projeyi başlatma ve derleme
PWA'yı sarmalayan bir Android projesini başlatmak için init komutu çalıştırılır:
bubblewrap init --manifest=https://my-twa.com/manifest.json
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:
bubblewrap build
Ç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:
bubblewrap install
Alternatif olarak adb aracı da kullanılabilir.
adb install app-release-signed.apk
Uygulama artık cihaz başlatıcısında 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ğrulamasını 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ü sağlar. PWA Builder'ı kullanarak PWA'nızı açan bir Android uygulaması oluşturma hakkında 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 sayfanın üst kısmında tarayıcı kullanıcı arayüzü bulunan bir özel sekme olarak başlatacağınızı unutmayın.) 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. İmza anahtarları ve Bubblewrap ile Google Play ile olan ilişkileri 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, uygulamanızın tarayıcı tarafından doğru şekilde doğrulanabilmesi için dosyayı köke göre .well-known/assetlinks.json adresinde web sitenize yükleyin. İmzalama anahtarınızla nasıl bir ilişkisi olduğu hakkında daha fazla bilgi için Digital Asset Links'in ayrıntılı incelemesine göz atın.
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 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.
Yani Güvenilir Web Etkinlikleri ile ilgili bir konuda hata ayıklıyorsunuz. Bu durumda, kullandığınız tarayıcıyı doğrulamanız gerekir. Kullanılan tarayıcıyı 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 Trusted Web Activity'nin çalıştığından ve doğrulama başarısız olduğunda neler olduğunu hata ayıklayacak kadar bilgi sahibi olduğunuzdan emin olabilirsiniz. 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.