این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

مهاجرت از پیوندهای پویا به پیوندهای برنامه و amp; پیوندهای جهانی

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

این انتقال جایگزین ویژگی های Firebase Dynamic Links زیر می شود:

ویژگی	لینک های دینامیک Firebase	پیوندهای برنامه / پیوندهای جهانی
کاربران را با یک کلیک لینک به فروشگاه صحیح دستگاه خود هدایت کنید		^★
پس از دانلود و نصب برنامه خود با استفاده از یک پیوند عمیق معوق، ادامه سفر را به کاربران ارائه دهید		^★
با استفاده از محتوای پیوند عمیق در برنامه خود (در صورت نصب از قبل) تجربه متنی را به کاربران ارائه دهید.
داده های تحلیلی مربوط به رویدادهای کلیک پیوند پویا را ارائه دهید
امکان ایجاد URL های لینک کوتاه را فراهم کنید

اگر همچنان به سایر ویژگی‌های Firebase Dynamic Link برای مهاجرت خود نیاز دارید که در این راهنما پشتیبانی نمی‌شوند، سایر سناریوهای انتقال را در مستندات سؤالات متداول لغو پیوندهای دینامیک مشاهده کنید.

فرض کنید یک لینک دینامیک Firebase دارید که به شکل زیر است:

مثال پیوند پویا
نام پیوند	به Example.com خوش آمدید
پیوند عمیق	`https://example.web.app/welcome`
برنامه اندروید	`com.example.android`
اپلیکیشن اپل	`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 Dynamic Links انجام می داد):

پیمایش کاربران به فروشگاه صحیح دستگاهشان برای دانلود و نصب برنامه شما
ارائه ادامه سفر کاربر پس از دانلود، نصب و باز کردن برنامه برای اولین بار

به تفاوت های رفتار و عملکرد این پیوندهای برنامه / پیوندهای جهانی در مقایسه با پیوندهای دینامیک Firebase که در جدول بالا ذکر شده است توجه کنید.

قبل از اینکه شروع کنی

Firebase Dynamic Links از پیوندهای برنامه (در اندروید) و پیوندهای جهانی (در iOS) در پیاده سازی زیربنایی خود استفاده می کند تا پس از نصب برنامه شما، عملکرد پیوند عمیق را ارائه دهد.

این راهنما نحوه ایجاد پیوندهای برنامه و پیوندهای جهانی خود را با استفاده از میزبانی Firebase برای جایگزینی بخشی از عملکرد ارائه شده توسط Firebase Dynamic Links در حین انتقال پیوندهای دینامیک Firebase به راه حل جدید App Links / Universal Links توضیح می دهد.

برای تکمیل مهاجرت خود به اطلاعات زیر نیاز دارید:

پیوندهای دینامیک Firebase که قصد مهاجرت آنها را دارید
پارامترهای URL پیوند عمیق موجود در پیوندهای پویا شما
دامنه ای که قصد دارید برای جایگزینی دامنه Firebase Dynamic Links قبلی خود استفاده کنید (در صورت وجود)

می‌توانید از راهنمای Export Dynamic Links Metadata برای صادر کردن ابرداده پیوند موجود خود استفاده کنید و اطلاعات ذکر شده در بالا را به دست آورید.

نمای کلی مراحل مهاجرت

یک دامنه جدید (اگر قبلاً ندارید که می خواهید از آن استفاده کنید) برای میزبانی فایل های پیکربندی App Link / Universal Link خود با استفاده از میزبانی Firebase فراهم کنید.
فایل های پیکربندی App Link / Universal Link خود را در دامنه میزبانی خود ایجاد و میزبانی کنید.
پیوندهای برنامه جدید / پیوندهای جهانی مطابق با طرح پیوند عمیق مورد استفاده در پیوندهای دینامیک Firebase خود ایجاد کنید.
برای دریافت لینک های عمیق، برنامه های Android/iOS و کد برنامه خود را به روز کنید.
آزمایش ادغام پیوندهای برنامه / پیوندهای جهانی.
پیوندهای دینامیک Firebase منتشر شده یا به اشتراک گذاشته شده خود را با پیوندهای برنامه و پیوندهای جهانی جایگزین کنید.

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

مراحل مهاجرت برای پیوندهای برنامه اندروید
مراحل مهاجرت برای پیوندهای جهانی در iOS

یک دامنه جدید برای میزبانی فایل های پیکربندی App Link / Universal Link خود با استفاده از میزبانی Firebase فراهم کنید

دامنه را انتخاب کنید

اولین قدم انتخاب دامنه ای است که می خواهید برای پیوندهای برنامه / پیوندهای جهانی خود استفاده کنید. این دامنه ای است که برای پیوندهای جدیدی که با کاربران خود به اشتراک می گذارید استفاده می شود.

اگر از میزبانی Firebase استفاده می کنید، زیردامنه های پروژه با قالب your-project-domain .web.app یا your-project-domain .firebaseapp.com به طور خودکار و بدون هیچ هزینه ای ارائه می شوند. می توانید به صورت اختیاری از یک دامنه سفارشی با یا بدون میزبانی Firebase برای میزبانی فایل های پیکربندی App Link / Universal Link خود استفاده کنید.

میزبانی Firebase را راه اندازی کنید

در مرحله بعد، باید نمونه میزبانی Firebase خود را تنظیم و پیکربندی کنید .

تا زمانی که راه‌اندازی نمونه میزبانی Firebase خود را به پایان رساندید، دامنه‌ای مشابه با your-project-domain .web.app « خواهید داشت، یا اگر ترجیح می‌دهید یک دامنه سفارشی خواهید داشت.

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

فایل های پیکربندی App Link خود را در دامنه میزبانی جدید خود ایجاد و میزبانی کنید

برای استفاده از App Links، باید یک فایل پیکربندی را میزبانی کنید که به ایجاد ارتباط ایمن بین دامنه مورد استفاده در پیوندها و برنامه شما کمک کند. برای پیوندهای برنامه، این فایل assetlinks.json است.

مراحل ایجاد و میزبانی فایل assetlinks.json

فایل assetlinks.json به ما امکان می‌دهد فهرستی از برنامه‌های مجاز ارائه کنیم که می‌توانند محتویات دامنه وب را که برای پیوندهای برنامه خود استفاده می‌کنیم، مدیریت کنند. خود فایل assetlinks.json باید در ریشه دامنه وب تحت مسیر: /.well-known میزبانی شود.

برای تکمیل این پیکربندی مراحل زیر را دنبال کنید:

پوشه .well-known را در زیر پوشه عمومی در پوشه ریشه Firebase Hosting خود ایجاد کنید.
فایلی به نام 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 از فایل keystore که برای امضای برنامه استفاده می‌کنید، اشاره دارد.
می‌توانید از فایل debug.keystore استفاده شده توسط Android Studio برای ایجاد رکورد sha256_cert_fingerprints برای اهداف اشکال‌زدایی استفاده کنید. می‌توانید فایل را در /Users/<username>/.android/debug.keystore در Mac و Linux و C:\Users\<username>\.android\debug.keystore در Windows پیدا کنید.
از این فروشگاه کلید، می توانید مقدار SHA256 را با استفاده از ابزار کلید واکشی کنید.
برای دستورالعمل های بیشتر در مورد تکمیل این مرحله به این بخش از اسناد App Links مراجعه کنید.
همچنین می‌توانید از App Links Assistant در Android Studio برای تولید محتوای فایل assetlinks.json و پیکربندی برنامه خود برای مدیریت پیوندهای برنامه استفاده کنید.

فایل firebase.json خود را برای ایندکس کردن فایل برای میزبانی به روز کنید.

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

اکنون که فایل assetlinks.json را در اختیار داریم، firebase deploy برای میزبانی تغییرات اجرا کنید.
توجه داشته باشید که برای اجرای دستور deploy بالا باید Firebase CLI را نصب کنید.
```
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`
برنامه اندروید	`com.example.android`
اپلیکیشن اپل	`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 را استخراج می کنید و اکنون از آن به عنوان پارامتر App Link برای برنامه خود استفاده می کنید.

