إعداد نطاق خاص للروابط الديناميكية

يمكنك التحكّم بشكل أكبر في هوية "Dynamic Links" البصرية من خلال استخدام نطاقك الخاص بدلاً من نطاق فرعي في "page.link". باستخدام النطاقات الخاصة، يمكنك إنشاء Dynamic Links مثل الأمثلة التالية:

https://example.com/link-suffix
https://example.com/links/promos/link-suffix
https://links.example.com/link-suffix
https://ex.amp.le/link-suffix

يُطلق على الجزء من عنوان URL الذي يسبق link-suffix اسم بادئة عنوان URL، ويحتوي على نطاق Dynamic Link الخاص بك وبادئة المسار. يجب تقديم بادئة عنوان URL عند إنشاء Dynamic Links.

يتطلّب إعداد نطاق خاص الحصول على إذن "محرِّر" أو "مالك" في مشروعك على Firebase.

استخدام نطاق الويب الخاص بك لـ "Dynamic Links"

يمكنك استخدام النطاق نفسه لـ Dynamic Links وصفحات الويب والروابط العامة وروابط التطبيقات، ولكن في هذه الحالة، عليك التأكّد من أنّ عناوين URL لـ Dynamic Link لا تتعارض مع عناوين URL للويب. عند ضبط Dynamic Links لاستخدام بادئة عنوان URL معيّنة، يتم التعامل مع جميع عناوين URL التي تبدأ بتلك البادئة على أنّها Dynamic Links، لذا لا يمكنك استخدام عناوين URL التي تتضمّن تلك البادئة للإشارة إلى محتوى عادي مستضاف.

على سبيل المثال، إذا أردت إنشاء Dynamic Link للمورد https://example.com/my-resource (صفحة ويب أو رابط عام أو رابط تطبيق)، لا يمكنك استخدام https://example.com/ كبادئة عنوان URL لـ Dynamic Links، لأنّ ذلك سيؤدي إلى التعامل مع https://example.com/my-resource على أنّه Dynamic Link. بدلاً من ذلك، يجب استخدام بادئة عنوان URL مع نطاق مختلف أو بادئة مسار مختلفة.

لذلك، لن يعمل الرابط الطويل التالي Dynamic Links (والروابط القصيرة المكافئة له) على النحو المنشود لأنّ عناوين URL المحدّدة بواسطة المَعلمة link تبدأ ببادئة عنوان URL Dynamic Link، وهي https://example.com/:

 https://example.com/?link=https://example.com/my-resource
 https://example.com/?link=https://example.com/resources/my-resource

ولكن يمكن استخدام عناوين URL الطويلة التالية لـ Dynamic Links (والروابط القصيرة المكافئة)، لأنّ بادئات عناوين URL لا تتعارض مع عناوين URL لـ link:

 https://link.example.com/?link=https://example.com/my-resource
 https://example.com/links/?link=https://example.com/my-resource
 https://ex.amp.le/?link=https://example.com/my-resource

إعداد نطاق خاص في وحدة تحكّم "Firebase"

يمكنك عادةً إعداد نطاق خاص بالكامل في وحدة تحكّم Firebase. لإجراء ذلك، اتّبِع الخطوات التالية:

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

  2. افتح صفحة Dynamic Links في وحدة تحكّم Firebase.

  3. إذا لم يسبق لك استخدام Dynamic Links، انقر على البدء. وإلا، انقر على إضافة بادئة عنوان URL من القائمة المنسدلة.

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

  4. نظام التشغيل iOS فقط: في ملف Info.plist الخاص بمشروع Xcode، أنشئ مفتاحًا باسم FirebaseDynamicLinksCustomDomains واضبطه على بادئات عناوين URL الخاصة بتطبيقك Dynamic Links. على سبيل المثال:

    <key>FirebaseDynamicLinksCustomDomains</key>
    <array>
      <string>https://example.com/link</string>
      <string>https://example.com/promos</string>
    </array>
    

إعداد نطاق خاص يدويًا

في بعض الحالات، مثلاً عندما يكون لديك نطاق خاص تم إعداده لـ Dynamic Links وتريد إضافة نطاق آخر، أو عندما تضيف نطاقًا مرتبطًا بموقع إلكتروني على Hosting، عليك إعداد نطاقك الخاص يدويًا.

