2022년 10월 18일에 오프라인과 온라인으로 진행될 Firebase Summit에 참여하세요. Firebase로 앱을 빠르게 개발하고 안심하고 앱을 출시하며 손쉽게 확장하는 방법을 알아보세요. 지금 등록하기

Android 프로젝트에 Firebase 추가

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

기본 요건

Android 프로젝트가 준비되지 않았다면 빠른 시작 샘플 중 하나를 다운로드하여 Firebase 제품을 사용해 볼 수 있습니다.


다음 옵션 중 하나를 사용하여 Android 앱을 Firebase에 연결할 수 있습니다.

  • 옵션 1: (권장) Firebase Console 설정 워크플로를 사용합니다.
  • 옵션 2: Android 스튜디오 Firebase Assistant를 사용합니다(추가 구성이 필요할 수 있음).



옵션 1: Firebase Console을 사용하여 Firebase 추가

앱에 Firebase를 추가하려면 Firebase Console 및 열려 있는 Android 프로젝트 모두에서 작업을 수행해야 합니다. 예를 들어 콘솔에서 Firebase 구성 파일을 다운로드한 후 이 파일을 Android 프로젝트로 옮기는 작업이 필요합니다.

1단계: Firebase 프로젝트 만들기

Firebase를 Android 앱에 추가하려면 먼저 Android 앱에 연결할 Firebase 프로젝트를 만드세요. Firebase 프로젝트에 대한 자세한 내용은 Firebase 프로젝트 이해를 참조하세요.

2단계: Firebase에 앱 등록

Android 앱에서 Firebase를 사용하려면 Firebase 프로젝트에 앱을 등록해야 합니다. 앱 등록이란 보통 프로젝트에 앱을 '추가'하는 것을 의미합니다.

  1. Firebase Console로 이동합니다.

  2. 프로젝트 개요 페이지 중앙에 있는 Android 아이콘() 또는 앱 추가를 클릭하여 설정 워크플로를 시작합니다.

  3. Android 패키지 이름 필드에 앱의 패키지 이름을 입력합니다.

  4. (선택사항) 다른 앱 정보(앱 닉네임디버그 서명 인증서 SHA-1)를 입력합니다.

  5. 앱 등록을 클릭합니다.

3단계: Firebase 구성 파일 추가

  1. Firebase Android 구성 파일(google-services.json)을 다운로드한 후 앱에 추가합니다.

    1. google-services.json 다운로드를 클릭하여 Firebase Android 구성 파일을 가져옵니다.

    2. 구성 파일을 앱의 모듈(앱 수준) 루트 디렉터리로 이동합니다.

  2. google-services.json 구성 파일의 값이 Firebase SDK에 액세스할 수 있게 하려면 Google 서비스 Gradle 플러그인(google-services)이 필요합니다.

    1. 루트 수준(프로젝트 수준) Gradle 파일(<project>/build.gradle)에서 Google 서비스 플러그인을 buildscript 종속 항목으로 추가합니다.

      buildscript {
      
          repositories {
            // Make sure that you have the following two repositories
            google()  // Google's Maven repository
            mavenCentral()  // Maven Central repository
          }
      
          dependencies {
            ...
      
            // Add the dependency for the Google services Gradle plugin
            classpath 'com.google.gms:google-services:4.3.14'
          }
      }
      
      allprojects {
        ...
      
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
      }
      
    2. 모듈(앱 수준) Gradle 파일(일반적으로 <project>/<app-module>/build.gradle)에서 Google 서비스 플러그인을 추가합니다.

      plugins {
          id 'com.android.application'
      
          // Add the Google services Gradle plugin
          id 'com.google.gms.google-services'
          ...
      }
      

4단계: 앱에 Firebase SDK 추가

  1. 모듈(앱 수준) Gradle 파일(일반적으로 <project>/<app-module>/build.gradle)에서 앱에서 사용하려고 하는 Firebase 제품의 종속 항목을 추가합니다. 라이브러리 버전 관리 제어에는 Firebase Android BoM을 사용하는 것이 좋습니다.

    애널리틱스를 사용 설정한 경우

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.4.1')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // TODO: Add the dependencies for any other Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add 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.4.1')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // TODO: Add the dependencies for any other Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add 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.4.1')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // TODO: Add the dependencies for Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add 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.4.1')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // TODO: Add the dependencies for Firebase products you want to use
      // See https://firebase.google.com/docs/android/setup#available-libraries
      // For example, add 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 프로젝트를 Gradle 파일과 동기화합니다.

