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

پیش نیازها

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

  • اطمینان حاصل کنید که پروژه شما این شرایط را برآورده می کند:

    • سطح API 19 (KitKat) یا بالاتر را هدف قرار می دهد
    • از اندروید 4.4 یا بالاتر استفاده می کند
    • از Jetpack (AndroidX) استفاده می‌کند، که شامل برآورده کردن الزامات نسخه است:
      • com.android.tools.build:gradle نسخه 3.2.1 یا بالاتر
      • compileSdkVersion 28 یا بالاتر
  • یک دستگاه فیزیکی راه اندازی کنید یا از یک شبیه ساز برای اجرای برنامه خود استفاده کنید.
    توجه داشته باشید که Firebase SDK با وابستگی به خدمات Google Play به دستگاه یا شبیه‌ساز نیاز دارد که سرویس‌های Google Play را نصب کند.

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

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


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

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



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

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

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

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

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

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

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

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

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

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

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

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

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

    1. برای دریافت فایل پیکربندی Android Firebase ( google-services.json ) روی Download google-services.json کلیک کنید.

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

  2. برای فعال کردن محصولات Firebase در برنامه خود، افزونه google-services را به فایل‌های 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.12'  // 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 Services Gradle را اعمال کنید:

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

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

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

    تجزیه و تحلیل فعال شد

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.1.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'
    }
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.1.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'
    }
    

    با استفاده از Firebase Android BoM ، برنامه شما همیشه از نسخه‌های سازگار کتابخانه‌های Firebase Android استفاده می‌کند.

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

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.1.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'
    }
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.1.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'
    }
    

    با استفاده از Firebase Android BoM ، برنامه شما همیشه از نسخه‌های سازگار کتابخانه‌های Firebase Android استفاده می‌کند.

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

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

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



گزینه 2 : Firebase را با استفاده از Firebase Assistant اضافه کنید

دستیار Firebase برنامه شما را با یک پروژه Firebase ثبت می‌کند و فایل‌های Firebase، افزونه‌ها و وابستگی‌های لازم را به پروژه Android شما اضافه می‌کند - همه از داخل Android Studio!

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

    • Windows / Linux: راهنما > وجود به‌روزرسانی را بررسی کنید
    • macOS: Android Studio > به‌روزرسانی‌ها را بررسی کنید
  2. دستیار Firebase را باز کنید: Tools > Firebase .

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

    1. برای اتصال پروژه اندروید خود به Firebase روی Connect to Firebase کلیک کنید.

    2. برای افزودن یک محصول Firebase مورد نظر روی دکمه کلیک کنید (به عنوان مثال، افزودن Analytics به برنامه خود ).

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

  5. در بخش Assistant ، دستورالعمل‌های راه‌اندازی باقی‌مانده را برای محصول Firebase انتخابی خود دنبال کنید.

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

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

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



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

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

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

Java

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

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

