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

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

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

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

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

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

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

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

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

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

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

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

    وقتی آماده مدیریت لینک‌های دامنه جدید شدید، می‌توانید از 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);
    }
};

  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 ارسال کنید.