Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

پیش نیازها

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

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

    • Targets API سطح 16 (Jelly Bean) یا بالاتر
    • از Android 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.10'  // 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.4.2')
    
      // 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:28.4.2')
    
      // 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.4.2')
    
      // 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:28.4.2')
    
      // 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.4.2
AdMob com.google.android.gms: play-services-ads 20.4.0
تجزیه و تحلیل com.google.firebase: firebase-analytics 19.0.2
ارائه دهنده سفارشی بررسی برنامه com.google.firebase: firebase-appcheck 16.0.0-beta03
ارائه دهنده اشکال زدایی برنامه بررسی com.google.firebase: firebase-appcheck-debug 16.0.0-beta03
ارائه دهنده برنامه Check SafetyNet com.google.firebase: firebase-appcheck-safetynet 16.0.0-beta03
افزونه توزیع برنامه com.google.firebase: firebase-appdistribution-gradle 2.2.0
نمایه سازی برنامه 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.4
عملکردهای ابری برای SDK مشتری Firebase com.google.firebase: توابع firebase 20.0.1
پیام ابری com.google.firebase: پیام رسانی firebase 22.0.0
فضای ذخیره ابری com.google.firebase: firebase-storage 20.0.0
Crashlytics com.google.firebase: firebase-crashlytics 18.2.3
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.3
افزونه Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
پشتیبانی از ماژول ویژگی پویا com.google.firebase: firebase-dynamical-module-support 16.0.0-beta01
پیوندهای پویا com.google.firebase: پیوندهای firebase-dynamical 20.1.1
پیام های درون برنامه ای com.google.firebase: firebase-inappmessaging 20.1.0
(ضروری)
نمایش پیام های درون برنامه ای com.google.firebase: firebase-inappmessaging-display 20.1.0
(ضروری)
تاسیسات Firebase com.google.firebase: نصب و راه اندازی firebase 17.0.0
API Firebase ML Model Downloader com.google.firebase: firebase-ml-modeldownloader 24.0.0
نظارت بر عملکرد com.google.firebase: firebase-perf 20.0.3
افزونه نظارت بر عملکرد com.google.firebase: افزونه perf 1.4.0
پایگاه داده بیدرنگ com.google.firebase: پایگاه داده firebase 20.0.2
پیکربندی از راه دور com.google.firebase: firebase-config 21.0.1
افزونه خدمات Google Play com.google.gms: google-services 4.3.10
کتابخانه های منسوخ شده
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: مدل برچسب زدن تصویر com.google.firebase: firebase-ml-vision-image-label-model 20.0.2
Firebase ML: مدل تشخیص و ردیابی شی com.google.firebase: مدل firebase-ml-vision-object-detection 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 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: مدل ترجمه 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

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

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

28.4.2
AdMob com.google.android.gms: play-services-ads 20.4.0
تجزیه و تحلیل com.google.firebase: firebase-analytics-ktx 19.0.2
ارائه دهنده سفارشی بررسی برنامه com.google.firebase: firebase-appcheck 16.0.0-beta03
ارائه دهنده اشکال زدایی برنامه بررسی com.google.firebase: firebase-appcheck-debug 16.0.0-beta03
ارائه دهنده برنامه Check SafetyNet com.google.firebase: firebase-appcheck-safetynet 16.0.0-beta03
افزونه توزیع برنامه com.google.firebase: firebase-appdistribution-gradle 2.2.0
نمایه سازی برنامه 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.4
عملکردهای ابری برای SDK مشتری Firebase com.google.firebase: firebase-functions-ktx 20.0.1
پیام ابری 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.3
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.3
افزونه Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
پشتیبانی از ماژول ویژگی پویا com.google.firebase: firebase-dynamical-module-support 16.0.0-beta01
پیوندهای پویا com.google.firebase: firebase-dynamic-links-ktx 20.1.1
پیام های درون برنامه ای com.google.firebase: firebase-inappmessaging-ktx 20.1.0
(ضروری)
نمایش پیام های درون برنامه ای com.google.firebase: firebase-inappmessaging-display-ktx 20.1.0
(ضروری)
تاسیسات Firebase com.google.firebase: firebase-installations-ktx 17.0.0
API Firebase ML Model Downloader com.google.firebase: firebase-ml-modeldownloader-ktx 24.0.0
نظارت بر عملکرد com.google.firebase: firebase-perf-ktx 20.0.3
افزونه نظارت بر عملکرد com.google.firebase: افزونه perf 1.4.0
پایگاه داده بیدرنگ com.google.firebase: firebase-database-ktx 20.0.2
پیکربندی از راه دور com.google.firebase: firebase-config-ktx 21.0.1
افزونه خدمات Google Play com.google.gms: google-services 4.3.10
کتابخانه های منسوخ شده
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: مدل برچسب زدن تصویر com.google.firebase: firebase-ml-vision-image-label-model 20.0.2
Firebase ML: مدل تشخیص و ردیابی شی com.google.firebase: مدل firebase-ml-vision-object-detection 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 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: مدل ترجمه 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 بیشتر بدانید: