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

پیش نیازها

  • نصب و یا به روز رسانی اندروید استودیو به آخرین نسخه آن.

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

    • سطح 16 API (ژله بین) یا بالاتر را هدف قرار می دهد
    • از Gradle 4.1 یا بالاتر استفاده می کند
    • استفاده از jetpack است (AndroidX) ، که شامل ملاقات این شرایط نسخه:
      • com.android.tools.build:gradle v3.2.1 و یا بعد از
      • compileSdkVersion 28 و یا بعد از
  • تنظیم یک دستگاه فیزیکی یا استفاده از یک شبیه ساز برای اجرای برنامه خود را.
    توجه داشته باشید که فایربیس SDK ها با وابستگی به سرویسهای Google Play نیاز به دستگاه و یا شبیه ساز به سرویس Google Play نصب شده است.

  • ورود به فایربیس استفاده از حساب Google خود را.

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


با استفاده از یکی از گزینه های زیر می توانید برنامه Android خود را به Firebase متصل کنید:

  • گزینه 1 : (توصیه می شود) با استفاده از فایربیس راه اندازی کنسول کاری می باشد.
  • گزینه 2 : استفاده از اندروید استودیو فایربیس دستیار (ممکن است پیکربندی اضافی نیاز).



انتخاب 1: اضافه کردن فایربیس با استفاده از کنسول فایربیس

اضافه کردن فایربیس به برنامه شما شامل وظایف هر دو در فایربیس کنسول و در پروژه های باز آندروید خود را (به عنوان مثال، شما دانلود فایل های پیکربندی فایربیس از کنسول، و سپس حرکت آنها را در پروژه آندروید خود را).

مرحله 1: ایجاد یک پروژه فایربیس

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

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

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

  1. رفتن به کنسول فایربیس .

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

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

  4. نام مستعار برنامه و امضای اشکال زدایی گواهی SHA-1: (اختیاری) اطلاعات برنامه دیگر را وارد کنید.

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

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

  1. فایل پیکربندی Firebase Android را به برنامه خود اضافه کنید:

    1. برای به دست آوردن فایل پیکربندی فایربیس آندروید خود را کلیک کنید دانلود Google-services.json ( google-services.json ).

    2. فایل پیکربندی خود را به فهرست ماژول (در سطح برنامه) برنامه خود منتقل کنید.

  2. برای فعال کردن محصولات فایربیس در برنامه شما، اضافه کردن گوگل-خدمات پلاگین به فایل های Gradle خود را.

    1. در خود ریشه در سطح (سطح پروژه) فایل Gradle ( build.gradle )، اضافه کردن قوانین شامل افزونه Google خدمات Gradle. بررسی کنید که مخزن Maven Google را نیز داشته باشید.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.8'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. در ماژول خود را (در سطح برنامه) فایل Gradle (معمولا app/build.gradle )، درخواست افزونه Google خدمات Gradle:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

گام 4: اضافه کردن فایربیس SDK ها به برنامه شما

  1. با استفاده از فایربیس آندروید BOM ، اعلام وابستگی برای محصولات فایربیس که شما می خواهید به استفاده در برنامه شما. اعلام آنها را در ماژول خود را (در سطح برنامه) فایل Gradle (معمولا app/build.gradle ).

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

    جاوا

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.3.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    کوتلین + KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.3.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    با استفاده از فایربیس آندروید BOM ، برنامه شما همیشه نسخه های سازگار با کتابخانه فایربیس آندروید استفاده خواهد کرد.

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

    جاوا

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.3.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    کوتلین + KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.3.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    با استفاده از فایربیس آندروید BOM ، برنامه شما همیشه نسخه های سازگار با کتابخانه فایربیس آندروید استفاده خواهد کرد.

  2. برنامه خود را همگام سازی کنید تا مطمئن شوید همه وابستگی ها نسخه های لازم را دارند.

خودشه! شما می توانید پیش جست و خیز برای بررسی از توصیه می شود گام های بعدی .

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



انتخاب 2: اضافه کردن فایربیس با استفاده از فایربیس دستیار

