افزودن Firebase به پروژه Apple

پیش‌نیازها

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

    • Xcode نسخه ۲۶.۲ یا بالاتر

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

    • پروژه شما باید این نسخه‌های پلاتفرم یا نسخه‌های جدیدتر را هدف قرار دهد:
      • iOS 15
      • macOS 11
      • tvOS 15
      • watchOS 8

  • یک دستگاه Apple فیزیکی راه‌اندازی کنید یا از شبیه‌ساز برای اجرای برنامه‌تان استفاده کنید.

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

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

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

مرحله ۲: ثبت برنامه در Firebase

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

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

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

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

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

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

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

مرحله ۳: افزودن فایل پیکربندی Firebase

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

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

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

مرحله ۴: افزودن کیت‌های توسعه نرم‌افزار Firebase به برنامه

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

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

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

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

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

مرحله ۵: مقداردهی اولیه Firebase در برنامه

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

  1. واحد FirebaseCore را در UIApplicationDelegate و همچنین هر واحد Firebase دیگری که نماینده برنامه‌تان استفاده می‌کند وارد کنید. برای مثال، برای استفاده از Cloud Firestore و Authentication:

    SwiftUI

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

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

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. اگر از 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()
      }
    }
  }
}
  4. اگر کیت توسعه نرم‌افزار Firebase را برای Google Analytics اضافه کرده‌اید، می‌توانید برنامه‌تان را اجرا کنید تا تأییدیه نصب موفق Firebase را به کنسول Firebase ارسال کنید.

تمام شد! می‌توانید از این مرحله رد شوید و به مراحل بعدی بروید.

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

کتابخانه‌های دردسترس

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

  • مستندات مرجع (Swift | Obj-C)

  • کیت توسعه نرم‌افزار Firebase برای پلاتفرم‌های Apple مخزن GitHub

خدمات یا محصول نام کتابخانه / چارچوب Analytics اضافه شود؟
AdMob GoogleMobileAds
Firebase AI Logic ۱
 FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (الزامی)
Firebase نصب FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect ۲ FirebaseDataConnect
کتابخانه‌های منسوخ‌شده یا پشتیبانی‌نشده
Dynamic Links FirebaseDynamicLinks
Firebase ML Custom Model APIs FirebaseMLModelDownloader

۱ Firebase AI Logic (FirebaseAILogic) قبلاً «Vertex AI در Firebase» نامیده می‌شد و تحت مدول FirebaseVertexAI توزیع می‌شد. Firebase AI Logic قبلاً تحت ماژول FirebaseAI نیز توزیع می‌شد.

۲ Firebase SQL Connect قبلاً «Firebase Data Connect» نامیده می‌شد.

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

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

چارچوب‌ها

علاوه‌بر پشتیبانی از پلاتفرم iOS، فایل zip اکنون شامل .xcframework فایل است. برای جزئیات، به فایل README کیت توسعه نرم‌افزار پلاتفرم‌های Apple در Firebase در GitHub مراجعه کنید.

  1. فایل فشرده کیت توسعه نرم‌افزار چارچوب را بارگیری کنید. این فایل حدود ۲۰۰ مگابایت است و ممکن است بارگیری آن کمی طول بکشد.

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

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

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

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

مراحل بعدی

آشنایی با Firebase:

افزودن سرویس‌های Firebase به برنامه:

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

  • با Analytics، اطلاعات آماری درباره رفتار کاربر به‌دست آورید.

  • اصالت‌سنجی کاربر را با Authentication راه‌اندازی کنید.

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

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

  • کد پسین را که در محیطی امن اجرا می‌شود با Cloud Functions راه‌اندازی کنید.

  • ارسال اعلان با Cloud Messaging.

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