توجه: هنگامی که برای اولین بار پیوند دینامیک Firebase خود را ایجاد کردید، ممکن است یک پارامتر پیوند عمیق ایجاد کرده باشید که از دامنه ای استفاده می کند که متعلق به شما نیست (به عنوان مثال example.com/welcome ). Firebase Dynamic Links از این پشتیبانی می‌کند، اما در این انتقال، هر پیوند عمیقی که قصد استفاده از آن را دارید، باید برای استفاده از دامنه‌ای که متعلق به شماست و قبلاً با میزبانی Firebase پیکربندی شده است، تغییر داده شود. اگر قبلاً از دامنه‌ای که متعلق به خود هستید برای پارامترهای URL پیوند عمیق مورد استفاده در Firebase Dynamic Links خود استفاده کرده‌اید، ممکن است در وقت شما صرفه‌جویی شود و برنامه شما ممکن است از قبل برای مدیریت پیوندهای برنامه ورودی که باید ایجاد کنید پیکربندی شده باشد. .

می‌خواهید این فرآیند را برای هر پیوند دینامیک Firebase که می‌خواهید با استفاده از پیوندهای برنامه / پیوندهای جهانی به آن منتقل کنید، تکرار کنید و طرح پیوند عمیقی را که استفاده کرده‌اید تکرار کنید.

برای مثال، لطفاً مجموعه زیر از پیوندهای کوتاه Firebase Dynamic Links، پارامترهای پیوند عمیق و مقادیر پیوند عمیق منتقل شده را ببینید:

لینک کوتاه	پارامتر پیوند عمیق	پیوند عمیق مهاجرت کرد
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 قبلی روی آن پیوندهای برنامه کلیک کنند.

برای دریافت لینک های عمیق، برنامه اندروید و کد برنامه خود را به روز کنید

گام بعدی پس از انتخاب دامنه، انتخاب طرح پیوند عمیق و انتقال لینک‌های دینامیک Firebase به پیوندهای برنامه، به‌روزرسانی برنامه اندروید و کد برنامه برای دریافت پیوندهای عمیق جدید است.

توصیه می‌کنیم اسناد کامل App Links را در اینجا دنبال کنید یا راهنمای Android Studio را در مورد پیکربندی برنامه خود برای مدیریت پیوندهای عمیق دنبال کنید، اما مراحل اصلی عبارتند از:

شناسایی فعالیت هایی که باید پیوندهای عمیق مربوطه را مدیریت کنند
افزودن فیلتر هدف برای آن فعالیت‌ها در فایل 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 است و شامل پیشوند مسیر خوش‌آمدگویی / است. توجه داشته باشید که باید ویژگی android:autoVerify="true" را نیز مشخص کنید، که به شما امکان می دهد برنامه خود را به عنوان کنترل کننده پیش فرض برای این نوع پیوند مشخص کنید.

در نهایت، باید کد را در MainActivity خود اضافه کنید تا داده های پیوند عمیق را بازیابی کنید و از آن برای ایجاد تجربه پیوند عمیق در برنامه خود استفاده کنید. این شبیه به منطقی است که ممکن است قبلاً در برنامه خود هنگام ادغام با Firebase Dynamic Links کدگذاری کرده باشید.

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 آزمایش کنید.

شما باید با استفاده از دامنه پیکربندی شده برای App Links خود، یک پیوند قابل کلیک ایجاد کنید و سپس روی آن پیوند کلیک کنید تا مطمئن شوید که در برنامه شما باز می شود و شما را به فعالیت مورد نظر هدایت می کند.

همچنین می‌توانید ادغام App Links خود را با استفاده از App Links Assistant در Android Studio آزمایش کنید، یا از دستور زیر برای URL Link App که پیکربندی کرده‌اید استفاده کنید تا مطمئن شوید که فعالیت منطبق را به درستی اجرا می‌کند:

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

پیوندهای دینامیک Firebase منتشر شده یا به اشتراک گذاشته شده خود را با پیوندهای برنامه جایگزین کنید

آخرین مرحله برای انتقال شما این است که پیوندهای دینامیک Firebase منتشر شده یا مشترک خود را با پیوندهای برنامه جایگزین کنید تا جایی که ممکن است، و ادامه استفاده از App Links را در آینده ادامه دهید.

تکمیل این مرحله بسته به مکان و نحوه انتشار پیوندهای دینامیک Firebase متفاوت است، اما برای کمک به شما در ردیابی این پیوندها، می‌توانید فراداده Firebase Dynamic Link موجود خود را صادر کنید. راهنمای Export Links Dynamic Metadata را ببینید.

مراحل مهاجرت برای پیوندهای جهانی در iOS

فایل های پیکربندی Universal Links خود را در دامنه میزبانی جدید خود ایجاد و میزبانی کنید

برای استفاده از پیوندهای جهانی، باید یک فایل پیکربندی میزبانی کنید که به ایجاد ارتباط ایمن بین دامنه مورد استفاده در پیوندها و برنامه شما کمک می کند. برای پیوندهای جهانی، این فایل apple-app-site-association (همچنین به عنوان فایل AASA شناخته می شود) است.

مراحل ایجاد و میزبانی فایل apple-app-site-association

فایل AASA به ما امکان می دهد فهرستی از برنامه های مجاز ارائه کنیم که می توانند محتویات دامنه وب را که برای پیوندهای جهانی خود استفاده خواهیم کرد، مدیریت کنند. خود فایل AASA باید در ریشه دامنه وب تحت مسیر: /.well-known میزبانی شود.

برای تکمیل این پیکربندی مراحل زیر را دنبال کنید:

پوشه " .well-known " را در زیر پوشه عمومی در پوشه ریشه Firebase Hosting خود ایجاد کنید.
فایلی با نام " apple-app-site-association " در زیر پوشه ".well-known" ایجاد کنید.
محتوای زیر را در فایل apple-app-site-association خود کپی کنید و به معنی هر قسمت زیر توجه داشته باشید:
```
{
  "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 را برای میزبانی تغییرات انجام دهید.
با رفتن به https:// your-project-domain .web.app/.well-known/app-app-site-association فایل AASA را تأیید کنید.

ایجاد پیوندهای جهانی جدید مطابق با طرح پیوند عمیق مورد استفاده در پیوندهای دینامیک Firebase شما

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

برای مثال، فرض کنید پیوند دینامیک Firebase زیر را دارید:

مثال پیوند پویا
نام پیوند	به Example.com خوش آمدید
پیوند عمیق	`https://example.web.app/welcome`
برنامه اندروید	`com.example.android`
اپلیکیشن اپل	`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 Dynamic Links از این پشتیبانی می‌کند، اما در این انتقال، هر پیوند عمیقی که قصد استفاده از آن را دارید، باید برای استفاده از دامنه‌ای که متعلق به شماست و قبلاً با میزبانی 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 خود استفاده کنید، اضافه کنید. فایل مرتبط

این می تواند توسط:

باز کردن Xcode
پروژه خود را در ناوبر فایل انتخاب کنید
به برگه امضا و قابلیت‌ها در تنظیمات پروژه خود بروید
به قسمت Associated Domains بروید
با کلیک بر روی دکمه + دامنه اضافی را به پروژه خود در قالب "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 Dynamic Links به کاربران خود توصیه می کنیم.

با استفاده از بنرهای برنامه هوشمند، اگر برنامه شما قبلاً روی دستگاهشان نصب نشده باشد، کاربران شما برای لیست برنامه شما به فروشگاه App برده می شوند. همچنین می‌توانید به صورت اختیاری پارامتری را پیکربندی کنید تا پس از دانلود و نصب برنامه به آن منتقل شود تا ادامه سفر را به کاربران خود ارائه دهید. اگر برنامه شما قبلاً نصب شده باشد، پارامتری را به برنامه شما منتقل می کند تا به کاربر کمک کند بر اساس بنر برنامه هوشمندی که روی آن کلیک کرده است به محتوای مناسب هدایت شود.

پیوندهای دینامیک Firebase منتشر شده یا به اشتراک گذاشته شده خود را با پیوندهای برنامه جایگزین کنید

گام نهایی برای مهاجرت شما این است که پیوندهای دینامیک Firebase منتشر شده یا به اشتراک گذاشته شده خود را با پیوندهای جهانی در هر کجا که ممکن است جایگزین کنید و در آینده به استفاده از پیوندهای جهانی ادامه دهید.

تکمیل این مرحله بسته به مکان و نحوه انتشار پیوندهای دینامیک Firebase خود متفاوت است.

برای کمک به شما برای ردیابی پیوندهای دینامیک Firebase موجود برای انتقال، راهنمای نحوه صادر کردن متا پیوند کوتاه خود را از Firebase Dynamic Links منتشر خواهیم کرد. لطفاً برای به‌روزرسانی‌های بیشتر ، سند سؤالات متداول مربوط به لغو پیوندهای پویا را بررسی کنید.