Firebase را به پروژه اپل خود اضافه کنید

پیش‌نیازها

  • موارد زیر را نصب کنید:

    • ایکس‌کد ۱۶.۲ یا بالاتر

  • مطمئن شوید که پروژه شما این الزامات را برآورده می‌کند:

    • پروژه شما باید این نسخه‌های پلتفرم یا نسخه‌های جدیدتر را هدف قرار دهد:
      • آی‌او‌اس ۱۳
      • مک‌او‌اس ۱۰.۱۵
      • تی‌وی‌او‌اس ۱۳
      • واچ او اس ۷

  • یک دستگاه فیزیکی اپل راه‌اندازی کنید یا از یک شبیه‌ساز برای اجرای برنامه خود استفاده کنید.

اگر از قبل پروژه Xcode ندارید و فقط می‌خواهید یک محصول Firebase را امتحان کنید، می‌توانید یکی از نمونه‌های شروع سریع ما را دانلود کنید.

مرحله ۱ : ایجاد یک پروژه Firebase

قبل از اینکه بتوانید Firebase را به برنامه اپل خود اضافه کنید، باید یک پروژه Firebase برای اتصال به برنامه خود ایجاد کنید. برای کسب اطلاعات بیشتر در مورد پروژه‌های Firebase، به بخش «درک پروژه‌های Firebase» مراجعه کنید.

مرحله ۲ : برنامه خود را در Firebase ثبت کنید

برای استفاده از فایربیس در برنامه اپل خود، باید برنامه خود را در پروژه فایربیس خود ثبت کنید. ثبت برنامه شما اغلب "افزودن" برنامه شما به پروژه شما نامیده می‌شود.

  1. به کنسول Firebase بروید.

  2. در مرکز صفحه نمای کلی پروژه، روی آیکون iOS+ کلیک کنید تا گردش کار راه‌اندازی شود.

    اگر قبلاً برنامه‌ای به پروژه Firebase خود اضافه کرده‌اید، برای نمایش گزینه‌های پلتفرم، روی «افزودن برنامه» کلیک کنید.

  3. شناسه بسته برنامه خود را در فیلد شناسه بسته وارد کنید.

  4. (اختیاری) سایر اطلاعات برنامه را وارد کنید: نام مستعار برنامه و شناسه فروشگاه برنامه .

  5. روی ثبت برنامه کلیک کنید.

مرحله 3 : یک فایل پیکربندی Firebase اضافه کنید

  1. برای دریافت فایل پیکربندی Firebase برنامه خود ( GoogleService-Info.plist ) روی دانلود GoogleService-Info.plist کلیک کنید.

  2. فایل پیکربندی خود را به ریشه پروژه Xcode خود منتقل کنید. در صورت درخواست، گزینه افزودن فایل پیکربندی به همه اهداف را انتخاب کنید.

اگر چندین شناسه بسته در پروژه خود دارید، باید هر شناسه بسته را با یک برنامه ثبت شده در کنسول Firebase مرتبط کنید تا هر برنامه بتواند فایل GoogleService-Info.plist مخصوص به خود را داشته باشد.

مرحله ۴ : اضافه کردن SDK های فایربیس به برنامه شما

برای نصب و مدیریت وابستگی‌های Firebase از Swift Package Manager استفاده کنید.

  1. در Xcode، با باز کردن پروژه برنامه خود، به File > Add Packages بروید.
  2. وقتی از شما خواسته شد، مخزن SDK پلتفرم‌های اپل فایربیس را اضافه کنید: 
    3.   https://github.com/firebase/firebase-ios-sdk
  3. نسخه SDK مورد نظر خود را انتخاب کنید.

  4. کتابخانه‌های فایربیس مورد نظر خود را انتخاب کنید.

    اگر Google Analytics در پروژه فایربیس شما فعال است، حتماً FirebaseAnalytics اضافه کنید. این کار تمام ویژگی‌های تحلیلی را ارائه می‌دهد. همچنین می‌توانید ویژگی‌های جداگانه را انتخاب کنید؛ به سوالات متداول ما در مورد آخرین سازماندهی ماژول‌ها در Google Analytics برای Firebase SDK مراجعه کنید.

پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی‌های شما در پس‌زمینه می‌کند.

مرحله 5 : Firebase را در برنامه خود مقداردهی اولیه کنید

مرحله آخر، اضافه کردن کد مقداردهی اولیه به برنامه شماست. ممکن است قبلاً این کار را به عنوان بخشی از اضافه کردن Firebase به برنامه خود انجام داده باشید. اگر از یک پروژه نمونه Quickstart استفاده می‌کنید، این کار برای شما انجام شده است.

  1. ماژول FirebaseCore را در UIApplicationDelegate خود وارد کنید، و همچنین هر ماژول Firebase دیگری که app delegate شما از آن استفاده می‌کند. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :

    سویفت‌یو‌آی 

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    سویفت 

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    هدف-سی 

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. یک نمونه اشتراکی FirebaseApp در متد application(_:didFinishLaunchingWithOptions:) از نماینده برنامه خود پیکربندی کنید:

    سویفت‌یو‌آی 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    سویفت 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    هدف-سی 

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. اگر از SwiftUI استفاده می‌کنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق UIApplicationDelegateAdaptor یا NSApplicationDelegateAdaptor به ساختار App خود پیوست کنید. همچنین باید swizzling نماینده برنامه را غیرفعال کنید. برای اطلاعات بیشتر، به دستورالعمل‌های SwiftUI مراجعه کنید.

    سویفت‌یو‌آی 

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. اگر Firebase SDK را برای Google Analytics نصب کرده‌اید، می‌توانید برنامه خود را اجرا کنید تا تأیید نصب موفقیت‌آمیز Firebase به کنسول Firebase ارسال شود.

همین! می‌توانید از مراحل بعدی صرف نظر کنید.

اگر در راه‌اندازی مشکل دارید، به بخش عیب‌یابی و سوالات متداول پلتفرم‌های اپل مراجعه کنید.

کتابخانه‌های موجود

این بخش محصولات Firebase پشتیبانی شده برای پلتفرم‌های اپل را فهرست می‌کند. درباره این کتابخانه‌های پلتفرم Firebase اپل بیشتر بدانید:

خدمات یا محصول غلاف‌ها کتابخانه‌های SwiftPM اضافه کردن آنالیز؟
AdMob pod 'Google-Mobile-Ads-SDK' ناموجود
منطق هوش مصنوعی فایربیس ۱
 pod 'FirebaseAI' FirebaseAI
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
Data Connect ناموجود FirebaseDataConnect
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
کتابخانه‌های منسوخ‌شده یا پشتیبانی‌نشده
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks

منطق هوش مصنوعی فایربیس قبلاً « هوش مصنوعی ورتکس در فایربیس » نامیده می‌شد و شامل pod 'FirebaseVertexAI' و کتابخانه SwiftPM FirebaseVertexAI بود.

بدون استفاده از Swift Package Manager ادغام کنید

اگر نمی‌خواهید از Swift Package Manager استفاده کنید، همچنان می‌توانید با استفاده از CocoaPods یا با وارد کردن مستقیم فریم‌ورک‌ها، از SDK های Firebase بهره ببرید.

کوکوپادز

برای اطلاعات بیشتر در مورد ادغام CocoaPods به راهنمای ما مراجعه کنید.

چارچوب‌ها

علاوه بر پشتیبانی از پلتفرم iOS، این فایل فشرده اکنون شامل فایل‌های .xcframework نیز می‌شود. برای جزئیات بیشتر، به فایل راهنمای SDK پلتفرم‌های اپل فایربیس در گیت‌هاب مراجعه کنید.

  1. فایل فشرده SDK فریمورک را دانلود کنید. حجم این فایل حدود ۲۰۰ مگابایت است و ممکن است دانلود آن کمی طول بکشد.

  2. فایل را از حالت فشرده خارج کنید و سپس فریم‌ورک‌هایی را که می‌خواهید در برنامه خود بگنجانید، ادغام کنید.

    می‌توانید دستورالعمل‌های ادغام را در هر یک از مکان‌های زیر پیدا کنید:

    برای اطلاعات مربوط به نسخه‌های چارچوب یا وابستگی‌ها، به فایل METADATA.md که در فایل فشرده دانلود شده قرار دارد، مراجعه کنید.

  3. پرچم پیونددهنده‌ی -ObjC را در Other Linker Flags در تنظیمات ساخت هدف خود اضافه کنید.

مراحل بعدی

آشنایی با فایربیس:

سرویس‌های فایربیس را به برنامه خود اضافه کنید:

  • با استفاده از منطق هوش مصنوعی فایربیس، ویژگی‌های هوش مصنوعی مولد را با مدل‌های Gemini و Imagen بسازید.

  • با استفاده Analytics بینشی در مورد رفتار کاربر به دست آورید.

  • احراز هویت کاربر را با استفاده از Authentication تنظیم کنید.

  • داده‌ها، مانند اطلاعات کاربر، را با Cloud Firestore یا Realtime Database ذخیره کنید.

  • فایل‌هایی مانند عکس‌ها و ویدیوها را با Cloud Storage ذخیره کنید.

  • کد بک‌اند را فعال کنید که در یک محیط امن با Cloud Functions اجرا می‌شود.

  • ارسال اعلان‌ها با Cloud Messaging

  • با Crashlytics بفهمید چه زمانی و چرا برنامه‌تان از کار می‌افتد.