مثال: مشاركة بيانات الاعتماد على مواقع إلكترونية متعدّدة وتطبيقات Android متعدّدة

لإعداد مشاركة بيانات الاعتماد بين مواقع إلكترونية وتطبيقات متعددة متوافقة مع Android يجب تنفيذ ما يلي:

  • تعيين نطاق أساسي: اختر عنوان URL واحدًا كنقطة مرجعية أساسية بالنسبة إلى الروابط.
  • إنشاء assetlinks.json ملف:
    • النطاق الأساسي: أنشئ ملف assetlinks.json على نطاقك الأساسي. يسرد جميع النطاقات التي تتم مشاركة بيانات اعتمادها.
    • النطاقات الأخرى: أنشئ ملف assetlinks.json على كل نطاق من النطاقات الأخرى. أكثر، يرتبط كل منها بالنطاق الأساسي.
  • إعداد ربط مواد العرض الرقمية في بيان كل تطبيق: عليك إعداد كل تطبيق من أجل مرة أخرى إلى ملف assetlinks.json في النطاق الأساسي.

في المثال التالي، حددنا example.com كنطاق أساسي، وتصبح جميع النطاقات الأخرى تشارك النطاقات المُدرجة بيانات الاعتماد مع example.com وفي مواقعهم الإلكترونية نفسها

يشارك التطبيقان اللذان يحملان أسماء الحِزم التالية بيانات الاعتماد أيضًا مع جميع مواقع الويب وبينها:

  • com.example.android.myapplication
  • com.example.appname

قبل إعداد مشاركة بيانات الاعتماد، عليك إكمال المتطلبات الأساسية.

للإفصاح عن مشاركة بيانات الاعتماد بين المواقع الإلكترونية وتطبيقات Android التالية:

  1. أنشئ ملف assetlinks.json يتضمّن المحتوى التالي:

    [
      {
        "relation": ["delegate_permission/common.get_login_creds"],
        "target": {
          "namespace": "web",
          "site": "https://example.com"
        }
      },
      {
        "relation": ["delegate_permission/common.get_login_creds"],
        "target": {
          "namespace": "web",
          "site": "https://example.org"
        }
      },
      {
        "relation": ["delegate_permission/common.get_login_creds"],
        "target": {
          "namespace": "web",
          "site": "https://example.net"
        }
      },
      {
        "relation": ["delegate_permission/common.get_login_creds"],
        "target": {
          "namespace": "web",
          "site": "https://myownpersonaldomain.com"
        }
      },
      {
        "relation" : [
          "delegate_permission/common.get_login_creds"
        ],
        "target" : {
          "namespace" : "android_app",
          "package_name" : "com.example.android.myapplication",
          "sha256_cert_fingerprints" : [ "AA:BB:CC:DD:EE:FF:11:22:33:44:55:66:77:88:99:00:AA:BB:CC:DD:EE:FF:11:22:33:44:55:66:77:88:99:00"
          ]
        }
      },
      {
        "relation" : [
          "delegate_permission/common.get_login_creds"
        ],
        "target" : {
          "namespace" : "android_app",
          "package_name" : "com.example.appname",
          "sha256_cert_fingerprints" : [ "00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF"
          ]
        }
      }
    ]
    
  2. يمكنك استضافة ملف روابط التنقل إلى مواد العرض الرقمية بتنسيق JSON في الملف الموقع على النطاق الأساسي، وهي في هذه الحالة: https://example.com/.well-known/assetlinks.json

  3. أنشئ ملف assetlinks.json آخر يتضمّن المحتوى التالي:

    [
      {
        "relation": ["delegate_permission/common.get_login_creds"],
        "target": {
          "namespace": "web",
          "site": "example.com"
        }
      }
    ]
    
  4. يمكنك استضافة نُسخ من ملف روابط التنقل إلى مواد العرض الرقمية بتنسيق JSON هذا في الموقع التالي. على النطاقات الأخرى، وهي في هذه الحالة:

    • example.org/.well-known/assetlinks.json
    • example.net/.well-known/assetlinks.json
    • mypersonaldomain.com/.well-known/assetlinks.json
  5. أضِف السطر التالي إلى كل من ملفي بيانات تطبيقات Android ضمن <application>:

    <meta-data android:name="asset_statements" android:resource="@string/asset_statements"/>
    
  6. إعداد ربط الأصول الرقمية في البيان من خلال إعلان الارتباط في تطبيق Android. إضافة عنصر يحدِّد ملفات assetlinks.json للتحميل. في هذه الحالة:

    <string name="asset_statements" translatable="false">
    [{
      \"include\": \"https://example.com/.well-known/assetlinks.json\"
    }]
    </string>
    

بعد اتّباع هذه الخطوات، يمكنك إعداد بيانات اعتماد سلِسة بنجاح. المشاركة عبر العديد من مواقع الويب وتطبيقات Android.