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

اصالت‌سنجی پیوند ایمیل قبلاً به Firebase Dynamic Links متکی بود که در ۲۵ اوت ۲۰۲۵ تعطیل خواهد شد. ما راهکار جایگزینی را در نسخه ۱۱.۸.۰+ کیت توسعه نرم‌افزار iOS‏ Firebase Authentication منتشر کرده‌ایم. اگر برنامه‌تان از Firebase Dynamic Links استفاده می‌کند، باید برنامه‌تان را به سیستم جدید مبتنی بر Firebase Hosting منتقل کنید.

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

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

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

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

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

  1. دامنه Firebase Hosting را به دامنه مرتبط با برنامه‌تان پیوند دهید.

    باید دامنه انتخاب‌شده را به‌عنوان «دامنه منسوب» برای پیوندهای برنامه پیکربندی کنید. برای راه‌اندازی حق استفاده در برنامه‌تان، برگه Signing & Capabilities (امضا و قابلیت‌ها) هدف را در Xcode باز کنید و دامنه‌های Firebase Hosting مرحله قبل را به قابلیت Associated Domains (دامنه‌های مرتبط) اضافه کنید. اگر از دامنه پیش‌فرض Firebase Hosting استفاده می‌کنید، این مقدار applinks:PROJECT_ID.firebaseapp.com خواهد بود.

    برای اطلاعات بیشتر، به پشتیبانی از دامنه‌های مرتبط در سایت اسناد Apple مراجعه کنید.

    فایل دامنه مرتبطی در همه دامنه‌های Firebase Hosting شما مستقر شده است. برای دسترسی به آن، به PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association بروید. این فایل AASA می‌تواند رونویسی شود؛ برای اطلاعات بیشتر، ایجاد و میزبانی فایل‌های پیکربندی «پیوندهای جامع» را ببینید.

  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. دامنه سفارشی را به دامنه مرتبط با برنامه‌تان پیوند دهید.
  3. پیوند اصالت‌سنجی به نشانی ایمیل کاربر ارسال کنید با شیء ActionCodeSettings به‌روزشده با دامنه سفارشی به‌عنوان linkDomain.
  1. می‌توانید از هرکدام از دامنه‌های Firebase Dynamic Links خود به‌عنوان دامنه سفارشی‌تان مجدداً استفاده کنید. بااین‌حال، هیچ‌کدام از عملکردهای Firebase Dynamic Links دیگر پشتیبانی نخواهند شد (برای مثال، اگر برنامه در دستگاه کاربران نصب نشده باشد، نمی‌توان آن‌ها را به فروشگاه برنامه‌ها هدایت کرد).
  2. ارسال پیوند اصالت‌سنجی به نشانی ایمیل کاربر با شیء ActionCodeSettings به‌روزشده با دامنه سفارشی به‌عنوان linkDomain.