انتقال از «پیوندهای پویا» به «پیوندهای برنامه» و «پیوندهای جامع»

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

این انتقال جایگزین ویژگی‌های «پیوندهای پویای Firebase» زیر می‌شود:

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

اگر برای انتقال همچنان به دیگر ویژگی‌های «پیوند پویای Firebase» نیاز دارید که در این راهنما پشتیبانی نمی‌شود، دیگر سناریوهای انتقال را در سند پرسشگان منسوخ شدن «پیوندهای پویا» ببینید.

فرض کنید «پیوند پویای Firebase» دارید که به این شکل است:

نمونه پیوند پویا
نام پیوند به Example.com خوش آمدید
پیوند عمیق https://example.web.app/welcome
برنامه Android com.example.android
برنامه Apple 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» قبلاً ارائه می‌کرد):

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

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

قبل از شروع

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

این راهنما نحوه ایجاد «پیوندهای برنامه» و «پیوندهای جامع» خودتان را بااستفاده از «میزبانی Firebase» برای جایگزین کردن آن بخش از عملکرد ارائه‌شده توسط «پیوندهای پویای Firebase» درحین انتقال «پیوندهای پویای Firebase» به راهکار انتقال جدید «پیوندهای برنامه» / «پیوندهای جامع» توضیح می‌دهد.

برای تکمیل انتقال به اطلاعات زیر نیاز دارید:

  • «پیوندهای پویای Firebase» که قصد انتقال آن‌ها را دارید
  • پارامترهای نشانی وب پیوند عمیق که در پیوندهای پویای شما گنجانده شده است
  • دامنه‌ای که قصد دارید برای جایگزینی دامنه قبلی «پیوندهای پویای Firebase» خود استفاده کنید (درصورت وجود)

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

نمای کلی مراحل انتقال

  1. دامنه جدیدی را (اگر ازقبل دامنه‌ای ندارید که بخواهید استفاده کنید) برای میزبانی فایل‌های پیکربندی «پیوند جامع» / «پیوند برنامه» بااستفاده از «میزبانی Firebase» فراهم کنید.

  2. فایل‌های پیکربندی «پیوند جامع» / «پیوند برنامه» را در دامنه میزبانی‌تان ایجاد و میزبانی کنید.

  3. «پیوندهای برنامه» / «پیوندهای جامع» جدیدی ایجاد کنید که با طرح‌واره پیوند عمیق استفاده‌شده در «پیوندهای پویای Firebase» شما مطابقت داشته باشد.

  4. برنامه‌های Android / iOS و کد برنامه خود را به‌روز کنید تا پیوندهای عمیق را دریافت کنید.

  5. آزمایش کردن ادغام‌های «پیوندهای برنامه» / «پیوندهای جامع».

  6. «پیوندهای پویای Firebase» منتشرشده یا هم‌رسانی‌شده را با «پیوندهای برنامه» و «پیوندهای جامع» جایگزین کنید.

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

انتخاب دامنه

اولین قدم این است که دامنه‌ای را که می‌خواهید برای «پیوندهای برنامه» / «پیوندهای جامع» استفاده کنید انتخاب کنید. این دامنه‌ای خواهد بود که برای پیوندهای جدیدی که با کاربرانتان هم‌رسانی می‌کنید استفاده خواهد شد.

اگر از میزبانی Firebase استفاده می‌کنید، زیردامنه‌های پروژه با قالب your-project-domain.web.app یا your-project-domain.firebaseapp.com به‌طور خودکار و بدون هزینه تأمین می‌شوند. می‌توانید به‌طور اختیاری از دامنه سفارشی با یا بدون «میزبانی Firebase» برای میزبانی فایل‌های پیکربندی «پیوند جامع» / «پیوند برنامه» نیز استفاده کنید.

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

سپس باید نمونه «میزبانی Firebase» خود را راه‌اندازی و پیکربندی کنید.

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

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

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

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

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

  1. پوشه .well-known را در پوشه عمومی در دایرکتوری ریشه «میزبانی Firebase» ایجاد کنید.

  2. فایلی با نام assetlinks.json در پوشه .well-known ایجاد کنید.

  3. محتوای زیر را در فایل 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 پیدا کنید.

    از این keystore، می‌توانید مقدار SHA256 را بااستفاده از keytool واکشی کنید.

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

    همچنین می‌توانید از دستیار پیوندهای برنامه در «استودیو Android» برای تولید محتوای فایل assetlinks.json و پیکربندی برنامه‌تان برای مدیریت «پیوندهای برنامه» استفاده کنید.

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

    "headers": [
      {
        "source": "/.well-known/assetlinks.json",
        "headers": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ]
      }
    ]
    
  5. اکنون که فایل assetlinks.json را در جای خود داریم، firebase deploy را اجرا کنید تا تغییرات را میزبانی کنید.

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

    firebase deploy --only hosting
    
  6. با رفتن به https://your-project-domain.web.app/.well-known/assetlinks.json فایل assetlinks.json را درستی‌سنجی کنید

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

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

نمونه پیوند پویا
نام پیوند به Example.com خوش آمدید
پیوند عمیق https://example.web.app/welcome
برنامه Android com.example.android
برنامه Apple 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» که می‌خواهید به استفاده از «پیوندهای برنامه» / «پیوندهای جامع» منتقل کنید تکرار کنید و طرح پیوند عمیقی را که استفاده کرده‌اید تکرار کنید.

برای مثال، لطفاً مجموعه زیر از پیوندهای کوتاه «پیوندهای پویای 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» قبلی روی آن «پیوندهای برنامه» کلیک کنند.

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

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

  1. شناسایی اینکه کدام فعالیت‌ها باید پیوندهای عمیق مربوطه را مدیریت کنند
  2. افزودن «فیلتر هدف» برای آن فعالیت‌ها در فایل AndroidManifest.xml برنامه
  3. دریافت پیوند عمیق در کد برنامه فعالیت‌های شما

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

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

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

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

همچنین می‌توانید ادغام «پیوندهای برنامه» را بااستفاده از دستیار پیوندهای برنامه در Android Studio آزمایش کنید، یا از فرمان زیر برای نشانی وب «پیوند برنامه» که پیکربندی کرده‌اید استفاده کنید تا مطمئن شوید فعالیت منطبق را به‌درستی راه‌اندازی می‌کند:

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

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

تکمیل این مرحله بسته به اینکه «پیوندهای پویای Firebase» خود را کجا و چگونه منتشر کرده‌اید متفاوت خواهد بود، اما برای کمک به شما در ردیابی اینکه کدام‌یک وجود دارند، می‌توانید فراداده‌های «پیوند پویای Firebase» موجود خود را صادر کنید. راهنمای صادر کردن فراداده‌های پیوندهای پویا را ببینید.

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

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

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

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

  1. پوشه «.well-known» را در پوشه عمومی در دایرکتوری ریشه «میزبانی Firebase» خود ایجاد کنید.

  2. فایلی با نام «apple-app-site-association» در پوشه «well-known.» ایجاد کنید.

  3. محتوای زیر را در فایل apple-app-site-association کپی کنید، و به معنی هر فیلد در زیر توجه کنید:

    {
      "applinks": {
        "apps": [],
        "details": [
          {
            "appID": "$TEAM_ID.com.firebase.UniversalLinks",
            "paths": [
              "NOT /_/*",
              "/*"
            ]
          }
        ]
      }
    }
    
    • $TEAM_ID.BundleId - نام برنامه کاملاً واجدشرایطی که برای مدیریت پیوندها مجاز است
  4. فایل firebase.json را به‌روز کنید تا فایل را برای میزبانی نمایه‌سازی کند.

    "headers": [
      {
        "source": "/.well-known/apple-app-site-association",
        "headers": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ]
      }
    ]
    
  5. اکنون که فایل AASA را در جای خود داریم، firebase deploy را برای میزبانی تغییرات انجام دهید.

  6. با رفتن به https://your-project-domain.web.app/.well-known/app-app-site-association فایل AASA را درستی‌سنجی کنید

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

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

نمونه پیوند پویا
نام پیوند به Example.com خوش آمدید
پیوند عمیق https://example.web.app/welcome
برنامه Android com.example.android
برنامه Apple 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» که می‌خواهید به استفاده از «پیوندهای برنامه» / «پیوندهای جامع» منتقل کنید تکرار کنید و طرح پیوند عمیقی را که استفاده کرده‌اید تکرار کنید.

برای مثال، لطفاً مجموعه زیر از پیوندهای کوتاه «پیوندهای پویای 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» قبلی روی آن «پیوندهای جامع» کلیک کنند.

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

توصیه می‌کنیم برای پیکربندی برنامه‌تان جهت مدیریت پیوندهای عمیق، سند کامل «پیوندهای جامع» را در اینجا دنبال کنید، اما مراحل اصلی عبارتند از:

  1. پیکربندی پروژه‌تان را به‌روز کنید تا برنامه‌تان بتواند پیوندهای عمیق را از دامنه جدیدتان مدیریت کند

  2. دریافت پیوند عمیق در کد برنامه

برای به‌روزرسانی پیکربندی پروژه خود جهت فعال کردن برنامه برای مدیریت پیوندهای عمیق، باید یک دامنه مرتبط اضافی به پروژه خود در xCode برای دامنه‌ای که اکنون قصد دارید برای میزبانی فایل apple-app-site-associate خود استفاده کنید، اضافه کنید.

این کار را می‌توان با انجام موارد زیر انجام داد:

  1. درحال باز کردن Xcode
  2. انتخاب پروژه در پیمایشگر فایل
  3. پیمایش به برگه «امضا و قابلیت‌ها» در تنظیمات پروژه
  4. به بخش «دامنه‌های مرتبط» در پایین پیمایش کنید
  5. روی دکمه + کلیک کنید تا دامنه اضافی را در قالب «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)
}

کد بالا روش فراخوانی «پیوند جامع» را لغو می‌کند و نشانی وب پیوند عمیق را درصورت وجود ثبت می‌کند.

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

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  AppDelegate.showReceivedUrl(userActivity: userActivity)
}

می‌توانید «پیوندهای جامع» را که به‌تازگی ایجاد کرده‌اید با اجرای برنامه‌تان در دستگاه فیزیکی یا شبیه‌ساز آزمایش کنید.

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

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

اکیداً توصیه می‌کنیم از برنماهای برنامه هوشمند به‌عنوان روشی برای ارائه تجربه‌ای مشابه Firebase Dynamic Links به کاربران استفاده کنید.

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

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

تکمیل این مرحله بسته به اینکه «پیوندهای پویای Firebase» را کجا و چگونه منتشر کرده‌اید متفاوت خواهد بود.

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