فایربیس دستیار ثبت برنامه خود را با یک پروژه فایربیس و می افزاید: لازم فایل های فایربیس، پلاگین ها، و وابستگی به پروژه آندروید خود را - همه از درون اندروید استودیو!

  1. پروژه Android خود را در Android Studio باز کنید ، سپس مطمئن شوید که از جدیدترین نسخه های Android Studio و دستیار Firebase استفاده می کنید:

    • ویندوز / لینوکس: راهنما> برای به روز رسانی را بررسی کنید
    • از MacOS: اندروید استودیو> برای به روز رسانی را بررسی کنید
  2. باز کردن دستیار فایربیس: ابزار> فایربیس.

  3. در پنجره سمت دستیار، یک محصول را انتخاب کنید فایربیس برای اضافه کردن به برنامه شما. باز بخش آن، و سپس از لینک آموزش کلیک کنید (به عنوان مثال، تجزیه و تحلیل ترافیک> ورود یک رویداد تجزیه و تحلیل).

    1. اتصال را کلیک کنید برای فایربیس برای اتصال پروژه آندروید خود را با Firebase.

    2. برای اضافه کردن یک محصول مورد نظر فایربیس (به عنوان مثال، اضافه کردن تجزیه و تحلیل ترافیک به برنامه شما) کلیک بر روی دکمه.

  4. برنامه خود را همگام سازی کنید تا مطمئن شوید همه وابستگی ها نسخه های لازم را دارند.

  5. در پنجره سمت دستیار، دستورالعمل تنظیم باقی مانده برای انتخاب فایربیس محصول خود را دنبال کنید.

  6. از طریق دستیار Firebase به همان تعداد محصولات Firebase دیگر که می خواهید اضافه کنید!

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

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



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

در این بخش محصولات Firebase پشتیبانی شده برای Android و وابستگی های Gradle آنها لیست شده است. درباره این کتابخانه های Android Firebase بیشتر بیاموزید:

توجه داشته باشید که هنگام استفاده از فایربیس آندروید BOM ، شما نسخه های کتابخانه های انفرادی مشخص نیست زمانی که شما اعلام وابستگی کتابخانه فایربیس در build.gradle .

جاوا

خدمات یا محصول وابستگی به گرید آخرین
نسخه
تجزیه و تحلیل اضافه شود؟
Firebase Android BoM
(لایحه مواد)
com.google.firebase: firebase-bom

آخرین نسخه Firebase BoM شامل آخرین نسخه های هر کتابخانه Firebase Android است. برای یادگیری اینکه کدام نسخه های کتابخانه به یک نسخه خاص BoM ترسیم شده اند ، یادداشت های نسخه مربوط به آن نسخه BoM را مرور کنید.

28.3.0
AdMob com.google.android.gms: پخش-خدمات-تبلیغات 20.2.0
تجزیه و تحلیل com.google.firebase: تجزیه و تحلیل firebase 19.0.0
برنامه ارائه دهنده سفارشی را بررسی کنید com.google.firebase: firebase-appcheck 16.0.0-beta02
برنامه بررسی ارائه دهنده اشکال زدایی com.google.firebase: firebase-appcheck-debug 16.0.0-beta02
برنامه ارائه دهنده SafetyNet را بررسی کنید com.google.firebase: firebase-appcheck-safetynet 16.0.0-beta02
افزونه برنامه توزیع com.google.firebase: firebase-appdistribution-gradle 2.1.3
نمایه سازی برنامه com.google.firebase: firebase-appindexing 20.0.0
احراز هویت com.google.firebase: firebase-auth 21.0.1
Cloud Firestore com.google.firebase: firebase-firestore 23.0.3
توابع Cloud برای Firebase Client SDK com.google.firebase: توابع firebase 20.0.0
پیام رسانی ابری com.google.firebase: Firebase-پیام رسانی 22.0.0
فضای ذخیره ابری com.google.firebase: محل ذخیره آتش 20.0.0
Crashlytics com.google.firebase: firebase-crashlytics 18.2.0
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.0
افزونه Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
پشتیبانی از ماژول ویژگی پویا com.google.firebase: پشتیبانی از firebase-dynamic-module 16.0.0-beta01
پیوندهای پویا com.google.firebase: firebase-dynamic-links 20.1.1
پیام در برنامه com.google.firebase: Firebase-در-عدم مدیریت پیام 20.0.0
(ضروری)
نمایش پیام در برنامه com.google.firebase: firebase-inappmessaging-display 20.0.0
(ضروری)
تاسیسات Firebase com.google.firebase: نصب و راه اندازی firebase 17.0.0
Firebase ML Model Downloader API com.google.firebase: firebase-ml-modeldownloader 24.0.0
نظارت بر عملکرد com.google.firebase: firebase-perf 20.0.2
افزونه نظارت بر عملکرد com.google.firebase: perf-plugin 1.4.0
پایگاه داده بیدرنگ com.google.firebase: پایگاه داده firebase 20.0.1
پیکربندی از راه دور com.google.firebase: firebase-config 21.0.0
افزونه خدمات Google Play com.google.gms: سرویس های google 4.3.8
کتابخانه های منسوخ
API های مدل سفارشی Firebase ML com.google.firebase: firebase-ml-model-interpreter 22.0.4
API های Firebase ML Vision com.google.firebase: firebase-ml-vizion 24.1.0
Firebase ML: مدل برچسب گذاری تصویر com.google.firebase: مدل firebase-ml-vision-image-label 20.0.2
Firebase ML: مدل ردیابی و ردیابی شیject com.google.firebase: firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: مدل تشخیص چهره com.google.firebase: مدل firebase-ml-vision-face 20.0.2
Firebase ML: مدل اسکن بارکد com.google.firebase: مدل بارکد firebase-ml-vision- 16.1.2
Firebase ML: AutoML Vision Edge API com.google.firebase: firebase-ml-vision-automl 18.0.6
Firebase ML: API های زبان طبیعی com.google.firebase: firebase-ml-زبان طبیعی 22.0.1
Firebase ML: مدل شناسایی زبان com.google.firebase: firebase-ml-natural-language-language-language-model-model 20.0.8
Firebase ML: ترجمه مدل com.google.firebase: firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: مدل پاسخ هوشمند com.google.firebase: firebase-ml-natural-language-smart-reply-model 20.0.8

کوتلین + KTX

خدمات یا محصول وابستگی به گرید آخرین
نسخه
تجزیه و تحلیل اضافه شود؟
Firebase Android BoM
(لایحه مواد)
com.google.firebase: firebase-bom

آخرین نسخه Firebase BoM شامل آخرین نسخه های هر کتابخانه Firebase Android است. برای یادگیری اینکه کدام نسخه های کتابخانه به یک نسخه خاص BoM ترسیم شده اند ، یادداشت های نسخه مربوط به آن نسخه BoM را مرور کنید.

28.3.0
AdMob com.google.android.gms: پخش-خدمات-تبلیغات 20.2.0
تجزیه و تحلیل com.google.firebase: firebase-analytics-ktx 19.0.0
برنامه ارائه دهنده سفارشی را بررسی کنید com.google.firebase: firebase-appcheck 16.0.0-beta02
ارائه دهنده اشکال زدایی برنامه را بررسی کنید com.google.firebase: firebase-appcheck-debug 16.0.0-beta02
برنامه ارائه دهنده SafetyNet را بررسی کنید com.google.firebase: firebase-appcheck-safetynet 16.0.0-beta02
افزونه برنامه توزیع com.google.firebase: firebase-appdistribution-gradle 2.1.3
نمایه سازی برنامه com.google.firebase: firebase-appindexing 20.0.0
احراز هویت com.google.firebase: firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase: firebase-firestore-ktx 23.0.3
توابع Cloud برای Firebase Client SDK com.google.firebase: firebase-توابع-ktx 20.0.0
پیام رسانی ابری com.google.firebase: firebase-messaging-ktx 22.0.0
فضای ذخیره ابری com.google.firebase: firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx 18.2.0
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.0
افزونه Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
پشتیبانی از ماژول ویژگی پویا com.google.firebase: پشتیبانی از firebase-dynamic-module 16.0.0-beta01
پیوندهای پویا com.google.firebase: firebase-dynamic-links-ktx 20.1.1
پیام در برنامه com.google.firebase: firebase-inappmessaging-ktx 20.0.0
(ضروری)
نمایش پیام در برنامه com.google.firebase: firebase-inappmessaging-display-ktx 20.0.0
(ضروری)
تاسیسات Firebase com.google.firebase: firebase-installs-ktx 17.0.0
Firebase ML Model Downloader API com.google.firebase: firebase-ml-modeldownloader-ktx 24.0.0
نظارت بر عملکرد com.google.firebase: firebase-perf-ktx 20.0.2
افزونه نظارت بر عملکرد com.google.firebase: perf-plugin 1.4.0
پایگاه داده بیدرنگ com.google.firebase: firebase-database-ktx 20.0.1
پیکربندی از راه دور com.google.firebase: firebase-config-ktx 21.0.0
افزونه خدمات Google Play com.google.gms: سرویس های google 4.3.8
کتابخانه های منسوخ
API های مدل سفارشی Firebase ML com.google.firebase: firebase-ml-model-interpreter 22.0.4
API های Firebase ML Vision com.google.firebase: firebase-ml-vizion 24.1.0
Firebase ML: مدل برچسب گذاری تصویر com.google.firebase: مدل firebase-ml-vision-image-label 20.0.2
Firebase ML: مدل ردیابی و ردیابی شیject com.google.firebase: firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: مدل تشخیص چهره com.google.firebase: مدل firebase-ml-vision-face 20.0.2
Firebase ML: مدل اسکن بارکد com.google.firebase: مدل بارکد firebase-ml-vision- 16.1.2
Firebase ML: AutoML Vision Edge API com.google.firebase: firebase-ml-vision-automl 18.0.6
Firebase ML: API های زبان طبیعی com.google.firebase: firebase-ml-به زبان طبیعی 22.0.1
Firebase ML: مدل شناسایی زبان com.google.firebase: firebase-ml-natural-language-language-language-model-model 20.0.8
Firebase ML: ترجمه مدل com.google.firebase: firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: مدل پاسخ هوشمند com.google.firebase: firebase-ml-natural-language-smart-reply-model 20.0.8



مراحل بعدی

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

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