Hızlı Başlangıç Kılavuzu

Peter Conn
Peter Conn

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.

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.