راه‌اندازی دامنه سفارشی برای «پیوندهای پویا»

بااستفاده از دامنه خودتان به‌جای زیردامنه page.link، می‌توانید کنترل بیشتری بر نمانام‌سازی Dynamic Links داشته باشید. با دامنه‌های سفارشی، می‌توانید 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

بخشی از نشانی وب که قبل‌از link-suffix قرار دارد پیشوند نشانی وب نامیده می‌شود، و هم حاوی دامنه Dynamic Link سفارشی شما است و هم پیشوند مسیر. هنگام ایجاد Dynamic Links باید پیشوند نشانی وب ارائه دهید.

راه‌اندازی دامنه سفارشی به اجازه «ویرایشگر» یا «مالک» در پروژه Firebase شما نیاز دارد.

از دامنه وب شما برای Dynamic Links استفاده می‌شود

می‌توانید از دامنه یکسانی برای Dynamic Links و صفحه‌های وب، «پیوندهای جامع»، و «پیوندهای برنامه» استفاده کنید، اما اگر این کار را انجام دهید، باید مراقب باشید که نشانی‌های وب Dynamic Link با نشانی‌های وب شما تداخل نداشته باشند. وقتی Dynamic Links را برای استفاده از پیشوند نشانی وب خاصی پیکربندی می‌کنید، همه نشانی‌های وب که با آن پیشوند شروع می‌شوند به‌عنوان Dynamic Links درنظر گرفته می‌شوند، بنابراین نمی‌توانید از نشانی‌های وب با آن پیشوند برای اشاره به محتوای میزبانی‌شده معمولی استفاده کنید.

برای مثال، اگر می‌خواهید Dynamic Link برای منبع https://example.com/my-resource (صفحه وب، «پیوند جامع»، یا «پیوند برنامه») ایجاد کنید، نمی‌توانید از https://example.com/ به‌عنوان پیشوند نشانی وب Dynamic Links استفاده کنید، زیرا انجام این کار باعث می‌شود https://example.com/my-resource به‌عنوان Dynamic Link درنظر گرفته شود. درعوض، باید از پیشوند نشانی وب با دامنه متفاوت یا پیشوند مسیر متفاوت استفاده کنید.

بنابراین، Dynamic Links طولانی زیر (و پیوندهای کوتاه معادل آن) طبق انتظار کار نخواهد کرد زیرا نشانی‌های وب مشخص‌شده توسط پارامتر link با پیشوند نشانی وب Dynamic Link،‏ https://example.com/ شروع می‌شوند:

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

اما Dynamic Links طولانی زیر (و پیوندهای کوتاه معادل) می‌توانند کار کنند، زیرا پیشوندهای نشانی وب با نشانی‌های وب 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 استفاده نکرده‌اید، روی شروع به کار کلیک کنید. درغیراین‌صورت، روی افزودن پیشوند نشانی وب در منوِ کرکره‌ای کلیک کنید.

    سپس، دستیار راه‌اندازی را تکمیل کنید و دامنه و پیشوند مسیر موردنظرتان را برای استفاده درصورت درخواست مشخص کنید.

  4. فقط iOS: در فایل Info.plist پروژه Xcode، کلیدی به‌نام FirebaseDynamicLinksCustomDomains ایجاد کنید و آن را روی پیشوندهای نشانی وب 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 CLI به‌روزرسانی کنید (نسخه ۶.۵.۰ یا جدیدتر).

  3. سایت Hosting را برای Dynamic Links در فایل firebase.json پروژه‌تان پیکربندی کنید. اگر پروژه‌تان چند سایت دارد، حتماً سایت متصل به دامنه‌ای را که می‌خواهید استفاده کنید پیکربندی کنید.

    • appAssociation را روی AUTO تنظیم کنید. با این تنظیم، Hosting فایل‌های assetlinks.json و apple-app-site-association را هنگام درخواست به‌طور پویا تولید می‌کند.

    • پیشوندهای مسیری را که می‌خواهید برای Dynamic Links استفاده شود با تنظیم قوانین بازنویسی با dynamicLinks تنظیم‌شده روی true مشخص کنید. درخواست‌های ارسال‌شده به این مسیرها به Dynamic Links پروکسی می‌شوند.

      برخلاف قوانینی که مسیرها را به نشانی‌های وب بازنویسی می‌کنند، قوانین بازنویسی Dynamic Link نمی‌توانند حاوی عبارت‌های باقاعده باشند.

      اگر چند قانون بازنویسی برای سایتتان دارید، توجه داشته باشید که Hosting اولین قانون بازنویسی را که با درخواست مطابقت دارد اجرا می‌کند.

    برای مثال:

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

    با پیکربندی بالا، می‌توانید Dynamic Links را با پیشوندهای نشانی وب مانند نمونه‌های زیر ایجاد کنید:

    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 ایجاد کنید و آن را روی پیشوندهای نشانی وب 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، به‌ویژه از ترتیب اولویت میزبانی آگاه باشید.

  • مطمئن شوید پیشوند نشانی وب 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 استفاده کنید، یکی از گزینه‌های زیر را برای پیشوند نشانی وب 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
    } ]