تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

نقل البيانات من "الروابط الديناميكية" إلى "روابط التطبيقات" و"الروابط العامة"

يركّز دليل نقل البيانات هذا على استخدام روابط التطبيقات والروابط العامة واستخدام ميزة "استضافة Firebase" بشكلٍ اختياري لاستضافة ملفات الربط بموقع التطبيق الإلكتروني.

تحل عملية نقل البيانات هذه محل ميزات "روابط Firebase الديناميكية" التالية:

الميزة	روابط Firebase الديناميكية	روابط التطبيقات / الروابط العامة
توجيه المستخدمين إلى المتجر الصحيح لأجهزتهم من خلال نقرة واحدة على رابط		^★
عليك توفير تجربة تتيح للمستخدمين مواصلة تنزيل تطبيقك وتثبيته باستخدام رابط مؤجَّل لصفحة معيّنة في التطبيق.		^★
توفير تجربة سياقية للمستخدمين باستخدام محتوى مرتبط بصفحة معيّنة في تطبيقك (عندما يكون مثبّتًا على الجهاز)
تقديم بيانات إحصائية ذات صلة بأحداث النقر على الرابط الديناميكية
توفير إمكانية إنشاء عناوين URL للروابط القصيرة

ملاحظة: توفّر إعلانات البانر الذكية للتطبيقات على نظام التشغيل iOS وسيلة بديلة لعرض بانر قابل للنقر يوجِّه المستخدمين إلى App Store في حال لم يكن التطبيق مثبّتًا، أو إلى التطبيق إذا كان مثبّتًا على أجهزتهم.

توفّر إعلانات البانر للتطبيقات الذكية أيضًا إمكانية تمرير المَعلمات بعد أن ينقر المستخدم على رابط بانر التطبيق الذكي، ما قد يوفّر طريقة لمنح المستخدمين إمكانية مواصلة تجربة المستخدِم عند الانتقال إلى تطبيقك بعد النقر على بانر التطبيق الذكي.

إذا كنت لا تزال بحاجة إلى ميزات أخرى غير متوافقة مع هذا الدليل لنقل البيانات، يمكنك الاطّلاع على سيناريوهات نقل البيانات الأخرى في مستندات الأسئلة الشائعة حول إيقاف الروابط الديناميكية نهائيًا.

افترض أن لديك رابطًا ديناميكيًا في Firebase يبدو على النحو التالي:

مثال على الرابط الديناميكي
اسم الرابط	مرحبًا بك في Example.com
رابط لصفحة في التطبيق	`https://example.web.app/welcome`
تطبيق Android	`com.example.android`
تطبيق Apple	`com.example.ios`
رابط ديناميكي طويل	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
رابط ديناميكي قصير	`https://example.page.link/m9Mm`

الهدف من دليل نقل البيانات هذا هو استبدال "روابط Firebase الديناميكية" على النحو التالي:

https://example.page.link/m9Mm

باستخدام روابط لصفحات في التطبيق أو رابط عام على النحو التالي:

https://your-project-domain.web.app/welcome

تجدر الإشارة إلى أنّ رابط التطبيق / الرابط العام لصفحة معيّنة في التطبيق سيوفّر ما يلي للمستخدمين:

هو رابط لصفحة في التطبيق يمكن للمستخدم النقر عليه لفتح تطبيقك بعد تثبيته.
متابعة لتجربة المستخدم في تنقلهم إلى جزء معين من تطبيقك عند فتحه

ومع ذلك، لن يوفر رابط التطبيق / الرابط العام لصفحة معيّنة في التطبيق السلوكيات التالية للمستخدمين (وهو ما كانت تفعله روابط Firebase الديناميكية في السابق):

نقل المستخدمين إلى المتجر الصحيح على أجهزتهم لتنزيل تطبيقك وتثبيته
توفير استمرار لتجربة المستخدم بعد تنزيل التطبيق وتثبيته وفتحه لأول مرة

لاحظ الاختلافات في سلوك ووظائف روابط التطبيقات / الروابط العامة هذه مقارنةً بروابط Firebase الديناميكية الواردة في الجدول أعلاه.

قبل البدء

تستخدم "روابط Firebase الديناميكية" روابط التطبيقات (على نظام التشغيل Android) و"الروابط العامة" (على نظام التشغيل iOS) في تنفيذها الأساسي لتوفير وظيفة الربط بصفحة معيّنة بعد تثبيت تطبيقك.

سيرشدك هذا الدليل إلى طريقة إنشاء "روابط التطبيقات" و"الروابط العامة" الخاصة بك باستخدام "استضافة Firebase" لاستبدال هذا الجزء من الوظيفة التي توفّرها "روابط Firebase الديناميكية" أثناء نقل "روابط Firebase الديناميكية" إلى الحل الجديد لنقل "روابط التطبيقات" أو "الروابط العامة".

ستحتاج إلى المعلومات التالية لإكمال عملية النقل:

روابط Firebase الديناميكية التي تنوي نقلها
مَعلمات عناوين URL لرابط صفحة معيّنة في التطبيق والمضمّنة في الروابط الديناميكية
النطاق الذي تخطط لاستخدامه لاستبدال نطاق "روابط Firebase الديناميكية" السابق (إن أمكن)

يمكنك استخدام دليل تصدير البيانات الوصفية للروابط الديناميكية لتصدير البيانات الوصفية الحالية للروابط والحصول على المعلومات الواردة أعلاه.

نظرة عامة على خطوات نقل البيانات

وفِّر نطاقًا جديدًا (إذا لم يكن لديك نطاق تريد استخدامه) لاستضافة ملفات ضبط "رابط التطبيق" أو "الرابط العام" باستخدام "استضافة Firebase".
أنشئ ملفات إعداد رابط التطبيق / الرابط العام واستضِفها على نطاق الاستضافة.
إنشاء روابط تطبيقات أو روابط عامة جديدة تتطابق مع مخطط روابط الصفحات في التطبيق المستخدمة في "روابط Firebase الديناميكية"
حدِّث تطبيقات Android / iOS ورمز التطبيق لتلقّي روابط لمواضع معيّنة.
اختبار عمليات دمج "روابط التطبيقات" أو "الروابط العامة"
استبدل "روابط Firebase الديناميكية" المنشورة أو المشتركة بروابط التطبيقات والروابط العامة.

ستكون الخطوة الأولى مشتركة في كل من تدفقات نقل بيانات روابط التطبيقات أو الروابط العامة. سيختلف الجزء المتبقي حسب النظام الأساسي، لذا انتقل إلى قسم الدليل أدناه بناءً على النظام الأساسي الذي تريد نقله أولاً.

خطوات نقل بيانات ميزة Android App Links
خطوات نقل بيانات ميزة "الروابط العامة" على نظام التشغيل iOS

توفير نطاق جديد لاستضافة ملفات ضبط رابط التطبيق / الرابط العام باستخدام استضافة Firebase

اختيار نطاق

الخطوة الأولى هي اختيار النطاق الذي تريد استخدامه لـ "روابط التطبيق" أو "الروابط العامة". وسيكون هذا هو النطاق الذي سيتم استخدامه للروابط الجديدة التي ستشاركها مع المستخدمين.

في حال استخدام استضافة Firebase، يتم تلقائيًا توفير المتطلبات اللازمة للنطاقات الفرعية للمشاريع بالتنسيق your-project-domain.web.app أو your-project-domain.firebaseapp.com بدون أي تكلفة. يمكنك اختياريًا استخدام نطاق خاص مع "استضافة Firebase" أو بدونها لاستضافة ملفات إعداد "رابط التطبيق" / "الرابط العام" أيضًا.

إعداد استضافة Firebase

بعد ذلك، ستحتاج إلى إعداد مثيل استضافة Firebase وضبطه.

عند الانتهاء من إعداد مثيل استضافة Firebase، سيكون لديك نطاق مشابه لـ your-project-domain.web.app أو نطاق خاص إذا كنت تفضّل ذلك.

خطوات نقل بيانات ميزة Android App Links

إنشاء ملفات إعداد "رابط التطبيق" واستضافتها على نطاق الاستضافة الجديد

لاستخدام "روابط التطبيقات"، يجب استضافة ملف إعداد يساعد في إنشاء ربط آمن بين النطاق المستخدَم في الروابط وتطبيقك. بالنسبة إلى "روابط التطبيق"، هذا هو ملف assetlinks.json.

خطوات إنشاء ملف assetlinks.json واستضافتها

يسمح لنا ملف assetlinks.json بتقديم قائمة بالتطبيقات المعتمَدة التي يمكنها معالجة محتوى نطاق الويب الذي سنستخدمه لـ "روابط التطبيق" (App Links.) ويجب أن يكون ملف assetlinks.json نفسه مستضافًا في جذر نطاق الويب ضمن المسار: /.well-known.

اتّبِع الخطوات أدناه لإكمال هذه الإعدادات:

أنشئ المجلد .well-known ضمن المجلد العلني في الدليل الجذر لاستضافة Firebase.
أنشئ ملفًا باسم "assetlinks.json" ضمن المجلد ".well-known".
انسخ المحتوى التالي إلى ملف assetlinks.json، مع مراعاة معنى كل حقل أدناه:
```
[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.android",
    "sha256_cert_fingerprints":
      ["01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF"]
  }
}]
```
- namespace - يشير إلى اسم التطبيق الذي تريد تقديمه
- package_name: يشير إلى applicationId الذي تم تعريفه في ملف build.gradle الخاص بالتطبيق.
- sha256_cert_fingerprints: يشير إلى الملف المرجعي SHA256 لملف تخزين المفاتيح الذي تستخدمه لتوقيع التطبيق.
يمكنك استخدام ملف debug.keystore الذي يستخدمه "استوديو Android" لإنشاء سجلّ sha256_cert_fingerprints لأغراض تصحيح الأخطاء. يمكنك العثور على الملف في /Users/<username>/.android/debug.keystore على نظامي التشغيل Mac وLinux وC:\Users\<username>\.android\debug.keystore على Windows.

ومن ملف تخزين المفاتيح هذا، يمكنك جلب قيمة SHA256 باستخدام أداة keytool.

ارجع إلى هذا القسم من وثائق روابط التطبيقات للحصول على مزيد من التعليمات حول إكمال هذه الخطوة.

يمكنك بدلاً من ذلك استخدام مساعد روابط التطبيقات في "استوديو Android" لإنشاء محتوى ملف assetlinks.json وضبط تطبيقك للتعامل مع "روابط التطبيق".

عدِّل ملف firebase.json لفهرسة الملف لاستضافةه.

"headers": [
  {
    "source": "/.well-known/assetlinks.json",
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ]
  }
]

الآن بعد أن أصبح ملف assetlinks.json مفعّلاً، شغِّل firebase deploy لاستضافة التغييرات.

يُرجى العلم أنّه يجب تثبيت واجهة سطر الأوامر في Firebase لتنفيذ أمر التفعيل أعلاه.
```
firebase deploy --only hosting
```
يمكنك إثبات ملكية ملف assetlinks.json من خلال الانتقال إلى https://your-project-domain.web.app/.well-known/assetlinks.json.

إنشاء روابط تطبيقات جديدة تتطابق مع مخطط روابط الصفحات في التطبيق المستخدَم في "روابط Firebase الديناميكية"

في هذه الخطوة، ستُعيد إنشاء الروابط لصفحات في التطبيق من "روابط Firebase الديناميكية" باستخدام عناوين URL العادية لروابط صفحات التطبيق وتتطابق مع النطاق الجديد الذي أنشأته لروابط تطبيقاتك.

على سبيل المثال، لنفترض أنّ لديك رابط Firebase الديناميكي التالي:

مثال على الرابط الديناميكي
اسم الرابط	مرحبًا بك في Example.com
رابط لصفحة في التطبيق	`https://example.web.app/welcome`
تطبيق Android	`com.example.android`
تطبيق Apple	`com.example.ios`
رابط ديناميكي طويل	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
رابط ديناميكي قصير	`https://example.page.link/m9Mm`