ولإجراء ذلك، يُرجى اتّباع الخطوات التالية:

  1. ربط نطاقك بـ "Firebase Hosting" إذا لم يسبق لك ذلك

    يتضمن إعداد نطاقك باستخدام Firebase Hosting إنشاء ملف الإعداد firebase.json في دليل مشروعك على الجهاز.

  2. ثبِّت أحدث إصدار من واجهة سطر الأوامر في Firebase (الإصدار 6.5.0 أو إصدار أحدث).

  3. اضبط موقع Hosting الإلكتروني لـ Dynamic Links في ملف firebase.json الخاص بمشروعك. إذا كان مشروعك يتضمّن مواقع إلكترونية متعددة، تأكَّد من ضبط الموقع الإلكتروني المرتبط بالنطاق الذي تريد استخدامه.

    • اضبط النوع appAssociation على AUTO. باستخدام هذا الإعداد، ينشئ Hosting ملفات assetlinks.json وapple-app-site-association ديناميكيًا عند طلبها.

    • حدِّد بادئات المسار التي تريد استخدامها مع Dynamic Links من خلال ضبط قواعد إعادة الكتابة مع ضبط dynamicLinks على true. يتم توجيه الطلبات إلى هذه المسارات عبر الخادم الوكيل إلى Dynamic Links.

      على عكس القواعد التي تعيد كتابة المسارات إلى عناوين URL، لا يمكن أن تحتوي قواعد إعادة كتابة Dynamic Link على تعبيرات عادية.

      إذا كانت لديك قواعد إعادة كتابة متعددة لموقعك الإلكتروني، يُرجى العِلم أنّ Hosting ينفّذ قاعدة إعادة الكتابة الأولى التي تتطابق مع الطلب.

    على سبيل المثال:

    "hosting": {
      // ...
      "appAssociation": "AUTO",
      "rewrites": [
        {
          "source": "/promos/**",
          "dynamicLinks": true
        },
        {
          "source": "/links/share/**",
          "dynamicLinks": true
        }
      ]
    }
    

    باستخدام الإعدادات أعلاه، يمكنك إنشاء Dynamic Links باستخدام بادئات عناوين URL مثل الأمثلة التالية:

    https://your-domain/promos/link-suffix
    https://your-domain/links/share/link-suffix
    

    إذا كنت تستخدم هذا النطاق لـ Dynamic Links فقط، يمكنك استخدام مسار المصدر /** لإنشاء Dynamic Links بدون بادئة مسار:

    {
      "source": "/**",
      "dynamicLinks": true
    }
    

    باستخدام القاعدة أعلاه، يمكنك إنشاء Dynamic Links مثل المثال التالي:

    https://your-domain/link-suffix

  4. انشر تغييرات إعدادات Hosting:

    firebase deploy --only hosting

    (اختياري) يمكنك التحقّق من محتوى firebase.json المنشور باستخدام Hosting REST API.

  5. نظام التشغيل iOS فقط: في ملف Info.plist الخاص بمشروع Xcode، أنشئ مفتاحًا باسم FirebaseDynamicLinksCustomDomains واضبطه على بادئات عناوين URL الخاصة بتطبيقك Dynamic Links. على سبيل المثال:

    <key>FirebaseDynamicLinksCustomDomains</key>
    <array>
      <string>https://example.com/promos</string>
      <string>https://example.com/links/share</string>
    </array>
    

ترتيب الأولوية لـ "Dynamic Links" و"Hosting"

بالنسبة إلى Dynamic Links، يجب الانتباه بشكل خاص إلى ترتيب أولوية الاستضافة.

  • تأكَّد من أنّ بادئة عنوان URL لـ Dynamic Links لا تتعارض مع إعدادات الاستضافة ذات الأولوية الأعلى (على سبيل المثال، يكون للمحتوى الثابت المستضاف الأولوية دائمًا على عمليات إعادة الكتابة).
  • ضمن السمة rewrites، ستلتزم الاستجابة Hosting بالقاعدة المحدّدة من خلال أول نمط source glob يلتقط المسار المطلوب.

على سبيل المثال، إذا أعددت Dynamic Link لـ your-domain/source-path/link-suffix ولكن لديك أيضًا محتوى ثابت على your-domain/source-path/index.html، تكون الأولوية للمحتوى الثابت. سيظهر للمستخدم النهائي index.html بدلاً من Dynamic Link. وبالمثل، إذا كان لديك محتوى ثابت على your-domain/source-path/link-suffix، سيظهر للمستخدم النهائي المحتوى الثابت بدلاً من Dynamic Link.

إذا أردت استخدام الهوية البصرية نفسها لكل من Dynamic Links وHosting، يمكنك استخدام أحد الخيارات التالية لبادئة عنوان URL في Dynamic Links:

  • اضبط السمة source لتتطابق مع بادئة مسار. على سبيل المثال، إذا كان لديك نطاق خاص باسم example.com، يمكن أن تكون قاعدة إعادة الكتابة كما يلي:

    // Domain is example.com
    "rewrites": [ {
      "source": "/links/**",  // Dynamic Links start with "https://example.com/links/"
      "dynamicLinks": true
    } ]
    
  • يجب إعداد نطاق فرعي لاستخدامه في Dynamic Links، ثم ضبط سمة source لتتطابق مع هذا النطاق الفرعي. على سبيل المثال، إذا كان لديك نطاق فرعي من links.example.com، يمكن أن تكون قاعدة إعادة الكتابة:

    // Domain is links.example.com
    "rewrites": [ {
      "source": "/**",  // Dynamic Links start with "https://links.example.com/"
      "dynamicLinks": true
    } ]