Güvenilir web etkinliklerini ayarlamak, özellikle de tek amacınız 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ı. 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 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'i yükleme ve yapılandırma
Bubblewrap, geliştiricilerin Güvenilir Web Etkinliği'ni kullanarak Android uygulamalarında Progresif Web Uygulamaları oluşturmasına, derlemesine ve çalıştırmasına yardımcı olan bir Node.js kitaplığı ve 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ı 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ükleyip 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ı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ğ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
Digital Asset Links temel olarak web sitenizde uygulamanızı gösteren bir dosyadan ve uygulamanızda web sitenizi gösteren 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 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.
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ığını ve doğrulama başarısız olduğunda neler olduğunu hata ayıklamanıza yetecek kadar bilgiye sahip 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.