30.1.0
AdMob com.google.android.gms:play-services-ads 21.0.0
تجزیه و تحلیل com.google.firebase:firebase-analytics 21.0.0
ارائه دهنده سفارشی بررسی برنامه com.google.firebase:firebase-appcheck 16.0.0
ارائه دهنده رفع اشکال برنامه بررسی com.google.firebase:firebase-appcheck-debug 16.0.0
App Check Play Integrity ارائه دهنده com.google.firebase:firebase-appcheck-playintegrity 16.0.0
ارائه دهنده SafetyNet را بررسی کنید com.google.firebase:firebase-appcheck-safetynet 16.0.0
توزیع برنامه com.google.firebase:firebase-appdistribution 16.0.0-beta03
API توزیع برنامه com.google.firebase:firebase-appdistribution-api 16.0.0-beta03
پلاگین توزیع برنامه com.google.firebase:firebase-appdistribution-gradle 3.0.2
احراز هویت com.google.firebase:firebase-auth 21.0.6
Cloud Firestore com.google.firebase:firebase-firestore 24.2.0
توابع ابری برای Firebase Client SDK com.google.firebase:firebase-functions 20.1.0
پیام رسانی ابری com.google.firebase:firebase-messaging 23.0.6
فضای ذخیره ابری com.google.firebase:firebase-storage 20.0.1
Crashlytics com.google.firebase:firebase-crashlytics 18.2.11
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.11
پلاگین Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.1
پشتیبانی از ماژول ویژگی پویا com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
لینک های پویا com.google.firebase:firebase-dynamic-links 21.0.1
پیام رسانی درون برنامه ای com.google.firebase:firebase-inappmessaging 20.1.2
(ضروری)
نمایش پیام درون برنامه com.google.firebase:firebase-inappmessaging-display 20.1.2
(ضروری)
تاسیسات فایربیس com.google.firebase:firebase-installations 17.0.1
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 24.0.3
نظارت بر عملکرد com.google.firebase:firebase-perf 20.1.0
افزونه نظارت بر عملکرد com.google.firebase:perf-plugin 1.4.1
پایگاه داده بیدرنگ com.google.firebase:firebase-database 20.0.5
پیکربندی از راه دور com.google.firebase:firebase-config 21.1.0
افزونه خدمات گوگل پلی com.google.gms:google-services 4.3.12
کتابخانه های منسوخ شده
نمایه سازی برنامه com.google.firebase:firebase-appindexing 20.0.0
APIهای مدل سفارشی Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
API های Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Image Labeling Model com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: مدل تشخیص و ردیابی شی com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: مدل تشخیص چهره com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: مدل اسکن بارکد com.google.firebase:firebase-ml-vision-barcode-model 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-natural-language 22.0.1
Firebase ML: مدل شناسایی زبان com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Translate Model 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

Kotlin+KTX

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

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

30.1.0
AdMob com.google.android.gms:play-services-ads 21.0.0
تجزیه و تحلیل com.google.firebase:firebase-analytics-ktx 21.0.0
ارائه دهنده سفارشی بررسی برنامه com.google.firebase:firebase-appcheck 16.0.0
ارائه دهنده رفع اشکال برنامه بررسی com.google.firebase:firebase-appcheck-debug 16.0.0
ارائه دهنده SafetyNet را بررسی کنید com.google.firebase:firebase-appcheck-safetynet 16.0.0
API توزیع برنامه com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta03
پلاگین توزیع برنامه com.google.firebase:firebase-appdistribution-gradle 3.0.2
احراز هویت com.google.firebase:firebase-auth-ktx 21.0.6
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.2.0
توابع ابری برای Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.1.0
پیام رسانی ابری com.google.firebase:firebase-messaging-ktx 23.0.6
فضای ذخیره ابری com.google.firebase:firebase-storage-ktx 20.0.1
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.11
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.11
پلاگین Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.1
پشتیبانی از ماژول ویژگی پویا com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
لینک های پویا com.google.firebase:firebase-dynamic-links-ktx 21.0.1
پیام رسانی درون برنامه ای com.google.firebase:firebase-inappmessaging-ktx 20.1.2
(ضروری)
نمایش پیام درون برنامه com.google.firebase:firebase-inappmessaging-display-ktx 20.1.2
(ضروری)
تاسیسات فایربیس com.google.firebase:firebase-installations-ktx 17.0.1
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.3
نظارت بر عملکرد com.google.firebase:firebase-perf-ktx 20.1.0
افزونه نظارت بر عملکرد com.google.firebase:perf-plugin 1.4.1
پایگاه داده بیدرنگ com.google.firebase:firebase-database-ktx 20.0.5
پیکربندی از راه دور com.google.firebase:firebase-config-ktx 21.1.0
افزونه خدمات گوگل پلی com.google.gms:google-services 4.3.12
کتابخانه های منسوخ شده
نمایه سازی برنامه com.google.firebase:firebase-appindexing 20.0.0
APIهای مدل سفارشی Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
API های Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Image Labeling Model com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: مدل تشخیص و ردیابی شی com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: مدل تشخیص چهره com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: مدل اسکن بارکد com.google.firebase:firebase-ml-vision-barcode-model 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-natural-language 22.0.1
Firebase ML: مدل شناسایی زبان com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Translate Model 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 بیاموزید: