Çok Kaynaklı Güvenilir Web Etkinlikleri

André Cipriani Bandarra

Güvenilir Web Etkinlikleri, PWA'nız gibi web uygulaması içeriğinizi özel Sekmelere dayalı bir protokol kullanarak Android uygulamanız oluşturabilirsiniz.

ff-origin gezinmesi

Güvenilir Web Etkinliği, açılan kaynakların Dijital Varlık Bağlantıları:

Kullanıcı doğrulanmış kaynaktan çıktığında Özel Sekme kullanıcı arayüzü gösterilir. Özel sekmesindeki URL çubuğu Sekme, kullanıcılara artık uygulama dışındaki bir alanda gezindiklerini bildirir. kullanıcıya doğrulanmış kaynağa hızlıca dönmesini sağlayan bir X düğmesi sunmak.

Ancak web uygulamalarının birden çok kaynağa yayılan deneyimler oluşturması da sık karşılaşılan bir durumdur. ana deneyimi www.example.com adresinde olan bir alışveriş uygulaması, ödeme aşamasında ise akışı checkout.example.com adresinde barındırılır.

Bu gibi durumlarda, Özel Sekmelerin gösterilmesi istenmeyen bir durumdur. Bunun nedeni, kullanıcının Ancak üst çubuk, kullanıcının uygulamadan ayrıldığını düşünmesini sağlayabileceği için ödeme adımını terk ediyor.

Güvenilir Web Etkinlikleri, geliştiricilerin birden fazla kaynağı doğrulamasına olanak tanır ve kullanıcı sitede kalmaya devam eder. tam ekran olarak görüntüleyebilirsiniz. Ana alanda olduğu gibi, geliştirici de kontrol edebilirsiniz.

Birden fazla kaynak için doğrulamayı ayarlama

Ana kaynakta olduğu gibi doğrulama, Digital Asset Links ve eklenecek her alan adı aracılığıyla gerçekleştirilir doğrulayıcının kendi assetlinks.json dosyasının olması gerekir.

www.example.com ve checkout.example.com için verdiğimiz örnekte:

  • https://www.example.com/.well-known/assetlinks.json
  • https://checkout.example.com/.well-known/assetlinks.json

Her alan aynı Android uygulamasına bağlandığından assetlinks.json dosyaları tamamen aynı görünüyor.

Android uygulamasının paket adının com.example.twa olduğu varsayıldığında her ikisi de assetlink.json dosyaları aşağıdakine benzer bir metin içerir:

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
  "namespace": "android_app",
  "package_name": "com.example",
   "sha256_cert_fingerprints": ["..."]}
}]

Android uygulamasına birden fazla kaynak ekleme

Android uygulamasında asset_statements beyanı, bu beyandaki tüm politikaları doğrulanması gereken kaynaklar:

<string name="asset_statements">
[{
    \"relation\": [\"delegate_permission/common.handle_all_urls\"],
    \"target\": {
        \"namespace\": \"web\",
        \"site\": \"https://www.example.com\"
    }
}],
[{
    \"relation\": [\"delegate_permission/common.handle_all_urls\"],
    \"target\": {
        \"namespace\": \"web\",
        \"site\": \"https://checkout.example.com\"
    }
}],
</string>

LauncherActivity'ye ekstra kaynaklar ekleyin

Varsayılan LauncherActivity'yi kullanma

android-browser-helper destek kitaplığındaki LauncherActivity Android projesini yapılandırarak doğrulanacak birden fazla kaynak eklemenin bir yolunu sunuyor.

İlk olarak res/values/strings.xml dosyasına bir string-array öğesi ekleyin. Oluşturulacak her fazladan URL doğrulayıcı, item alt öğesinin içinde olacaktır:

...
<string-array name="additional_trusted_origins">
    <item>https://www.google.com</item>
</string-array>
...

Daha sonra, meta-data LauncherActivity, AndroidManifest.xml içinde:

...
<activity android:name="com.google.androidbrowserhelper.trusted.LauncherActivity"
    android:label="@string/app_name">


    <meta-data
        android:name="android.support.customtabs.trusted.ADDITIONAL_TRUSTED_ORIGINS"
        android:resource="@array/additional_trusted_origins" />


    ...
</activity>
...

Özel bir LauncherActivity kullanma

Bir Güvenilir Web Etkinliği başlatmak için özel kod kullanırken, yeni kaynak eklemek için Güvenilir Web Etkinliği'ni başlatmak için Intent'i oluştururken setAdditionalTrustedOrigins çağrısı:

public void launcherWithMultipleOrigins(View view) {
  List<String> origins = Arrays.asList(
      "https://checkout.example.com/"
  );


  TrustedWebActivityIntentBuilder builder = new TrustedWebActivityIntentBuilder(LAUNCH_URI)
      .setAdditionalTrustedOrigins(origins);


  new TwaLauncher(this).launch(builder, null, null);
}

Sonuç

Bu adımları uyguladığınızda Güvenilir Web Etkinliği artık birden fazla kaynağı desteklemeye hazır hale gelir. android-browser-helper, çok kaynaklı Güvenilir Web Etkinlikleri için bir örnek uygulamaya sahiptir. Marka mutlaka kontrol edin.

Sorun giderme

Digital Asset Links, birkaç hareketli parçadan oluşur. Uygulama hâlâ Özel Sekmeler çubuğu görüntülenirse yapılandırmada bir sorun olabilir.

Güvenilir Web Etkinliği Hızlı Başlangıç Kılavuzu'nda Digital Asset Link sorunlarında hata ayıklayın.

Dijital Öğe Bağlantılarında hata ayıklamaya yardımcı olan muhteşem Peter's Asset Link Tool da vardır. cihazda yüklü olan uygulamalarda..