بااستفاده از دامنه خودتان بهجای زیردامنه 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 راهاندازی کنید. برای انجام این کار:
اگر Firebase Hosting را برای پروژهتان راهاندازی نکردهاید، صفحه Hosting کنسول Firebase را باز کنید، روی شروع به کار کلیک کنید، و دستورالعملهای راهاندازی را دنبال کنید. درحالحاضر لازم نیست مراحل نشاندادهشده را تکمیل کنید.
صفحه Dynamic Links کنسول Firebase را باز کنید.
اگر قبلاً از Dynamic Links استفاده نکردهاید، روی شروع به کار کلیک کنید. درغیراینصورت، روی افزودن پیشوند نشانی وب در منوِ کرکرهای کلیک کنید.
سپس، دستیار راهاندازی را تکمیل کنید و دامنه و پیشوند مسیر موردنظرتان را برای استفاده درصورت درخواست مشخص کنید.
فقط 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 متصل شده است، باید دامنه سفارشیتان را بهصورت دستی راهاندازی کنید.
برای انجام این کار:
دامنهتان را به Firebase Hosting متصل کنید اگر قبلاً این کار را نکردهاید.
راهاندازی دامنه با Firebase Hosting شامل ایجاد فایل پیکربندی
firebase.jsonدر فهرست راهنمای پروژه محلی شما است.به جدیدترین نسخه Firebase CLI بهروزرسانی کنید (نسخه ۶.۵.۰ یا جدیدتر).
سایت 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
تغییرات پیکربندی Hosting را مستقر کنید:
firebase deploy --only hosting
(اختیاری) میتوانید محتوای
firebase.jsonمستقرشده را بااستفاده از Hosting REST API بررسی کنید.فقط 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 از قانونی پیروی میکند که توسط اولینsourceglob که مسیر درخواستی را ضبط میکند مشخص شده است.
برای مثال، اگر 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 } ]