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

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

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

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

ازاین‌پس، به‌جای استفاده از دامنه Firebase Dynamic Links، Firebase Authentication از دامنه پیش‌فرض 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.