في هذه الحالة، يمكنك استخراج معلمة رابط لصفحة في التطبيق، أي: https://example.web.app/welcome وستستخدم الآن هذه المعلمة كمعلمة رابط التطبيق لتطبيقك.

ملاحظة: عند إنشاء رابط Firebase الديناميكي لأول مرة، ربما تكون قد أنشأت مَعلمة رابط لصفحة معيّنة تستخدم نطاقًا لا تملكه (مثل example.com/welcome). لقد دعمت "روابط Firebase الديناميكية" ذلك، ولكن في عملية النقل هذه، يجب تغيير أي روابط لصفحات معيّنة تخطط لاستخدامها، وذلك لاستخدام النطاق الذي تملكه والذي تم إعداده مسبقًا من خلال "استضافة Firebase". إذا سبق لك استخدام نطاق تملكه لمَعلمات عناوين URL لرابط صفحة معيّنة في التطبيق المستخدمة في "روابط Firebase الديناميكية"، قد يوفّر لك ذلك الكثير من الوقت، وقد يكون تم إعداد تطبيقك مسبقًا للتعامل مع روابط التطبيقات الواردة التي ستحتاج إلى إنشائها.

ستحتاج إلى تكرار هذه العملية لكل رابط ديناميكي في Firebase تريد نقله إلى استخدام روابط التطبيقات / الروابط العامة، وتكرار مخطط الربط لموضع معيّن الذي استخدمته.

على سبيل المثال، يُرجى الاطّلاع على المجموعة التالية من الروابط القصيرة ضمن "روابط Firebase الديناميكية" ومَعلمات الروابط لصفحات في التطبيق وقيم الروابط لصفحات معيّنة التي تم نقلها:

رابط مختصر	مَعلمة رابط لصفحة معيّنة	رابط لصفحة في التطبيق تم نقله
yourapp.page.link/welcome	https://example.com/welcome	yourapp.web.app/welcome
yourapp.page.link/c7sn	https://example.com/main/?p=23&t=1	yourapp.web.app/main/?p=23&t=1
yourapp.page.link/social	https://example.com/friendinvite/?add=1	yourapp.web.app/friendinvite/?add=1

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

تحديث تطبيق Android ورمز التطبيق لتلقّي روابط لمواضع معيّنة

الخطوة التالية بعد اختيار نطاق واختيار مخطط الربط لموضع معيّن ونقل "روابط Firebase الديناميكية إلى روابط التطبيقات" هي تحديث تطبيق Android ورمز التطبيق لتلقّي الروابط الجديدة لصفحات معيّنة في التطبيق.

ننصحك باتّباع المستندات الكاملة حول "روابط التطبيقات" هنا أو بدلاً من ذلك دليل "استوديو Android" حول ضبط تطبيقك للتعامل مع الروابط المؤدية إلى صفحات في التطبيق، ولكن تتضمّن الخطوات الرئيسية ما يلي:

تحديد الأنشطة التي يجب أن تعالج الروابط لصفحات معيّنة ذات الصلة
إضافة فلتر Intent لتلك الأنشطة في ملف AndroidManifest.xml
تلقي الرابط لموضع معيّن في رمز تطبيق أنشطتك

لنفترض أنك أردت استخدام MainActivity لمعالجة بعض الروابط المؤدية إلى صفحات في تطبيقك. لإجراء ذلك، عليك إضافة فلتر Intent التالي إلى MainActivity في ملف AndroidManifest.xml:

<activity android:name=".MainActivity"
   android:exported="true">
   <intent-filter>
       <action android:name="android.intent.action.MAIN" />
       <category android:name="android.intent.category.LAUNCHER" />
   </intent-filter>
   <intent-filter android:autoVerify="true">
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE" />
       <data android:host="example.web.app" android:scheme="http"
           android:pathPrefix="/welcome" />
       <data android:host="example.web.app" android:scheme="https"
           android:pathPrefix="/welcome" />
   </intent-filter>
</activity>

