عیب یابی & سوالات متداول برای پلتفرم های اپل و Firebase

فایربیس از چه نسخه‌هایی از Xcode پشتیبانی می‌کند؟

فایربیس تا دو نسخه اصلی Xcode را پشتیبانی می‌کند، البته به جز نسخه‌هایی از Xcode که اپل دیگر از آنها پشتیبانی نمی‌کند. برای مثال، از مارس ۲۰۱۹، اپل حداقل iOS 12 را برای همه برنامه‌ها الزامی کرد، به این معنی که پشتیبانی از Xcode 9 حذف شد و Xcode 10 تنها نسخه اصلی پشتیبانی شده بود.

تغییرات در پشتیبانی از نسخه‌های جزئی یا وصله‌های خاص Xcode (به عنوان مثال، ۹.۲.۰ تا ۹.۴.۱) بر اساس نیازهای SDK پلتفرم‌های اپل Firebase و بررسی میزان استفاده توسعه‌دهندگان تعیین می‌شوند. این تغییرات در یادداشت‌های انتشار SDK پلتفرم‌های اپل Firebase و در صفحه تنظیمات SDK پلتفرم‌های اپل Firebase منعکس شده‌اند.

برای مشاهده حداقل نسخه Xcode پشتیبانی شده توسط SDK، الزامات ذکر شده در Add Firebase to your Apple project را بررسی کنید.

پشتیبانی فایربیس برای نسخه‌های بتای Xcode بر اساس «بهترین تلاش» در دسترس است. توسعه‌دهندگان می‌توانند مشکلات را در مخزن SDK پلتفرم‌های اپل فایربیس در گیت‌هاب پیگیری و ارسال کنند.

برنامه من در macOS برای دسترسی به آیتم‌های Keychain از کاربر رمز عبور می‌خواهد. چگونه می‌توانم این مشکل را حل کنم؟

وابستگی Firebase خود را به نسخه ۹.۶.۰ یا بالاتر ارتقا دهید و قابلیت [Keychain Sharing capability](/docs/ios/troubleshooting-faq#macos-keychain-sharing) را به هدف خود اضافه کنید.

چرا فایربیس به قابلیت اشتراک‌گذاری Keychain در macOS نیاز دارد؟

کیت‌های توسعه نرم‌افزار Firebase از keychain برای ذخیره اطلاعاتی مانند شناسه نصب Firebase که برای FCM استفاده می‌شود، استفاده می‌کنند. بدون دسترسی به Keychain، کیت‌های توسعه نرم‌افزار Firebase ممکن است به درستی کار نکنند. keychain مک‌او‌اس متفاوت از keychain به سبک iOS که در سایر پلتفرم‌ها (iOS، tvOS، macCatalyst و watchOS) استفاده می‌شود، رفتار می‌کند.

در macOS، برنامه‌ها از یک keychain مشترک استفاده می‌کنند که ممکن است توسط برنامه‌ها و فرآیندهای دیگر تغییر کند. برخلاف iOS، هیچ keychain سندباکس‌شده‌ای وجود ندارد که برنامه به طور ضمنی به آن دسترسی داشته باشد. بنابراین، هنگامی که یک برنامه مک با keychain تعامل می‌کند، سیستم از کاربر درخواست دسترسی می‌کند، زیرا ممکن است برنامه مک در حال تغییر یک آیتم keychain باشد که خود ایجاد نکرده است. برای رفع این اختلاف، Firebase با کلید kSecUseDataProtectionKeychain از keychain پرس‌وجو می‌کند، که به برنامه می‌گوید یک آیتم keychain را که بخشی از یک گروه دسترسی keychain است، پرس‌وجو کند (این رفتار پیش‌فرض در سایر پلتفرم‌ها است). قابلیت اشتراک‌گذاری Keychain مورد نیاز است زیرا برنامه برای ترکیب یک گروه دسترسی که می‌تواند بین اهداف خود به اشتراک گذاشته شود، به آن نیاز دارد و در نتیجه به برنامه اجازه می‌دهد تا آزادانه به آیتم‌های keychain در گروه دسترسی دسترسی داشته باشد.

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

در نسخه‌های ۱۳ و بالاتر Xcode، چرا برنامه‌های UIKit من نمی‌توانند برخی از URLهایی را که ثبت کرده‌ام باز کنند؟
در Info.plist من؟

اپل محدودیت ۵۰ ورودی LSApplicationQueriesSchemes را در فایل‌های Info.plist معرفی کرد. در سال ۲۰۱۵، اپل LSApplicationQueriesSchemes برای محدود کردن تعداد کوئری‌های URL که هر برنامه می‌توانست ایجاد کند، معرفی کرد. با انتشار Xcode 13، این محدودیت‌ها اعمال می‌شوند، در حالی که در Xcode 12 و قبل از آن هیچ محدودیت موثری برای تعداد طرح‌ها وجود نداشت.

برخی از محصولات Firebase، مانند Firebase Authentication و Firebase Dynamic Links ، برای هدایت به برنامه شما نیاز به استفاده از طرح‌های URL سفارشی دارند. این URLها از یک طرح URL مختصر و سازگار پیروی می‌کنند که نباید در برابر محدودیت طرح 50 لینکی، به طور قابل توجهی حساب شود.

توجه داشته باشید که برای برنامه‌هایی که به ثبت بیش از ۵۰ LSApplicationQueriesSchemes ادامه می‌دهند، برخی از طرح‌ها به طور پنهانی نادیده گرفته می‌شوند. بسته به ترتیب اضافه شدن لینک‌های عمیق، ممکن است برنامه قادر به اجرای آنها نباشد.