انتقال پیوند ایمیل به سیستم به دور از 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 برای پروژه شما برای ایجاد پیوندهایی برای پیوند ایمیل و سایر اقدامات پیوند خارج از باند در برنامه‌های تلفن همراه استفاده می‌کند. این بدان معناست که برنامه شما نیز برای استفاده از این دامنه پیش‌فرض به عنوان دامنه مرتبط برای پیوندهای احراز هویت ایمیل به برنامه تلفن همراه شما، باید به‌روزرسانی شود.
از دستورالعمل‌های زیر برای مدیریت پیوندها از دامنه جدید استفاده کنید و به Firebase Authentication دستور دهید تا از دامنه Firebase Hosting برای تولید پیوندهای برنامه تلفن همراه در آینده شروع به استفاده از آن کند.
اگر می‌خواهید به استفاده از هر یک از دامنه‌های Firebase Hosting سفارشی خود یا حتی دامنه Firebase Dynamic Links سفارشی خود ادامه دهید تا دامنه جدید مرتبط شما باشد، با استفاده از دستورالعمل‌های بخش Customize Mobile Links ، مراحل را با دامنه مورد نظر مطابقت دهید که می‌خواهید استفاده کنید.
دامنه 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 را می توان رونویسی کرد. برای اطلاعات بیشتر به ایجاد و میزبانی فایل های پیکربندی پیوندهای جهانی خود مراجعه کنید.
پروژه خود را برای استفاده از پیوندهای جدید پیکربندی کنید.
هنگامی که برای مدیریت پیوندهای دامنه جدید آماده شدید، می توانید از Firebase Admin SDK برای به روز رسانی نحوه ایجاد پیوندهای ایمیل استفاده کنید و به پشتیبان ما دستور دهید تا با استفاده از دامنه Firebase Hosting جدید شروع به تولید پیوندها کند.
import{getAuth}from'firebase-admin/auth';constupdateEmailAuthDomain=async()=>{constupdateRequest={mobileLinksConfig:{domain:'HOSTING_DOMAIN',},};constprojectConfigManager=getAuth().projectConfigManager();try{constresponse=awaitprojectConfigManager.updateProjectConfig(updateRequest);// Updated project configconsole.log('Project configuration updated successfully:',response);}catch(error){console.error('Error updating the project:',error);}};
پیوند ایمیل را ارسال و بازخرید کنید.
لینک ورود به ایمیل را مانند قبل ارسال کنید. هنگامی که کاربر نهایی روی پیوند کلیک می کند، در صورت نصب به برنامه هدایت می شود تا ورود به سیستم تمام شود.
لینک های موبایل خود را سفارشی کنید
می توانید از دامنه Firebase Hosting سفارشی استفاده کنید یا از دامنه Firebase Dynamic Links سفارشی خود مجدداً به عنوان دامنه پیوندهای تلفن همراه جدید خود استفاده کنید.
از دامنه Firebase Dynamic Links سفارشی خود دوباره استفاده کنید
می‌توانید از هر یک از دامنه‌های Firebase Dynamic Links خود به عنوان دامنه سفارشی خود استفاده کنید. با این حال، هیچ گونه عملکرد Firebase Dynamic Links دیگر پشتیبانی نخواهد شد (به عنوان مثال، اگر برنامه روی دستگاه آنها نصب نشده باشد، کاربران نمی توانند به فروشگاه برنامه هدایت شوند).
تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Email link authentication previously relied on Firebase Dynamic Links, which will be\n[shut down on August 25, 2025](/support/dynamic-links-faq). We've published an\nalternative solution in the Firebase Authentication iOS SDK version 11.8.0+. If your\napp uses Firebase Dynamic Links, you should migrate your app to the new\nFirebase Hosting based system.\n\nMigrate your associated Firebase Dynamic Links domain to a Firebase Hosting domain\n\nMoving forward, rather than using a Firebase Dynamic Links domain, Firebase Authentication\nwill use the Firebase Hosting default domain for your project to create\nlinks for email link and other out-of-band link actions in mobile apps. This\nmeans that your app will also need to be updated to use this default domain as\nthe associated domain for email authentication links to your mobile app.\n\nYou can follow the instructions in\n[Authenticate with Firebase Using Email Link on Apple Platforms](/docs/auth/ios/email-link-auth)\nto update your app to use the new automatically provisioned Firebase Hosting\ndefault domain.\n\nUse the following instructions to handle links from the new domain and to\ninstruct Firebase Authentication to start using the Firebase Hosting domain to\ngenerate mobile app links going forward.\n\nIf you'd like to continue using any of your custom Firebase Hosting domains\nor even your custom Firebase Dynamic Links domain to be your new associated domain,\nusing the instructions in the [Customize Mobile Links](#customize-mobile-links)\nsection, adapt the steps to match the intended domain you'd like to use.\n\n1. **Link Firebase Hosting domain to your app associated domain.**\n\n You'll need to configure the selected domain as an Associated Domain for\n app links. To set up the entitlement in your app, open the target's\n **Signing \\& Capabilities** tab in Xcode and add Firebase Hosting domains\n from the previous step to the Associated Domains capability. If using the\n default Firebase Hosting domain, this will be\n `applinks:`\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`.firebaseapp.com`.\n\n See [Supporting associated domains](https://developer.apple.com/documentation/xcode/supporting-associated-domains)\n on Apple's documentation site for more information.\n\n An associated domain file has been deployed under all your\n Firebase Hosting domains. To access it, navigate to\n \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`.firebaseapp.com/.well-known/apple-app-site-association`.\n This AASA file can be overwritten; see\n [Create and host your Universal Links configuration files](/support/guides/app-links-universal-links#create_and_host_your_universal_links_configuration_files_on_your_new_hosting_domain)\n for more information.\n | **Important:** To ensure a seamless rollback, we recommend keeping your existing intent filter that handles Firebase Dynamic Links while trying out the Firebase Hosting link solution. The Firebase Dynamic Links solution will be available until August 25, 2025.\n2. **Configure your project to use the new links.**\n\n When you're ready to handle the new domain links, you can use the\n [Firebase Admin SDK](/docs/admin/setup) to update how you want email links\n to be generated and instruct our backend to start generating links using the\n new Firebase Hosting domain. \n\n import { getAuth } from 'firebase-admin/auth';\n\n const updateEmailAuthDomain = async () =\u003e {\n const updateRequest = {\n mobileLinksConfig: {\n domain: 'HOSTING_DOMAIN',\n },\n };\n\n const projectConfigManager = getAuth().projectConfigManager();\n\n try {\n const response = await projectConfigManager.updateProjectConfig(updateRequest);\n // Updated project config\n console.log('Project configuration updated successfully:', response);\n } catch (error) {\n console.error('Error updating the project:', error);\n }\n };\n\n | **Important:** To rollback to the Firebase Dynamic Links while implementing and testing the backup solution, you should set the domain back to `FIREBASE_DYNAMIC_LINK`. The Firebase Dynamic Links solution will be available until August 25, 2025.\n3. **Send and redeem the email link.**\n\n Send the email sign-in link as before. When an end user clicks on the link,\n they will be redirected to the app if installed to finish the sign in.\n\nCustomize your mobile links\n\nYou can use a custom Firebase Hosting domain or reuse your custom\nFirebase Dynamic Links domain to be your new mobile links domain.\n\nUse a custom Firebase Hosting domain\n\n1. Follow the [Firebase Hosting guide](/docs/hosting/custom-domain) to set up a custom domain.\n2. Link the custom domain to your app associated domain.\n3. [Send an authentication link to the user's email address](/docs/auth/ios/email-link-auth#send_an_authentication_link_to_the_users_email_address) with an updated `ActionCodeSettings` object with a custom domain as `linkDomain`.\n\nRe-use your custom Firebase Dynamic Links domain\n\n1. You can re-use any of your Firebase Dynamic Links domains as your custom domain. However, any Firebase Dynamic Links functionality will no longer be supported (for example, users cannot be redirected to the app store if app isn't installed on their device).\n2. [Send an authentication link to the user's email address](/docs/auth/ios/email-link-auth#send_an_authentication_link_to_the_users_email_address) with an updated `ActionCodeSettings` object with a custom domain as `linkDomain`."]]