작업이 끝났습니다. 권장되는 다음 단계를 확인할 수 있는 섹션으로 건너뛸 수 있습니다.

하지만 설정하는 데 문제가 있으면 Android 문제 해결 및 FAQ를 방문하세요.



옵션 2: Firebase Assistant를 사용하여 Firebase 추가

Firebase Assistant는 Firebase 프로젝트에 앱을 등록하고 필요한 Firebase 파일, 플러그인, 종속 항목을 Android 프로젝트에 추가하며, 이 모든 작업을 Android 스튜디오 안에서 할 수 있습니다.

  1. Android 스튜디오에서 Android 프로젝트를 열고 최신 버전의 Android 스튜디오 및 Firebase Assistant를 사용하고 있는지 확인합니다.

    • Windows/Linux: Help(도움말) > Check for updates(업데이트 확인)
    • macOS: Android 스튜디오 > Check for updates(업데이트 확인)
  2. Firebase Assistant에서 도구 > Firebase를 엽니다.

  3. Assistant 창에서 앱에 추가할 Firebase 제품을 선택합니다. 해당 섹션을 펼친 다음 튜토리얼 링크(예: 애널리틱스 > 애널리틱스 이벤트 로깅)를 클릭합니다.

    1. Firebase에 연결을 클릭하여 Android 프로젝트를 Firebase에 연결합니다.

    2. 버튼을 클릭하여 원하는 Firebase 제품을 추가합니다(예: 앱에 애널리틱스 추가).

  4. 앱을 동기화하여 모든 종속 항목에 필요한 버전이 있는지 확인합니다.

  5. Assistant 창에서 선택한 Firebase 제품에 대한 나머지 설정 안내를 따릅니다.

  6. Firebase Assistant를 통해 원하는 만큼 다른 Firebase 제품을 추가합니다.

작업이 끝났습니다. 권장되는 다음 단계를 확인해 보세요.

하지만 설정하는 데 문제가 있으면 Android 문제 해결 및 FAQ를 방문하세요.



사용 가능한 라이브러리

이 섹션에는 Android에서 지원되는 Firebase 제품과 해당 Gradle 종속 항목 목록이 나와 있습니다. 다음 Firebase Android 라이브러리에 대해 자세히 알아보세요.

Firebase Android BoM을 사용하면 build.gradle에서 Firebase 라이브러리 종속 항목을 선언할 때 개별 라이브러리 버전을 지정하지 않습니다.

Java

서비스 또는 제품 Gradle 종속 항목 최신
버전
애널리틱스 추가 권장
Firebase Android BoM
(Bill of Materials)
com.google.firebase:firebase-bom

최신 Firebase BoM 버전에는 각 Firebase Android 라이브러리의 최신 버전이 포함되어 있습니다. 특정 BoM 버전에 매핑되는 라이브러리 버전을 알아보려면 해당 BoM 버전의 출시 노트를 참조하세요.