في هذه الخطوة، تُحدّد أن MainActivity هي وجهة معالجة الروابط لصفحات في التطبيق من النطاق wxample.web.app وتتضمّن بادئة المسار /welcome. تجدر الإشارة إلى أنّك ستحتاج أيضًا إلى تحديد السمة android:autoVerify="true" التي تسمح لك بضبط تطبيقك كالمعالج التلقائي لهذا النوع المحدّد من الروابط.

وأخيرًا، سيكون عليك إضافة الرمز في MainActivity لاسترداد بيانات الروابط المؤدية إلى صفحات في التطبيق واستخدامها لتحسين تجربة الروابط المؤدية إلى صفحات في تطبيقك. هذا الأمر يشبه المنطق الذي سبق لك ترميزه في تطبيقك عند الدمج مع "روابط Firebase الديناميكية".

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)

  val  data: Uri? = intent?.data

  val toast = Toast.makeText(this, data, duration)
  toast.show()
}

اختبار روابط التطبيقات

يمكنك اختبار "روابط التطبيق" التي أنشأتها للتو، إما من خلال تشغيل تطبيقك على جهاز فعلي أو في محاكي Android.

عليك إنشاء رابط قابل للنقر باستخدام النطاق الذي تم ضبطه في "روابط التطبيق" ثم النقر على هذا الرابط للتأكّد من أنّه يفتح في تطبيقك وينقلك إلى النشاط المقصود.

بدلاً من ذلك، يمكنك أيضًا اختبار دمج "روابط التطبيق" باستخدام مساعد روابط التطبيقات في "استوديو Android"، أو استخدام الأمر التالي لعنوان URL لرابط التطبيق الذي تم ضبطه للتأكّد من تشغيل النشاط المطابق بشكل صحيح:

adb shell am start -a android.intent.action.VIEW -d <your_deep_link_url>

استبدال روابط Firebase الديناميكية المنشورة أو المشتركة بروابط التطبيقات

ستتمثل الخطوة الأخيرة لعملية نقل البيانات في استبدال "روابط Firebase الديناميكية" المنشورة أو التي تمت مشاركتها بـ "روابط التطبيق" كلما أمكن ذلك، ومواصلة استخدام "روابط التطبيقات" من الآن فصاعدًا.

سيختلف إكمال هذه الخطوة بناءً على مكان وكيفية نشر "روابط Firebase الديناميكية"، ولكن لمساعدتك في تتبُّع الروابط المتوفّرة، يمكنك تصدير البيانات الوصفية الحالية لرابط Firebase الديناميكي. اطّلِع على دليل البيانات الوصفية الخاصة بتصدير الروابط الديناميكية.

خطوات نقل بيانات الروابط العامة على نظام التشغيل iOS

إنشاء ملفات إعداد الروابط العامة واستضافتها على نطاق الاستضافة الجديد

لاستخدام ميزة "الروابط العامة"، يجب استضافة ملف إعداد يساعد في إنشاء ربط آمن بين النطاق المستخدَم في الروابط وتطبيقك. وبالنسبة إلى "الروابط العامة"، يكون هذا الملف هو apple-app-site-association (المعروف أيضًا بملف AASA).

خطوات إنشاء واستضافة ملف الربط بتطبيق apple-app-site-association

يتيح لنا ملف AASA تقديم قائمة بالتطبيقات المعتمَدة التي يمكنها معالجة محتوى نطاق الويب الذي سنستخدمه للروابط العامة. يجب أن يكون ملف AASA نفسه مستضافًا في جذر نطاق الويب ضمن المسار: /.well-known.

اتّبِع الخطوات أدناه لإكمال هذه الإعدادات:

أنشئ المجلد ".well-known" ضمن المجلد العام في الدليل الجذري لاستضافة Firebase.
أنشِئ ملفًا باسم "apple-app-site-association" ضمن مجلد "well-known".
انسخ المحتوى التالي إلى ملف ربط موقع apple-app-site، مع ملاحظة معنى كل حقل أدناه:
```
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appId": "$TEAM_ID.com.firebase.UniversalLinks",
        "paths": [
          "NOT /_/*",
          "/*"
        ]
      }
    ]
  }
}
```
- $team_ID.BundleId - اسم التطبيق المؤهل بالكامل والمصرح له بمعالجة الروابط

عدِّل ملف firebase.json لفهرسة الملف لاستضافةه.

"headers": [
  {
    "source": "/.well-known/apple-app-site-association",
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ]
  }
]

الآن بعد أن أصبح لدينا ملف AASA، يمكنك نشر Firebase لاستضافة التغييرات.
يمكنك إثبات صحة ملف AASA من خلال الانتقال إلى https://your-project-domain.web.app/.well-known/app-app-site-association.

إنشاء "روابط عامة" جديدة تتطابق مع مخطط الروابط لصفحات في التطبيق المستخدَم في "روابط Firebase الديناميكية"

في هذه الخطوة، ستُعيد إنشاء الروابط لصفحات في التطبيق من "روابط Firebase الديناميكية" باستخدام عناوين URL العادية لروابط صفحات التطبيق التي تتطابق مع النطاق الجديد الذي أنشأته للروابط العامة.

على سبيل المثال، لنفترض أنّ لديك رابط Firebase الديناميكي التالي:

مثال على الرابط الديناميكي
اسم الرابط	مرحبًا بك في Example.com
رابط لصفحة في التطبيق	`https://example.web.app/welcome`
تطبيق Android	`com.example.android`
تطبيق Apple	`com.example.ios`
رابط ديناميكي طويل	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
رابط ديناميكي قصير	`https://example.page.link/m9Mm`

في هذه الحالة، يمكنك استخراج معلمة الرابط لصفحة في التطبيق، مثل https://example.web.app/welcome وستستخدمها الآن كمعلمة الرابط العام لتطبيقك.

ملاحظة: عند إنشاء رابط Firebase الديناميكي لأول مرة، ربما تكون قد أنشأت مَعلمة رابط لصفحة معيّنة تستخدم نطاقًا لا تملكه (مثل example.com/welcome). لقد دعمت "روابط Firebase الديناميكية" ذلك، ولكن في عملية النقل هذه، يجب تغيير أي روابط لصفحات معيّنة تخطط لاستخدامها، وذلك لاستخدام النطاق الذي تملكه والذي تم إعداده مسبقًا من خلال "استضافة Firebase". وإذا سبق لك استخدام نطاق تملكه لمَعلمات عناوين URL لرابط صفحة معيّنة في التطبيق المستخدمة في "روابط Firebase الديناميكية"، قد يوفّر لك ذلك الكثير من الوقت، وقد يكون تم إعداد تطبيقك مسبقًا للتعامل مع الروابط العامة الواردة التي ستحتاج إلى إنشائها.

رابط مختصر	مَعلمة رابط لصفحة معيّنة	رابط لصفحة في التطبيق تم نقله
yourapp.page.link/welcome	https://example.com/welcome	yourapp.web.app/welcome
yourapp.page.link/c7sn	https://example.com/main/?p=23&t=1	yourapp.web.app/main/?p=23&t=1
yourapp.page.link/social	https://example.com/friendinvite/?add=1	yourapp.web.app/friendinvite/?add=1

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

تحديث تطبيق iOS ورمز التطبيق لتلقّي روابط لصفحات في التطبيق

الخطوة التالية بعد اختيار نطاق واختيار مخطط الربط لموضع معيّن ونقل "روابط Firebase الديناميكية" إلى "الروابط العامة" هي تحديث تطبيق iOS ورمز التطبيق لتلقّي الروابط الجديدة لصفحات معيّنة.

نقترح عليك اتّباع مستندات "الروابط العامة" الكاملة هنا عند ضبط تطبيقك للتعامل مع الروابط المؤدية إلى صفحات في التطبيق، ولكن تشمل الخطوات الرئيسية ما يلي:

حدِّث تهيئة مشروعك لتمكين تطبيقك من التعامل مع الروابط لمواضع معيّنة من النطاق الذي تم إنشاؤه حديثًا
تلقّي رابط الصفحة في رمز تطبيقك

لتعديل إعدادات المشروع للسماح لتطبيقك بمعالجة الروابط المؤدية إلى صفحات في التطبيق، عليك إضافة نطاق مرتبط آخر إلى مشروعك في xCode للنطاق الذي تخطط الآن لاستخدامه لاستضافة ملف apple-app-site- linked إرشادي.

ويمكن إجراء ذلك من خلال ما يلي:

جارٍ فتح Xcode
اختيار مشروعك في أداة التنقّل في الملفات
الانتقال إلى علامة التبويب التوقيع والإمكانات في إعدادات المشروع
الانتقال للأسفل إلى قسم "النطاقات المرتبطة"
بالنقر على الزر + لإضافة النطاق الإضافي إلى مشروعك بالتنسيق "applinks:".

أخيرًا، تحتاج إلى تحديث رمز التطبيق لتتمكن من تلقي الروابط الواردة لصفحات في التطبيق.

لتنفيذ هذا الإجراء، يجب أولاً تحديث ملف AppDelegate.swift للرد على رابط عالمي من خلال إضافة الرمز التالي:

func application(_ application: UIApplication, continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
  AppDelegate.showReceivedUrl(userActivity: userActivity);
  return true
}

static func showReceivedUrl(userActivity: NSUserActivity) {
  if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
    let url = userActivity.webpageURL!
    print(url.absoluteString)
}

يلغي الرمز البرمجي أعلاه طريقة استدعاء الرابط العام ويسجّل عنوان URL لرابط الصفحة في التطبيق إن وجد.

وسنستدعي الآن طريقة showReceivedUrl نفسها من فئة SceneDelegate أيضًا إذا كان التطبيق مفتوحًا بالفعل في الوقت الذي نقر فيه المستخدم على الرابط العام، سيتم استدعاؤه لمعاودة الاتصال للرابط العام داخل SceneDelegate.

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  AppDelegate.showReceivedUrl(userActivity: userActivity)
}

اختبار ميزة "الروابط العامة"

يمكنك اختبار "الروابط العامة" التي أنشأتها للتو، إما من خلال تشغيل تطبيقك على جهاز مادي أو محاكي.

عليك إنشاء رابط قابل للنقر باستخدام النطاق الذي تم إعداده للروابط العامة، ثم النقر على هذا الرابط لضمان فتحه في تطبيقك والانتقال إلى الشاشة المطلوبة في تطبيقك.

التوافق مع إعلانات البانر الذكية للتطبيقات

ننصحك بشدة باستخدام بانر التطبيقات الذكية كطريقة لتزويد المستخدمين بتجربة مماثلة لميزة "الروابط الديناميكية من Firebase".

باستخدام إعلانات البانر للتطبيقات الذكية، سيتم نقل المستخدمين إلى App Store لبطاقة بيانات تطبيقك إذا لم يكن تطبيقك مثبّتًا على أجهزتهم. يمكنك أيضًا اختياريًا ضبط معلمة لتمريرها إلى تطبيقك بعد تنزيله وتثبيته لتزويد المستخدمين بمتابعة رحلتهم. إذا كان تطبيقك مُثبَّتًا من قبل، سيتم تمرير المَعلمة إلى تطبيقك للمساعدة في توجيه المستخدم إلى المحتوى المناسب استنادًا إلى "بانر التطبيق الذكي" الذي نقر عليه.

استبدال روابط Firebase الديناميكية المنشورة أو المشتركة بروابط التطبيقات

ستتمثل الخطوة الأخيرة في عملية النقل في استبدال "روابط Firebase الديناميكية" المنشورة أو المُشارَكة بالروابط العامة متى أمكن، ومواصلة استخدام "الروابط العامة" من الآن فصاعدًا.

يختلف إكمال هذه الخطوة استنادًا إلى مكان وطريقة نشر "روابط Firebase الديناميكية".

لمساعدتك في تتبُّع "روابط Firebase الديناميكية" الحالية المراد نقلها، سننشر دليلاً حول طريقة تصدير البيانات الوصفية للروابط القصيرة من "روابط Firebase الديناميكية". يُرجى مراجعة مستند الأسئلة الشائعة حول إيقاف الروابط الديناميكية نهائيًا لمزيد من المعلومات.