Güvenilir web etkinliklerinin kurulumu zor olabilir. Özellikle yalnızca web sitenizi göstermek istiyorsanız bu durum geçerlidir. Bu kılavuzda, Güvenilir Web Etkinlikleri'ni kullanan küçük bir proje oluşturmayı öğreneceksiniz.
Bu rehberi tamamladığınızda:
- Güvenilir Web Etkinliği kullanan ve doğrulamayı geçen bir uygulama oluşturmak 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 oluşturulduğunu belirleyebilme
- Temel bir Digital Asset Links dosyası oluşturmayı öğrenin.
Bu rehberi uygulamak için ihtiyacınız olanlar:
- Node.js 10 veya üstü.
- Geliştirme için bağlı ve ayarlanmış bir Android telefon veya emülatör. Fiziksel bir telefon kullanıyorsanız USB üzerinden hata ayıklamayı etkinleştirin.
- Güvenilir Web Etkinliği'ni destekleyen bir mobil tarayıcı.
- Güvenilir Web Etkinliği'nde görüntülemek istediğiniz bir web sitesi.
Android uygulamanız için güvenilir web etkinliği kullanarak tarayıcı kullanıcı arayüzü olmadan tam ekran tarayıcı sekmesi başlatabilirsiniz. Bu özellik, sahibi olduğunuz web siteleriyle sınırlıdır. Digital Asset Links'i ayarlayarak sahipliğinizi kanıtlarsınız.
Güvenilir Web Etkinliği başlattığınızda tarayıcı, Dijital Varlık Bağlantılarını doğrular. 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 dizi kitaplık ve Node.js için bir komut satırı aracıdır (CLI).
Şu komutu çalıştırarak KSA'yı yükleyin:
npm i -g @bubblewrap/cli
Ortamı ayarlama
Bubblewrap'i ilk kez çalıştırdığınızda gerekli harici bağımlılıkları otomatik olarak indirip yüklemeyi teklif eder. Bağımlılıkların doğru şekilde yapılandırıldığından emin olmak için otomatik indirmelere izin vermenizi öneririz. Mevcut bir Java Development Kit (JDK) veya Android komut satırı araçları yüklemesini kullanmak için Bubblewrap belgelerine bakın.
Projeyi başlatma ve oluşturma
PWA'yı sarmalayan bir Android projesi başlatın:
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 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 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 şunu ç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ı görürsünüz. Bunun nedeni, henüz Digital Asset Links doğrulamasını ayarlamamış olmamızdır.
Bubblewrap için grafik kullanıcı arayüzü (GUI) alternatifleri
PWA Builder, Güvenilir Web Etkinliği projelerinin oluşturulmasını sağlamak için Bubblewrap kitaplığını kullanan bir GUI arayüzü sunar. PWA Builder'ı kullanarak PWA'nızı açan bir Android uygulaması oluşturma ile ilgili talimatları inceleyin.
İmzalama anahtarları
Digital Asset Links, bir APK'nın imzalandığı anahtarı dikkate alır. Doğrulamanın başarısız olmasının yaygın bir nedeni, yanlış imzanın kullanılmasıdır. (Doğrulama başarısız olursa 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ı oluşturduğunda, init adımında ayarlanan anahtarla bir APK oluşturulur. Ancak uygulamanızı Google Play'de yayınladığınızda, imzalama anahtarlarını nasıl kullanmayı seçtiğinize bağlı olarak sizin için başka bir anahtar oluşturulabilir. İmzalama anahtarları ve bunların Bubblewrap ile Google Play'le ilişkisi hakkında daha fazla bilgi edinin.
Öğe bağlantısı dosyanızı oluşturma
Digital Asset Links, temel olarak web sitenizde 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 düzgün şekilde doğrulanabilmesi için dosyayı web sitenize (kök dizine göre .well-known/assetlinks.json konumuna) yükleyin. İmzalama anahtarınızla ilişkisi hakkında daha fazla bilgi için Digital Asset Links hakkında ayrıntılı bilgi başlıklı makaleyi inceleyin.
Tarayıcınızı kontrol etme
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 Etkinliklerini destekliyorsa bu tarayıcı başlatılır. Bu da olmazsa yüklü tarayıcılardan herhangi biri Güvenilir Web Etkinlikleri'ni destekliyorsa o tarayıcı seçilir. Son olarak, varsayılan davranış, özel sekmeler moduna geri dönmektir.
Bu nedenle, Güvenilir Web Etkinlikleri ile ilgili bir şeyde hata ayıklıyorsanız kullandığınızı 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 umarız çalışan bir Güvenilir Web Etkinliğiniz ve doğrulama başarısız olursa hata ayıklama için yeterli bilginiz vardır. Aksi takdirde, web geliştiricileri için diğer Android kavramlarına göz atın.
Sonraki adım olarak uygulamanız için bir simge oluşturun. Bu işlem tamamlandıktan sonra uygulamanızı Play Store'da yayınlamayı düşünebilirsiniz.