Güvenilir Web Etkinliklerini ayarlamak biraz zor olabilir, özellikle de yapmak istediğiniz şey sadece web sitenizi görüntülemenizi sağlar. Bu kılavuz, Güvenilir Web Etkinlikleri kullanan temel bir proje oluşturmanızı sağlar. ele alacağız.
Bu kılavuzun sonunda:
- Uygulama oluşturmak için BubbleWrap kullanmış olanlar Güvenilir Web Etkinliği kullanan ve doğrulamayı geçen bir işletme.
- İmzalama anahtarlarınızın ne zaman kullanıldığını anlayın.
- Android Uygulamanızın oluşturulduğu imzayı belirleyebilmelisiniz.
- Temel bir Digital Asset Links dosyası oluşturmayı öğ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ü.
- Bağlı ve geliştirme için ayarlanmış bir Android telefon veya emülatör (Aşağıdaki durumlarda USB üzerinden hata ayıklamayı etkinleştirin: fiziksel bir telefon kullanıyorsanız).
- 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 destek yakında sağlanacaktı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 Google Play Store'a bağlanmadan tam ekran bir Tarayıcı Sekmesi herhangi bir tarayıcı kullanıcı arayüzünden görüntülenebilir. Bu özellik, sahip olduğunuz web siteleriyle sınırlıdır. Bu özelliği dijital varlık bağlantıları oluşturun. Bunları daha sonra daha ayrıntılı olarak ele alacağız.
Güvenilir Web Etkinliği başlattığınızda tarayıcı, Dijital Varlık Bağlantıları Buna doğrulama adı verilir. Doğrulama başarısız olursa tarayıcı, web sitenizi Özel Sekme.
BubbleWrap'ı yükleme ve yapılandırma
Bubblepack, bir kitaplık grubu ve Geliştiricilerin Progresif Web Uygulamaları oluşturmasına, derlemesine ve çalıştırmasına yardımcı olan Node.js için satır aracı (KSA) güvenilir Web Etkinliği'ni kullanır.
CLI, aşağıdaki komutla yüklenebilir:
npm i -g @bubblewrap/cli
Ortamı Ayarlama
BubbleWrap'ı ilk kez çalıştırdığınızda, uygulama paketlerinin otomatik olarak indirilmesini ve yüklenmesini bağımlılıkları ortaya koyabilir. Aracın bu işlemi yapmasına izin vermenizi öneririz. Bu şekilde, ve bağımlılıkların doğru yapılandırıldığından emin olmalısınız. Aşağıdaki özelliklere sahip bir baloncuk mevcut Java Geliştirme Kiti (JDK) veya Android komut satırı araçları kurulumunu gerçekleştirin.
Projeyi başlatma ve derleme
PWA'yı saran bir Android projesinin başlatılması için init komutu çalıştırılır:
bubblewrap init --manifest=https://my-twa.com/manifest.json
Baloncuğu, Web Manifest'ini okur, geliştiricilerden Android projesinde kullanılacak değerleri onaylamalarını ve projeyi bahsedeceğim. Proje oluşturulduktan sonra aşağıdaki komutu çalıştırarak bir APK oluşturun:
bubblewrap build
Çalıştır
Derleme adımı app-release-signed.apk
adlı bir dosya oluşturur. Bu dosya,
test etmek veya yayınlamak üzere Play Store'a yüklemek için bir geliştirme cihazı kullanın.
BubbleWrap uygulamayı yerel bir cihaza yüklemek ve test etmek için bir komut sağlar. Şununla bilgisayara bağlı geliştirme cihazı:
bubblewrap install
Alternatif olarak, adb aracı kullanılır.
adb install app-release-signed.apk
Uygulama artık cihaz başlatıcıda kullanılabilir olmalıdır. Uygulamayı açarken Web sitenizin Güvenilir Web Etkinliği olarak değil, Özel Sekme olarak açıldığını fark ederseniz bu çünkü Digital Asset Links doğrulamamızı henüz ayarlamadık, ancak önce...
BubbleWrap için Grafik Kullanıcı Arayüzü (GUI) alternatifleri
PWA Builder, BubbleWrap kullanan bir GUI arayüzü sağlar kitaplığını kullanımınıza sunar. Nasıl yapacağınızla ilgili daha fazla PWA'nızı açan bir Android uygulaması oluşturmak için PWA Builder'ı kullanın bu blog yayınına göz atın.
İmzalama anahtarlarıyla ilgili not
Digital Asset Links, bir APK'nın imzalandığı anahtarı dikkate alır. Doğrulamanın başarısız olmasının yaygın nedeni, yanlış imza kullanmaktı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.) Bubblepack uygulamayı oluşturduğunda, init
adımında anahtar kurulumuna sahip bir APK oluşturulur. Bununla birlikte, 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. Anahtarları imzalama ve bunların BubbleWrap ve Google Play ile ilişkisi hakkında daha fazla bilgi edinin.
Öğe bağlantısı dosyanızı oluşturma
Dijital Öğe Bağlantıları, temel olarak web sitenizde bulunan ve uygulamanıza ve web sitenize yönlendiren meta veriler ekleyebilirsiniz.
Uygulamanızın tarayıcı tarafından doğru şekilde doğrulanabilmesi için assetlinks.json
dosyanızı oluşturduktan sonra bu dosyayı kök yerine .well-known/assetlinks.json
adresindeki 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 Güvenilir Web Etkinlikleri başlatılır. Bu başarısız olursa, yüklü herhangi bir tarayıcı Güvenilir Web Etkinlikleri'ni destekliyorsa bu tarayıcı seçilir. Son olarak, varsayılan davranış Özel Sekmeler moduna geri dönmektir.
Yani Güvenilir Web Etkinlikleri ile ilgili bir şey için hata ayıklıyorsanız olduğunuzu düşündüğünüz tarayıcıyı kullandığınızdan emin olun. 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 izlediyseniz, sorunsuz bir şekilde çalışan bir Güvenilir Web Etkinliğinizin olduğunu ve bilgi sahibi olmanız gerekir. Cevabınız hayırsa web geliştiricileri için Android kavramlarına göz atın veya ilgili GitHub sorununu bildirin. bu dokümanlara göz atın.
Sonraki adımlarınızda, ilk olarak uygulamanız için bir simge oluşturma. Ardından uygulamanızı Play Store'a dağıtmayı düşünebilirsiniz.