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

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

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

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

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

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

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

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

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

برنامه اندروید خود را برای مدیریت لینک Firebase Hosting پیکربندی کنید
1. برای مدیریت این لینک‌ها از برنامه اندروید خود، نام بسته برنامه شما باید در تنظیمات پروژه کنسول Firebase مشخص شود. علاوه بر این، SHA-1 و SHA-256 گواهی برنامه باید ارائه شود.
2. اگر می‌خواهید این لینک‌های Firebase Hosting به یک activity خاص هدایت شوند، باید یک فیلتر intent در فایل AndroidManifest.xml خود پیکربندی کنید. فیلتر intent باید لینک‌های 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" و طرح و میزبان مشخص شده توسط شما را باز می‌کنند، برنامه شما اکتیویتی را با این فیلتر intent برای مدیریت لینک آغاز می‌کند.
مهم: برای اطمینان از بازگشت یکپارچه، توصیه می‌کنیم فیلتر intent فعلی خود را که Firebase Dynamic Links مدیریت می‌کند، در حین امتحان کردن راهکار Firebase Hosting link نگه دارید. راهکار Firebase Dynamic Links تا ۲۵ آگوست ۲۰۲۵ در دسترس خواهد بود.
پروژه خود را برای استفاده از لینک‌های جدید پیکربندی کنید
وقتی آماده مدیریت لینک‌های دامنه جدید شدید، می‌توانید از Firebase Admin SDK برای به‌روزرسانی نحوه تولید لینک‌های ایمیل استفاده کنید و به backend ما دستور دهید تا با استفاده از دامنه جدید 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);
  }
};
```
مهم: برای بازگشت به Firebase Dynamic Links هنگام پیاده‌سازی و آزمایش راهکار پشتیبان‌گیری، باید دامنه را به FIREBASE_DYNAMIC_LINK تنظیم کنید. راهکار Firebase Dynamic Links تا ۲۵ آگوست ۲۰۲۵ در دسترس خواهد بود.
ارسال و دریافت لینک ایمیل
مانند قبل، لینک ورود به سیستم از طریق ایمیل را ارسال کنید. وقتی کاربر نهایی روی لینک کلیک کند، در صورت نصب، برای تکمیل ورود به سیستم به برنامه هدایت می‌شود.

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

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

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

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

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

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