انتقال ورود به سیستم با پیوند ایمیل از «پیوندهای پویای Firebase»‏ (Android)

اصالت‌سنجی پیوند ایمیل قبلاً به Firebase Dynamic Links متکی بود که در ۲۵ اوت ۲۰۲۵ تعطیل خواهد شد. ما راهکار جایگزینی را در Firebase Authentication «کیت توسعه نرم‌افزار Android» نسخه ۲۳.۲.۰ و بالاتر و Firebase BoM نسخه ۳۳.۹.۰ و بالاتر منتشر کرده‌ایم. اگر برنامه شما از پیوندهای سبک قدیمی استفاده می‌کند و می‌خواهید از روش جایگزینی برای انتقال برنامه‌تان استفاده کنید، برای استفاده از سیستم جدید مبتنی بر Firebase Hosting، به اصالت‌سنجی با Firebase بااستفاده از «پیوند ایمیل» در Android مراجعه کنید.

همچنین، اگر از کیت توسعه نرم‌افزار Android Firebase Authentication نسخه پایین‌تر از v20.0.0 (یا Firebase BoM نسخه پایین‌تر از v26.0.0) برای مدیریت جریان‌های OAuth با Firebase Authentication استفاده می‌کنید، باید به جدیدترین نسخه کیت توسعه نرم‌افزار Authentication یا BoM (Authentication v20.0.0+‎ یا BoM v26.0.0+‎) به‌روزرسانی کنید تا بتوانید به مدیریت جریان‌های OAuth در Firebase Authentication ادامه دهید.

انتقال دامنه Firebase Dynamic Links مرتبط به دامنه Firebase Hosting

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

می‌توانید دستورالعمل‌های موجود در احراز هویت با Firebase بااستفاده از پیوند ایمیل در Android را دنبال کنید تا پیوندهای برنامه تلفن همراهتان را به‌روز کنید تا از دامنه پیش‌فرض Firebase Hosting که به‌طور خودکار فراهم شده است استفاده کنید.

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

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

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

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

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

   import { getAuth } from 'firebase-admin/auth';
   
   const updateEmailAuthDomain = async () => {
     const updateRequest = {
       mobileLinksConfig: {
         domain: 'HOSTING_DOMAIN',
       },
     };
   
     const projectConfigManager = getAuth().projectConfigManager();
   
     try {
       const response = await projectConfigManager.updateProjectConfig(updateRequest);
       // Updated project config
       console.log('Project configuration updated successfully:', response);
     } catch (error) {
       console.error('Error updating the project:', error);
     }
   };
   

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

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

سفارشی‌سازی پیوندهای تلفن همراه

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

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

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

استفاده مجدد از دامنه سفارشی Firebase Dynamic Links

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