یک دامنه سفارشی برای پیوندهای پویا تنظیم کنید

شما می توانید کنترل بیشتری بر پویا لینک خود را داشته باشند، نام تجاری با استفاده از دامنه خود را به جای یک page.link زیر دامنه. با دامنه های سفارشی ، می توانید پیوندهای پویا مانند مثال های زیر ایجاد کنید:

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 به نام پیشوند نشانی اینترنتی، و شامل هر دو سفارشی دامنه پیوند پویا و یک پیشوند مسیر خود را. هنگام ایجاد پیوندهای پویا ، باید پیشوند URL را ارائه دهید.

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

استفاده از دامنه وب خود برای پیوندهای پویا

می توانید از دامنه یکسانی برای پیوندهای پویا و صفحات وب ، پیوندهای جهانی و پیوندهای برنامه خود استفاده کنید ، اما در صورت استفاده از آن ، باید مراقب باشید که نشانی های اینترنتی پیوند پویا با URL های وب شما تضاد نداشته باشد. وقتی پیوندهای پویا را برای استفاده از یک پیشوند URL خاص پیکربندی می کنید ، تمام نشانی های اینترنتی که با آن پیشوند شروع می شوند به عنوان پیوندهای پویا رفتار می شوند ، بنابراین نمی توانید از URL هایی با آن پیشوند استفاده کنید تا به محتوای میزبان معمولی اشاره کنند.

برای مثال، اگر شما می خواهید برای ایجاد یک پیوند پویا به منابع https://example.com/my-resource (یک صفحه وب، جهانی پیوند یا لینک برنامه)، شما می توانید استفاده کنید https://example.com/ به عنوان پیشوند پویا آدرس های URL، چون با این کار باعث https://example.com/my-resource به عنوان یک پیوند پویا درمان می شود. در عوض ، شما باید از یک پیشوند URL با دامنه یا پیشوند مسیر متفاوت استفاده کنید.

بنابراین، در بر داشت زیر بلند فرم پویا ها (و لینک کوتاه معادل آن) کار نخواهد کرد به عنوان در نظر گرفته شده زیرا نشانیهای اینترنتی مشخص توسط link شروع پارامتر با پیشوند پیوند پویا URL، https://example.com/ :

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

اما در بر داشت زیر بلند فرم پویا ها (و لینک کوتاه معادل آن) کار می کنند، به دلیل پیشوند آدرس URL را در تضاد نیست با link URL ها:

 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. اگر شما تنظیم نشده تا فایربیس میزبانی وب برای پروژه شما، باز کردن صفحه میزبانی از فایربیس کنسول، کلیک کنید شروع به کار، و از طریق دستورالعمل تنظیم را کلیک کنید. در حال حاضر لازم نیست مراحل مشخص شده را انجام دهید.

  2. را باز دینامیک صفحه لینک از کنسول فایربیس.

  3. اگر شما پویا لینک ها استفاده شده قبل از، کلیک کنید شروع به کار. در غیر این صورت، کلیک کنید اضافه کردن URL پیشوند را از منوی کشویی.

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

  4. در iOS تنها در پروژه Xcode متعلق به خود را Info.plist فایل، ایجاد یک کلید به نام FirebaseDynamicLinksCustomDomains و آن را به پیشوند پویا لینک URL برنامه خود را تنظیم کنید. مثلا:

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

دامنه سفارشی را به صورت دستی تنظیم کنید

در برخی شرایط ، مانند زمانی که دامنه سفارشی خود را برای پیوندهای پویا تنظیم کرده اید و می خواهید دامنه دیگری اضافه کنید ، یا دامنه ای را که قبلاً به یک سایت میزبان متصل شده است ، باید دامنه سفارشی خود را به صورت دستی تنظیم کنید.

برای انجام این کار:

  1. اتصال دامنه خود به فایربیس میزبانی اگر شما قبلا انجام داده است تا.

    راه اندازی دامنه خود را با Firebase میزبانی شامل ایجاد فایل configuration firebase.json در دایرکتوری پروژه های محلی خود را.

  2. به روز رسانی به آخرین نسخه از فایربیس CLI (v6.5.0 یا بالاتر).

  3. پیکربندی سایت میزبانی وب خود را برای پویا لینک ها در پروژه های خود را firebase.json فایل. اگر پروژه شما دارای چندین سایت است ، حتماً سایت متصل به دامنه موردنظرتان را پیکربندی کنید.

    • مجموعه appAssociation به AUTO . با این تنظیم، میزبانی وب به صورت پویا تولید assetlinks.json و apple-app-site-association فایل زمانی که آنها خواسته می شود.

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

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

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

    مثلا:

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

    با تنظیمات فوق، شما می توانید پویا ارتباط با پیشوندهای نشانی اینترنتی مانند نمونه زیر ایجاد کنید:

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

    اگر شما استفاده از این دامنه تنها برای پویا لینک ها، شما می توانید یک مسیر منبع استفاده /** به ایجاد پویا لینک با پیشوند مسیر:

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

    با دستور بالا، شما می توانید پویا لینک مانند مثال زیر ایجاد کنید:

    https://your-domain/link-suffix

  4. استقرار میزبانی تغییرات پیکربندی شما:

    firebase deploy --only hosting

    (اختیاری) شما می توانید مستقر بررسی firebase.json محتوا با استفاده از میزبانی API REST .

  5. در iOS تنها در پروژه Xcode متعلق به خود را Info.plist فایل، ایجاد یک کلید به نام FirebaseDynamicLinksCustomDomains و آن را به پیشوند پویا لینک URL برنامه خود را تنظیم کنید. مثلا:

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

ترتیب اولویت برای پیوندهای پویا و میزبانی

برای پویا لینک ها، به خصوص از آن آگاه میزبانی به ترتیب اولویت .

  • اطمینان حاصل کنید که پیشوند URL پیوندهای پویا شما با تنظیمات میزبانی با اولویت بالاتر مغایرت ندارد (به عنوان مثال ، محتوای استاتیک میزبانی شده همیشه نسبت به بازنویسی اولویت دارد).
  • در rewrites ویژگی، پاسخ میزبانی خواهد قانون اطاعت مشخص شده توسط اولین source جانشین است که قطاری از مسیر درخواست شده است.

برای مثال، اگر شما در تنظیم یک پیوند پویا برای your-domain / source-path / link-suffix اما شما همچنین محتوای استاتیک در دارند your-domain / source-path /index.html ، محتوای استاتیک تقدم. کاربر نهایی خواهید دید index.html به جای پیوند پویا. به طور مشابه، اگر شما محتوای استاتیک در your-domain / source-path / link-suffix ، کاربر نهایی خواهد محتوای استاتیک به جای پیوند پویا را ببینید.

اگر می خواهید از مارک تجاری مشابه برای لینک های پویا و میزبانی استفاده کنید ، یکی از گزینه های زیر را برای پیشوند URL پیوندهای پویا در نظر بگیرید:

  • تنظیم خود را source ویژگی برای مطابقت با یک پیشوند مسیر. برای مثال، اگر شما یک دامنه سفارشی از example.com ، بازنویسی قانون خود را می تواند:

    // Domain is example.com
    "rewrites": [ {
      "source": "/links/**",  // Dynamic Links start with "https://example.com/links/"
      "dynamicLinks": true
    } ]
    
  • تنظیم یک زیر دامنه برای استفاده برای پویا لینک ها، پس از آن مجموعه خود را source ویژگی به بازی که زیر دامنه. به عنوان مثال، اگر شما یک زیر دامنه از links.example.com ، بازنویسی قانون خود را می تواند:

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