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

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

پیش نیازها

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

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

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

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

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


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

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



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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. برای فعال کردن محصولات Firebase در برنامه خود ، افزونه google-services را به پرونده های Gradle خود اضافه کنید.

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

      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.4'  // 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 ).

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

    جاوا

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:26.0.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:26.0.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 ، برنامه شما همیشه از نسخه های سازگار کتابخانه های Android Firebase استفاده خواهد کرد.

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

    جاوا

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:26.0.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:26.0.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. برنامه خود را همگام سازی کنید تا مطمئن شوید همه وابستگی ها نسخه های لازم را دارند.

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



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

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

  1. پروژه Android خود را در Android Studio باز کنید و به دستیار Firebase دسترسی پیدا کنید:

    1. برای اطمینان از اینکه از آخرین نسخه های Android Studio و Firebase Assistant استفاده می کنید ، به File> برای به روزرسانی مراجعه کنید.

    2. برای باز کردن پنجره دستیار ، به Tools> Firebase بروید.

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

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

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

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

  4. در پنجره دستیار Firebase ، دستورالعمل های باقیمانده را برای محصول Firebase انتخاب شده خود دنبال کنید.

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

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



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

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

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

جاوا

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

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

26.0.0
AdMob com.google.android.gms: پخش-خدمات-تبلیغات 19.5.0
تجزیه و تحلیل com.google.firebase: تجزیه و تحلیل firebase 18.0.0
نمایه سازی برنامه com.google.firebase: firebase-appindexing 19.1.0
احراز هویت com.google.firebase: firebase-auth 20.0.0
Cloud Firestore com.google.firebase: firebase-firestore 22.0.0
توابع Cloud برای Firebase Client SDK com.google.firebase: توابع firebase 19.1.0
پیام رسانی ابری com.google.firebase: Firebase-پیام رسانی 21.0.0
فضای ذخیره ابری com.google.firebase: محل ذخیره سازی firebase 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics 17.2.2
پیوندهای پویا com.google.firebase: firebase-dynamic-links 19.1.1
API های Firebase ML Vision com.google.firebase: firebase-ml-vizion 24.1.0
API های سفارشی Firebase ML com.google.firebase: firebase-ml-model-interpreter 22.0.4
پیام در برنامه com.google.firebase: در Fire-Base-عدم مدیریت پیام 19.1.2
(ضروری)
نمایش پیام در برنامه com.google.firebase: firebase-inappmessaging-display 19.1.2
(ضروری)
نظارت بر عملکرد com.google.firebase: firebase-perf 19.0.9
پایگاه داده بیدرنگ com.google.firebase: پایگاه داده firebase 19.5.1
پیکربندی از راه دور com.google.firebase: firebase-config 20.0.0
افزونه خدمات Google Play com.google.gms: سرویس های google 4.3.4
کتابخانه های منسوخ
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-model-face-model 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-vizion-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-طبیعی-زبان-ترجمه-مدل 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 را مرور کنید.

26.0.0
AdMob com.google.android.gms: تبلیغات پخش خدمات 19.5.0
تجزیه و تحلیل com.google.firebase: firebase-analytics-ktx 18.0.0
نمایه سازی برنامه com.google.firebase: firebase-appindexing 19.1.0
احراز هویت com.google.firebase: firebase-auth-ktx 20.0.0
Cloud Firestore com.google.firebase: firebase-firestore-ktx 22.0.0
توابع Cloud برای Firebase Client SDK com.google.firebase: firebase-توابع-ktx 19.1.0
پیام رسانی ابری com.google.firebase: firebase-messaging-ktx 21.0.0
فضای ذخیره ابری com.google.firebase: firebase-storage-ktx 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx 17.2.2
پیوندهای پویا com.google.firebase: firebase-dynamic-links-ktx 19.1.1
API های Firebase ML Vision com.google.firebase: firebase-ml-vizion 24.1.0
API های مدل سفارشی Firebase ML com.google.firebase: firebase-ml-model-interpreter 22.0.4
پیام در برنامه com.google.firebase: firebase-inappmessaging-ktx 19.1.2
(ضروری)
نمایش پیام در برنامه com.google.firebase: firebase-inappmessaging-display-ktx 19.1.2
(ضروری)
نظارت بر عملکرد com.google.firebase: firebase-perf-ktx 9.0.0.0
پایگاه داده بیدرنگ com.google.firebase: firebase-database-ktx 19.5.1
پیکربندی از راه دور com.google.firebase: firebase-config-ktx 20.0.0
افزونه خدمات Google Play com.google.gms: سرویس های google 4.3.4
کتابخانه های منسوخ
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-model-face-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 بیاموزید: