Google is committed to advancing racial equity for Black communities. See how.
این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.
Switch to English

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

پیش نیازها

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

    • Xcode 11.0 یا بالاتر
    • CocoaPods 1.4.0 یا بالاتر
  • اطمینان حاصل کنید که پروژه شما از این شرایط برخوردار است:

    • پروژه شما باید iOS 8 یا بالاتر را هدف قرار دهد.
  • برای اجرای برنامه خود ، یک دستگاه فیزیکی iOS راه اندازی کنید یا از شبیه ساز iOS استفاده کنید.

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

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

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

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

بعد از اینکه یک پروژه Firebase دارید ، می توانید برنامه iOS خود را به آن اضافه کنید.

برای کسب اطلاعات بیشتر در مورد بهترین روش ها و ملاحظات برای افزودن برنامه ها به یک پروژه Firebase ، از جمله نحوه مدیریت چندین نسخه ساخت ، از پروژه های Firebase درک کنید.

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

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

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

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

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

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

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

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

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

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

مرحله 4 : SDK های Firebase را به برنامه خود اضافه کنید

توصیه می کنیم از CocoaPods برای نصب کتابخانه های Firebase استفاده کنید. با این حال ، اگر ترجیح می دهید از CocoaPods استفاده نکنید ، می توانید چارچوب های SDK را مستقیماً ادغام کنید یا از Swift Package Manager (بتا) استفاده کنید .

آیا شما از یکی از نمونه های سریع شروع استفاده می کنید ؟ پروژه Xcode و Podfile (با غلاف) از قبل وجود دارد ، اما هنوز هم باید فایل پیکربندی Firebase خود را اضافه کنید و غلاف ها را نصب کنید .

  1. اگر از قبل یک Podfile ندارید:

    cd your-project-directory
    pod init
  2. به Podfile خود ، غلافهای Firebase را که می خواهید در برنامه خود استفاده کنید اضافه کنید.

    می توانید هر یک از محصولات Firebase پشتیبانی شده را به برنامه iOS خود اضافه کنید.

    تجزیه و تحلیل فعال است

    # Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'

    تجزیه و تحلیل فعال نیست

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'Firebase/Auth'
    pod 'Firebase/Firestore'
  3. غلاف ها را نصب کنید ، سپس فایل .xcworkspace خود را باز کنید تا پروژه را در Xcode مشاهده کنید:

    pod install
    open your-project.xcworkspace

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

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

  1. ماژول Firebase را در UIApplicationDelegate خود وارد کنید:

    سریع

    import Firebase

    هدف-C

    @import Firebase;
  2. نمونه اشتراکی FirebaseApp پیکربندی کنید ، معمولاً در برنامه برنامه شما application:didFinishLaunchingWithOptions: روش:

    سریع

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

    هدف-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. اگر Firebase Analytics را وارد کرده باشید ، می توانید برنامه خود را برای ارسال تأیید به کنسول Firebase که Firebase را با موفقیت نصب کرده اید ، اجرا کنید.

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

غلاف های موجود

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

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

  • نسخه ی نمایشی Firebase iOS SDK GitHub

خدمات یا محصول غلافها تجزیه و تحلیل اضافه شود؟
AdMob pod 'Google-Mobile-Ads-SDK'
تجزیه و تحلیل pod 'Firebase/Analytics'
توزیع برنامه pod 'Firebase/AppDistribution'
احراز هویت pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
عملکردهای Cloud برای Firebase Client SDK pod 'Firebase/Functions'
پیام رسانی ابری pod 'Firebase/Messaging'
فضای ذخیره ابری pod 'Firebase/Storage'
Firebase Crashlytics pod 'Firebase/Crashlytics'
پیوندهای پویا pod 'Firebase/DynamicLinks'
پیام در برنامه pod 'Firebase/InAppMessaging'
(ضروری)
API های Firebase ML Vision pod 'Firebase/MLVision'
API های مدل سفارشی Firebase ML pod 'Firebase/MLModelInterpreter'
نظارت بر عملکرد pod 'Firebase/Performance'
پایگاه داده بیدرنگ pod 'Firebase/Database'
پیکربندی از راه دور pod 'Firebase/RemoteConfig'

منسوخ:

خدمات یا محصول غلافها جزئیات
کیت ML برای Firebase: مدل برچسب گذاری تصویر pod 'Firebase/MLVisionLabelModel' راهنمای مهاجرت
کیت ML برای Firebase: مدل اسکن بارکد pod 'Firebase/MLVisionBarcodeModel' راهنمای مهاجرت
ML Kit for Firebase: مدل تشخیص متن pod 'Firebase/MLVisionTextModel' راهنمای مهاجرت
کیت ML برای Firebase: مدل تشخیص چهره pod 'Firebase/MLVisionFaceModel' راهنمای مهاجرت
ML Kit for Firebase: مدل ردیابی و ردیابی شیject pod 'Firebase/MLVisionObjectDetection' راهنمای مهاجرت
ML Kit for Firebase: API های زبان طبیعی pod 'Firebase/MLNaturalLanguage' راهنمای مهاجرت
ML Kit for Firebase: مدل شناسایی زبان pod 'Firebase/MLNLLanguageID' راهنمای مهاجرت
ML Kit for Firebase: ترجمه مدل pod 'Firebase/MLNLTranslate' راهنمای مهاجرت
ML Kit for Firebase: مدل پاسخ هوشمند pod 'Firebase/MLNLSmartReply' راهنمای مهاجرت
ML Kit for Firebase: AutoML Vision Edge API pod 'Firebase/MLVisionAutoML' راهنمای مهاجرت

بدون CocoaPods ادغام شوید

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

چارچوب ها

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

  1. فریم ورک SDK zip را بارگیری کنید. این پرونده 200 مگابایت است و بارگیری آن ممکن است مدتی طول بکشد.

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

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

مدیر بسته سوئیفت

پشتیبانی Swift Package Manager در حال حاضر در بتا است. اسناد موجود در GitHub را دنبال کنید و هرگونه بازخورد را برای ردیاب مسئله GitHub ارسال کنید .

مراحل بعدی

درباره Firebase بیاموزید:

خدمات Firebase را به برنامه خود اضافه کنید: