پیش نیازها
موارد زیر را نصب کنید:
- Xcode 15.2 یا بالاتر
اطمینان حاصل کنید که پروژه شما این شرایط را برآورده می کند:
- پروژه شما باید این نسخه های پلتفرم یا جدیدتر را هدف قرار دهد:
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- پروژه شما باید این نسخه های پلتفرم یا جدیدتر را هدف قرار دهد:
یک دستگاه اپل فیزیکی را راه اندازی کنید یا از یک شبیه ساز برای اجرای برنامه خود استفاده کنید.
برای Cloud Messaging در پلتفرمهای اپل، پیشنیازها در اینجا آمده است:
- یک دستگاه فیزیکی اپل را تنظیم کنید.
- یک کلید تأیید اعتبار Apple Push Notification برای حساب Apple Developer خود دریافت کنید.
- Push Notifications را در Xcode در قسمت App > Capabilities فعال کنید.
- با استفاده از حساب Google خود وارد Firebase شوید .
اگر قبلاً پروژه Xcode ندارید و فقط میخواهید یک محصول Firebase را امتحان کنید، میتوانید یکی از نمونههای شروع سریع ما را دانلود کنید.
مرحله 1 : یک پروژه Firebase ایجاد کنید
قبل از اینکه بتوانید Firebase را به برنامه Apple خود اضافه کنید، باید یک پروژه Firebase برای اتصال به برنامه خود ایجاد کنید. برای کسب اطلاعات بیشتر در مورد پروژه های Firebase، از Understand Firebase Projects دیدن کنید.
مرحله 2 : برنامه خود را با Firebase ثبت کنید
برای استفاده از Firebase در برنامه Apple خود، باید برنامه خود را در پروژه Firebase خود ثبت کنید. ثبت برنامه شما اغلب "افزودن" برنامه شما به پروژه شما نامیده می شود.
به کنسول Firebase بروید.
در مرکز صفحه نمای کلی پروژه، روی نماد iOS+ کلیک کنید تا گردش کار راه اندازی شود.
اگر قبلاً برنامهای را به پروژه Firebase خود اضافه کردهاید، روی افزودن برنامه کلیک کنید تا گزینههای پلتفرم نمایش داده شوند.
شناسه بسته نرم افزاری خود را در قسمت شناسه بسته وارد کنید.
شناسه بسته نرم افزاری به طور منحصر به فرد یک برنامه را در اکوسیستم اپل شناسایی می کند.
شناسه بسته خود را پیدا کنید: پروژه خود را در Xcode باز کنید، برنامه سطح بالا را در ناوبر پروژه انتخاب کنید، سپس برگه General را انتخاب کنید.
مقدار فیلد Bundle Identifier ، شناسه بسته است (به عنوان مثال،
com.yourcompany.yourproject
).توجه داشته باشید که مقدار ID بسته به حروف کوچک و بزرگ حساس است و نمیتوان آن را برای این برنامه Firebase پس از ثبت در پروژه Firebase تغییر داد.
(اختیاری) اطلاعات دیگر برنامه را وارد کنید: نام مستعار برنامه و شناسه فروشگاه App .
نام مستعار برنامه : یک شناسه داخلی و راحت که فقط برای شما در کنسول Firebase قابل مشاهده است
شناسه فروشگاه App : توسط Firebase Dynamic Links برای هدایت کاربران به صفحه App Store شما و توسط Google Analytics برای وارد کردن رویدادهای تبدیل به Google Ads استفاده میشود. اگر برنامه شما هنوز شناسه فروشگاه App ندارد، میتوانید شناسه را بعداً در تنظیمات پروژه خود اضافه کنید.
روی ثبت برنامه کلیک کنید.
مرحله 3 : یک فایل پیکربندی Firebase اضافه کنید
برای دریافت فایل پیکربندی پلتفرم های اپل Firebase (
GoogleService-Info.plist
) روی Download GoogleService-Info.plist کلیک کنید.فایل پیکربندی Firebase حاوی شناسههای منحصر به فرد، اما غیر مخفی برای پروژه شما است. برای کسب اطلاعات بیشتر در مورد این فایل پیکربندی، از Understand Firebase Projects دیدن کنید.
میتوانید فایل پیکربندی Firebase خود را دوباره در هر زمانی دانلود کنید.
مطمئن شوید که نام فایل پیکربندی با کاراکترهای اضافی مانند
(2)
اضافه نشده باشد.
فایل پیکربندی خود را به ریشه پروژه Xcode خود منتقل کنید. اگر از شما خواسته شد، انتخاب کنید تا فایل پیکربندی را به همه اهداف اضافه کنید.
اگر چندین شناسه بسته در پروژه خود دارید، باید هر ID بسته را با یک برنامه ثبت شده در کنسول Firebase مرتبط کنید تا هر برنامه بتواند فایل GoogleService-Info.plist
خود را داشته باشد.
مرحله 4 : SDK های Firebase را به برنامه خود اضافه کنید
برای نصب و مدیریت وابستگی های Firebase از Swift Package Manager استفاده کنید.
- در Xcode، با باز بودن پروژه برنامه، به File > Add Packages بروید.
- وقتی از شما خواسته شد، مخزن SDK پلتفرم های Apple Firebase را اضافه کنید:
- نسخه SDK را که می خواهید استفاده کنید انتخاب کنید.
کتابخانه های Firebase را که می خواهید استفاده کنید انتخاب کنید.
اگر Google Analytics در پروژه Firebase شما فعال است، حتما
FirebaseAnalytics
را اضافه کنید. برای Analytics بدون قابلیت جمع آوری IDFA، به جای آنFirebaseAnalyticsWithoutAdId
را اضافه کنید.
https://github.com/firebase/firebase-ios-sdk
پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی های شما در پس زمینه می کند.
مرحله 5 : Firebase را در برنامه خود راه اندازی کنید
مرحله آخر اضافه کردن کد اولیه به برنامه شما است. ممکن است قبلاً این کار را به عنوان بخشی از افزودن Firebase به برنامه خود انجام داده باشید. اگر از پروژه نمونه شروع سریع استفاده می کنید، این کار برای شما انجام شده است.
- ماژول
FirebaseCore
را درUIApplicationDelegate
خود و همچنین هر ماژول Firebase دیگری که نماینده برنامه شما استفاده میکند، وارد کنید. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
سویفت
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
هدف-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- یک نمونه اشتراکگذاری شده
FirebaseApp
را درapplication(_:didFinishLaunchingWithOptions:)
پیکربندی کنید:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
سویفت
// Use Firebase library to configure APIs FirebaseApp.configure()
هدف-C
// Use Firebase library to configure APIs [FIRApp configure];
- اگر از SwiftUI استفاده میکنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق
UIApplicationDelegateAdaptor
یاNSApplicationDelegateAdaptor
به ساختارApp
خود متصل کنید. همچنین باید swizzling نمایندگی برنامه را غیرفعال کنید. برای اطلاعات بیشتر، دستورالعمل های SwiftUI را ببینید.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- اگر Firebase SDK را برای Google Analytics اضافه کردهاید، میتوانید برنامه خود را اجرا کنید تا تأییدیه به کنسول Firebase ارسال کنید که Firebase را با موفقیت نصب کردهاید.
همین! می توانید به مراحل بعدی بروید.
اگر برای راهاندازی مشکل دارید، به عیبیابی پلتفرمهای اپل و سؤالات متداول مراجعه کنید.
کتابخانه های موجود
این بخش محصولات Firebase را که برای پلتفرم های اپل پشتیبانی می شوند فهرست می کند. درباره این کتابخانه های پلتفرم Apple Firebase بیشتر بدانید:
Firebase پلتفرم اپل مخزن SDK GitHub
خدمات یا محصول | غلاف | کتابخانه های SwiftPM | Google Analytics .">Add Analytics ? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | N/A | |
Analytics | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
App Check | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
App Distribution | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
Authentication | pod 'FirebaseAuth' | FirebaseAuth | |
Cloud Firestore | pod 'FirebaseFirestore' | FirebaseFirestore | |
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' | FirebaseFunctions | |
Cloud Messaging | pod 'FirebaseMessaging' | FirebaseMessaging | |
Cloud Storage | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
Dynamic Links | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
In-App Messaging | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (الزامی) |
تاسیسات Firebase | pod 'FirebaseInstallations' | FirebaseInstallations | |
APIهای مدل سفارشی Firebase ML | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
Performance Monitoring | pod 'FirebasePerformance' | FirebasePerformance | |
Realtime Database | pod 'FirebaseDatabase' | FirebaseDatabase | |
Remote Config | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig | |
Vertex AI in Firebase | N/A | FirebaseVertexAI-Preview |
بدون استفاده از Swift Package Manager یکپارچه سازی کنید
اگر نمیخواهید از Swift Package Manager استفاده کنید، همچنان میتوانید با استفاده از CocoaPods یا با وارد کردن مستقیم فریمورکها، از مزایای Firebase SDK استفاده کنید.
CocoaPods
در راهنمای ما درباره ادغام CocoaPods بیشتر بیاموزید.
چارچوب ها
علاوه بر پشتیبانی از پلتفرم iOS، فایل فشرده اکنون شامل فایلهای .xcframework
. میشود. برای جزئیات، به پلتفرم Firebase Apple SDK README در GitHub مراجعه کنید.
فریمورک SDK zip را دانلود کنید. این یک فایل 200 مگابایتی است و دانلود آن ممکن است کمی طول بکشد.
فایل را از حالت فشرده خارج کنید و سپس چارچوب هایی را که می خواهید در برنامه خود قرار دهید ادغام کنید.
می توانید دستورالعمل های یکپارچه سازی را در یکی از مکان های زیر بیابید:
- در مخزن Firebase iOS SDK GitHub .
- در فایل
README.md
در توزیع فشرده دانلود شده.
برای اطلاعات در مورد نسخههای چارچوب یا وابستگیها، به فایل
METADATA.md
در توزیع فشرده دانلود شده مراجعه کنید.پرچم پیوند دهنده
-ObjC
را درOther Linker Settings
خود در تنظیمات ساخت هدف خود اضافه کنید.
مراحل بعدی
درباره Firebase بیاموزید:
برای کسب اطلاعات بیشتر درباره پروژههای Firebase و بهترین روشها برای پروژهها، از Understand Firebase Projects دیدن کنید.
نمونه برنامه های Firebase را کاوش کنید.
با Firebase iOS Codelab تجربه عملی داشته باشید.
کد منبع باز را در GitHub کاوش کنید.
برای راه اندازی برنامه خود آماده شوید:
- هشدارهای بودجه را برای پروژه خود در کنسول Google Cloud تنظیم کنید.
- داشبورد استفاده و صورتحساب را در کنسول Firebase نظارت کنید تا تصویری کلی از استفاده از پروژه خود در چندین سرویس Firebase داشته باشید.
- چک لیست راه اندازی Firebase را مرور کنید.
آیا با Firebase و پروژه اپل خود مشکل دارید؟ از عیبیابی و پرسشهای متداول پلتفرمهای اپل دیدن کنید.
خدمات Firebase را به برنامه خود اضافه کنید:
با Analytics در مورد رفتار کاربر اطلاعاتی کسب کنید.
احراز هویت کاربر را با Authentication تنظیم کنید.
دادهها مانند اطلاعات کاربر را با Cloud Firestore یا Realtime Database ذخیره کنید.
فایلها، مانند عکسها و ویدیوها را با Cloud Storage ذخیره کنید.
کد باطن را فعال کنید که در یک محیط امن با Cloud Functions اجرا می شود.
ارسال اعلان ها با Cloud Messaging .
با Crashlytics متوجه شوید که چه زمانی و چرا برنامه شما از کار می افتد.