30.4.1
AdMob com.google.android.gms:play-services-ads 21.2.0
애널리틱스 com.google.firebase:firebase-analytics 21.1.1
앱 체크 커스텀 제공자 com.google.firebase:firebase-appcheck 16.0.2
앱 체크 디버그 제공업체 com.google.firebase:firebase-appcheck-debug 16.0.2
앱 체크 Play Integrity 제공업체 com.google.firebase:firebase-appcheck-playintegrity 16.0.2
앱 체크 SafetyNet 제공업체 com.google.firebase:firebase-appcheck-safetynet 16.0.2
앱 배포 com.google.firebase:firebase-appdistribution 16.0.0-beta04
앱 배포 API com.google.firebase:firebase-appdistribution-api 16.0.0-beta04
앱 배포 플러그인 com.google.firebase:firebase-appdistribution-gradle 3.0.3
인증 com.google.firebase:firebase-auth 21.0.8
Cloud Firestore com.google.firebase:firebase-firestore 24.3.1
Firebase용 Cloud Functions 클라이언트 SDK com.google.firebase:firebase-functions 20.1.1
클라우드 메시징 com.google.firebase:firebase-messaging 23.0.8
Cloud Storage com.google.firebase:firebase-storage 20.0.2
Crashlytics com.google.firebase:firebase-crashlytics 18.2.13
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.13
Crashlytics 플러그인 com.google.firebase:firebase-crashlytics-gradle 2.9.2
동적 기능 모듈 지원 com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
동적 링크 com.google.firebase:firebase-dynamic-links 21.0.2
인앱 메시지 com.google.firebase:firebase-inappmessaging 20.1.3
(필수)
인앱 메시지 표시 com.google.firebase:firebase-inappmessaging-display 20.1.3
(필수)
Firebase 설치 com.google.firebase:firebase-installations 17.0.3
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 24.0.5
Performance Monitoring com.google.firebase:firebase-perf 20.1.1
Performance Monitoring 플러그인 com.google.firebase:perf-plugin 1.4.1
실시간 데이터베이스 com.google.firebase:firebase-database 20.0.6
원격 구성 com.google.firebase:firebase-config 21.1.2
Google Play 서비스 플러그인 com.google.gms:google-services 4.3.14
지원 중단된 라이브러리
앱 색인 생성 com.google.firebase:firebase-appindexing 20.0.0
Firebase ML Custom Model API com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API 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-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: Natural Language 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

서비스 또는 제품 Gradle 종속 항목 최신
버전
애널리틱스 추가 권장
Firebase Android BoM
(Bill of Materials)
com.google.firebase:firebase-bom

최신 Firebase BoM 버전에는 각 Firebase Android 라이브러리의 최신 버전이 포함되어 있습니다. 특정 BoM 버전에 매핑되는 라이브러리 버전을 알아보려면 해당 BoM 버전의 출시 노트를 참조하세요.

30.4.1
AdMob com.google.android.gms:play-services-ads 21.2.0
애널리틱스 com.google.firebase:firebase-analytics-ktx 21.1.1
앱 체크 커스텀 제공자 com.google.firebase:firebase-appcheck-ktx 16.0.2
앱 체크 디버그 제공업체 com.google.firebase:firebase-appcheck-debug 16.0.2
앱 체크 SafetyNet 제공업체 com.google.firebase:firebase-appcheck-safetynet 16.0.2
앱 배포 API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta04
앱 배포 플러그인 com.google.firebase:firebase-appdistribution-gradle 3.0.3
인증 com.google.firebase:firebase-auth-ktx 21.0.8
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.3.1
Firebase용 Cloud Functions 클라이언트 SDK com.google.firebase:firebase-functions-ktx 20.1.1
클라우드 메시징 com.google.firebase:firebase-messaging-ktx 23.0.8
Cloud Storage com.google.firebase:firebase-storage-ktx 20.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.13
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.13
Crashlytics 플러그인 com.google.firebase:firebase-crashlytics-gradle 2.9.2
동적 기능 모듈 지원 com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
동적 링크 com.google.firebase:firebase-dynamic-links-ktx 21.0.2
인앱 메시지 com.google.firebase:firebase-inappmessaging-ktx 20.1.3
(필수)
인앱 메시지 표시 com.google.firebase:firebase-inappmessaging-display-ktx 20.1.3
(필수)
Firebase 설치 com.google.firebase:firebase-installations-ktx 17.0.3
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.5
Performance Monitoring com.google.firebase:firebase-perf-ktx 20.1.1
Performance Monitoring 플러그인 com.google.firebase:perf-plugin 1.4.1
실시간 데이터베이스 com.google.firebase:firebase-database-ktx 20.0.6
원격 구성 com.google.firebase:firebase-config-ktx 21.1.2
Google Play 서비스 플러그인 com.google.gms:google-services 4.3.14
지원 중단된 라이브러리
앱 색인 생성 com.google.firebase:firebase-appindexing 20.0.0
Firebase ML Custom Model API com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API 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-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: Natural Language 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 알아보기: