انتقال پیوند ایمیل به سیستم به دور از Firebase Dynamic Links (اندروید)

احراز هویت پیوند ایمیل قبلاً به Firebase Dynamic Links متکی بود که در 25 آگوست 2025 بسته خواهد شد. ما یک راه حل جایگزین را در Firebase Authentication Android SDK نسخه 23.2.0+ و Firebase BoM نسخه 33.9.0+ منتشر کرده ایم. اگر برنامه شما از پیوندهای سبک قدیمی استفاده می کند و می خواهید از یک روش جایگزین برای انتقال برنامه خود استفاده کنید، برای استفاده از سیستم جدید مبتنی بر Firebase Hosting به احراز هویت با Firebase با استفاده از Email Link در اندروید مراجعه کنید.

همچنین، اگر از Firebase Authentication Android SDK زیر نسخه 20.0.0 (یا Firebase BoM زیر نسخه 26.0.0) برای مدیریت جریان‌های OAuth با Firebase Authentication استفاده می‌کنید، باید به آخرین نسخه Authentication SDK یا BoM ( Authentication v.2+ v.6 یا به ترتیب BoM به ترتیب ادامه دهید. مدیریت جریان های OAuth در Firebase Authentication .

دامنه Firebase Dynamic Links مرتبط خود را به دامنه Firebase Hosting منتقل کنید

به‌جای استفاده از دامنه Firebase Dynamic Links ، Firebase Authentication از دامنه پیش‌فرض Firebase Hosting برای پروژه شما برای ایجاد پیوندهایی برای پیوند ایمیل و سایر اقدامات پیوند خارج از باند در برنامه‌های تلفن همراه استفاده می‌کند. این بدان معناست که برنامه شما نیز برای استفاده از این دامنه پیش‌فرض به عنوان دامنه مرتبط برای پیوندهای احراز هویت ایمیل به برنامه تلفن همراه شما، باید به‌روزرسانی شود.

می‌توانید دستورالعمل‌های موجود در Authenticate with Firebase با استفاده از Email Link در Android را دنبال کنید تا پیوندهای برنامه تلفن همراه خود را برای استفاده از دامنه پیش‌فرض Firebase Hosting جدید که به‌طور خودکار ارائه می‌شود، به‌روزرسانی کنید.

از دستورالعمل‌های زیر برای مدیریت پیوندها از دامنه جدید استفاده کنید و به Firebase Authentication دستور دهید تا از دامنه جدید برای ایجاد پیوندهای برنامه تلفن همراه در آینده استفاده کند.

اگر می خواهید به استفاده از هر یک از دامنه های Firebase Hosting سفارشی خود یا حتی دامنه Firebase Dynamic Links سفارشی خود ادامه دهید تا دامنه جدید مرتبط شما باشد، مراحلی را دنبال کنید که با دامنه مورد نظری که می خواهید استفاده کنید مطابقت دارد. توجه داشته باشید که پس از تکمیل دستورالعمل‌های بخش زیر، ویژگی پیوند عمیق در دامنه سفارشی Firebase Dynamic Links شما حذف خواهد شد. فقط خود دامنه برای ایجاد پیوندهای ایمیل باقی می ماند.

1. برنامه اندروید خود را برای مدیریت لینک Firebase Hosting پیکربندی کنید

   1. برای مدیریت این پیوندها از برنامه Android خود، نام بسته برنامه شما باید در تنظیمات پروژه کنسول Firebase مشخص شود. علاوه بر این، SHA-1 و SHA-256 گواهی درخواست باید ارائه شود.

   2. اگر می‌خواهید این پیوندهای Firebase Hosting به یک فعالیت خاص هدایت شوند، باید یک فیلتر هدف را در فایل AndroidManifest.xml خود پیکربندی کنید. فیلتر قصد باید پیوندهای Firebase Hosting دامنه شما را بگیرد. در AndroidManifest.xml :

      <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.BROWSABLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data
          android:scheme="https"
          android:host="PROJECT_ID.firebaseapp.com or a custom hosting domain"
          android:pathPrefix="/__/auth/links" />
      </intent-filter>
      

   وقتی کاربران پیوند میزبانی را با مسیر "/__/auth/links" و طرح و میزبانی که مشخص کرده‌اید باز می‌کنند، برنامه شما فعالیت را با این فیلتر قصد شروع می‌کند تا پیوند را مدیریت کند.

   مهم: برای اطمینان از بازگشت بی‌وقفه، توصیه می‌کنیم در حین امتحان راه‌حل پیوند Firebase Hosting ، فیلتر قصد موجود خود را که Firebase Dynamic Links مدیریت می‌کند، نگه دارید. راه حل Firebase Dynamic Links تا 25 آگوست 2025 در دسترس خواهد بود.

2. پروژه خود را برای استفاده از پیوندهای جدید پیکربندی کنید

   هنگامی که برای مدیریت پیوندهای دامنه جدید آماده شدید، می توانید از Firebase Admin SDK برای به روز رسانی نحوه ایجاد پیوندهای ایمیل استفاده کنید و به پشتیبان ما دستور دهید تا با استفاده از دامنه Firebase Hosting جدید شروع به تولید پیوندها کند.

   const updateRequest = {
     mobileLinksConfig: {
         domain: 'HOSTING_DOMAIN'
     }
   }
   const updateProjectConfig = () => {
     projectConfigManager.updateProjectConfig(updateRequest)
     .then((response) => {
         // updated project config
     }).catch((error) => {
         console.log('Error updating the project:', error);
     });
   }
   

   مهم: برای بازگشت به Firebase Dynamic Links هنگام پیاده‌سازی و آزمایش راه‌حل پشتیبان، باید دامنه را به FIREBASE_DYNAMIC_LINK برگردانید. راه حل Firebase Dynamic Links تا 25 آگوست 2025 در دسترس خواهد بود.

3. پیوند ایمیل را ارسال و بازخرید کنید

   لینک ورود به ایمیل را مانند قبل ارسال کنید. هنگامی که کاربر نهایی روی پیوند کلیک می کند، در صورت نصب برای تکمیل ورود به برنامه به برنامه هدایت می شود.

لینک های موبایل خود را سفارشی کنید

می توانید از دامنه Firebase Hosting سفارشی استفاده کنید یا از دامنه Firebase Dynamic Links سفارشی خود مجدداً به عنوان دامنه پیوندهای تلفن همراه جدید خود استفاده کنید.

از یک دامنه Firebase Hosting سفارشی استفاده کنید

1. برای راه اندازی یک دامنه سفارشی ، راهنمای Firebase Hosting را دنبال کنید.
2. برنامه اندروید خود را برای مدیریت لینک Firebase Hosting پیکربندی کنید. (دستورالعمل در بخش قبلی بالا).
3. یک پیوند احراز هویت به آدرس ایمیل کاربر با یک شی ActionCodeSettings به روز شده با یک دامنه سفارشی به عنوان linkDomain ارسال کنید.

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

1. می‌توانید از هر یک از دامنه‌های Firebase Dynamic Links خود به عنوان دامنه سفارشی خود استفاده کنید. با این حال، دیگر قابلیت Firebase Dynamic Links پشتیبانی نمی‌شود (به عنوان مثال، اگر برنامه روی دستگاهشان نصب نشده باشد، کاربران نمی‌توانند به فروشگاه برنامه هدایت شوند).
2. برنامه اندروید خود را برای مدیریت لینک Firebase Hosting خود پیکربندی کنید (دستورالعمل های بخش قبلی در بالا).
3. یک پیوند احراز هویت به آدرس ایمیل کاربر با یک شی ActionCodeSettings به روز شده با یک دامنه سفارشی به عنوان linkDomain ارسال کنید.