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

احراز هویت پیوند ایمیل قبلاً به Firebase Dynamic Links متکی بود که در 25 آگوست 2025 بسته خواهد شد. ما یک راه حل جایگزین را در Firebase Authentication iOS SDK نسخه 11.8.0+ منتشر کرده ایم. اگر برنامه شما از Firebase Dynamic Links استفاده می کند، باید برنامه خود را به سیستم جدید مبتنی بر Firebase Hosting منتقل کنید.

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

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

می‌توانید دستورالعمل‌های Authenticate with Firebase با استفاده از پیوند ایمیل در پلتفرم‌های Apple را دنبال کنید تا برنامه خود را برای استفاده از دامنه پیش‌فرض 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 قابل بازنویسی است. برای اطلاعات بیشتر به ایجاد و میزبانی فایل های پیکربندی پیوندهای جهانی خود مراجعه کنید.

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

    هنگامی که برای مدیریت پیوندهای دامنه جدید آماده شدید، می توانید از Firebase Admin SDK برای به روز رسانی نحوه ایجاد پیوندهای ایمیل استفاده کنید و به پشتیبان ما دستور دهید تا با استفاده از دامنه 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 ارسال کنید.