콘솔로 이동

Android 프로젝트에 Firebase 추가

시작하기 전에

  • Android 스튜디오를 설치하거나 최신 버전으로 업데이트합니다.

  • Android 앱이 다음을 충족하는지 확인합니다.

    • API 수준 16(Jelly Bean) 이상 타겟팅
    • Gradle 4.1 이상 사용
  • 앱을 실행할 기기 또는 에뮬레이터를 설정합니다.

    • Google Play가 포함된 에뮬레이터 이미지를 에뮬레이터에서 사용해야 합니다.
  • Google 계정을 사용하여 Firebase에 로그인합니다.

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


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

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

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

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

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

Android 앱에 Firebase를 추가하려면 우선 Android 앱에 연결할 Firebase 프로젝트를 만들어야 합니다. Firebase 프로젝트에 대한 자세한 내용은 Firebase 프로젝트 이해를 참조하세요.

2단계: Firebase에 앱 등록

Firebase 프로젝트가 준비되면 Android 앱을 추가할 수 있습니다.

여러 빌드 변형을 처리하는 방법을 비롯하여 앱을 Firebase 프로젝트에 추가할 때의 권장사항 및 고려사항을 자세히 알아보려면 Firebase 프로젝트 이해를 참조하세요.

  1. Firebase Console의 프로젝트 개요 페이지 중앙에 있는 Android 아이콘을 클릭하여 설정 워크플로를 시작합니다.

    Firebase 프로젝트에 앱을 이미 추가한 경우 앱 추가를 클릭하여 플랫폼 옵션을 표시합니다.

  2. Android 패키지 이름 필드에 앱의 애플리케이션 ID를 입력합니다.

    • 애플리케이션 ID패키지 이름이라고도 합니다.

    • 모듈(앱 수준) Gradle 파일(일반적으로 app/build.gradle)에서 이 애플리케이션 ID(예: com.yourcompany.yourproject)를 확인합니다.

  3. (선택사항) 설정 워크플로의 안내에 따라 기타 앱 정보를 입력합니다.

    닉네임은 편의상 지정하는 내부용 식별자이며 Firebase Console에서 본인만 볼 수 있습니다.

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

3단계: Firebase 구성 파일 추가

  1. 앱에 Firebase Android 구성 파일을 추가합니다.

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

      언제든지 다시 Firebase Android 구성 파일을 다운로드할 수 있습니다.

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

  2. 앱에서 Firebase 제품을 사용할 수 있도록 google-services 플러그인을 Gradle 파일에 추가합니다.

    1. 루트 수준(프로젝트 수준) Gradle 파일(build.gradle)에서 규칙을 추가하여 Google 서비스 플러그인을 포함합니다. Google의 Maven 저장소도 있는지 확인합니다.

      buildscript {
        // ...
        dependencies {
          // ...
          // Add the following line:
          classpath 'com.google.gms:google-services:4.2.0'  // 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)에서 다음 줄을 파일 하단에 추가합니다.

      apply plugin: 'com.android.application'
      
      android {
        // ...
      }
      
      // Add the following line to the bottom of the file:
      apply plugin: 'com.google.gms.google-services'  // Google Play services Gradle plugin
      

4단계: 앱에 Firebase SDK 추가

지원되는 Firebase 제품을 Android 앱에 추가할 수 있습니다. 우선 Firebase용 Google 애널리틱스 기능을 제공하는 핵심 Firebase SDK(com.google.firebase:firebase-core)부터 시작하는 것이 좋습니다.

  1. 모듈(앱 수준) Gradle 파일(일반적으로 app/build.gradle)에서 핵심 Firebase SDK의 종속 항목을 추가합니다.

    dependencies {
     // ...
     implementation 'com.google.firebase:firebase-core:16.0.8'
    
     // Getting a "Could not find" error? Make sure that you've added
     // Google's Maven repository to your root-level build.gradle file
    }
    
  2. (선택사항) 사용할 다른 Firebase 라이브러리의 종속 항목을 추가합니다.

    일부 Android용 Firebase SDK에서는 Kotlin 확장 프로그램 라이브러리가 대신 제공됩니다.

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

  4. 앱을 실행하여 Firebase를 성공적으로 통합했다는 알림을 Firebase에 보냅니다.

    기기 로그에 초기화가 완료되었다는 Firebase 알림이 표시됩니다. 네트워크 액세스가 가능한 에뮬레이터에서 앱을 실행한 경우 Firebase Console에 앱이 연결되었다는 알림이 표시됩니다.

작업이 끝났습니다. 이제 다음 단계로 진행할 수 있습니다.

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

Firebase Assistant는 Firebase 프로젝트에 앱을 등록하고 필요한 Firebase 파일 및 코드를 Android 프로젝트에 추가하며, 이 모든 작업을 Android 스튜디오 안에서 할 수 있습니다.

Firebase에 앱을 연결하는 데 권장되는 옵션은 Firebase Console 설정 워크플로를 사용하는 것입니다.

  1. Android 스튜디오에서 Android 프로젝트를 엽니다.

  2. 도구 > Firebase를 클릭하여 Assistant 창을 엽니다.

  3. 나열된 Firebase 제품 중 하나(예: 애널리틱스)를 펼치고 제공되는 가이드 링크(예: 애널리틱스 이벤트 로깅)를 클릭합니다.

  4. Firebase에 연결을 클릭하여 기존 또는 신규 Firebase 프로젝트에 앱을 등록하고 필요한 파일 및 코드를 Android 프로젝트에 자동으로 추가합니다.

  5. 플러그인 및 라이브러리 버전이 최신 상태인지 확인합니다.

    • 루트 수준(프로젝트 수준) Gradle 파일(build.gradle)에서 Google 서비스 플러그인 버전이 최신 상태(com.google.gms:google-services:4.2.0)인지 확인합니다.

    • 모듈(앱 수준) Gradle 파일(일반적으로 app/build.gradle)에서 Firebase Android 라이브러리 버전이 최신 상태인지 확인합니다.

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

  7. Firebase Console의 프로젝트 설정에서 애널리틱스 데이터 공유 설정을 구성합니다.
    Firebase 예측, Firebase A/B 테스팅 등의 Firebase 제품을 사용하려면 다른 Firebase 제품과의 애널리틱스 데이터 공유를 사용 설정해야 합니다.

  8. 앱을 실행하여 Firebase를 성공적으로 통합했다는 알림을 Firebase에 보냅니다.

    기기 로그에 초기화가 완료되었다는 Firebase 알림이 표시됩니다. 네트워크 액세스가 가능한 에뮬레이터에서 앱을 실행한 경우 Firebase Console에 앱이 연결되었다는 알림이 표시됩니다.

사용 가능한 라이브러리

다양한 Firebase 제품에 다음과 같은 Android 라이브러리를 사용할 수 있습니다.

일부 Android용 Firebase SDK에서는 Kotlin 확장 프로그램 라이브러리가 대신 제공됩니다.

서비스 또는 제품 Gradle 종속성 계통
Google Play 서비스 플러그인 com.google.gms:google-services:4.2.0
AdMob com.google.firebase:firebase-ads:17.2.0
애널리틱스 com.google.firebase:firebase-core:16.0.8
앱 색인 생성 com.google.firebase:firebase-appindexing:17.1.0
인증 com.google.firebase:firebase-auth:16.2.1
Cloud Firestore com.google.firebase:firebase-firestore:18.2.0
Firebase용 Cloud Functions 클라이언트 SDK com.google.firebase:firebase-functions:16.3.0
클라우드 메시징 com.google.firebase:firebase-messaging:17.6.0
Cloud Storage com.google.firebase:firebase-storage:16.1.0
Crashlytics com.crashlytics.sdk.android:crashlytics:2.9.9
인앱 메시지 com.google.firebase:firebase-inappmessaging:17.1.1
인앱 메시지 표시 com.google.firebase:firebase-inappmessaging-display:17.1.1
ML Kit: Vision API com.google.firebase:firebase-ml-vision:19.0.3
ML Kit: 이미지 라벨 지정 모델 com.google.firebase:firebase-ml-vision-image-label-model:17.0.2
ML Kit: 얼굴 인식 모델 com.google.firebase:firebase-ml-vision-face-model:17.0.2
ML Kit: 자연어 API com.google.firebase:firebase-ml-natural-language:18.2.0
ML Kit: 언어 식별 모델 com.google.firebase:firebase-ml-natural-language-language-id-model:18.0.3
ML Kit: 스마트 답장 모델 com.google.firebase:firebase-ml-natural-language-smart-reply-model:18.0.0
ML Kit: 맞춤 모델 API com.google.firebase:firebase-ml-model-interpreter:18.0.0
성능 모니터링 com.google.firebase:firebase-perf:16.2.5
실시간 데이터베이스 com.google.firebase:firebase-database:16.1.0
원격 구성 com.google.firebase:firebase-config:16.5.0

Firebase BoM(Bill of Materials)으로 라이브러리 버전 관리 제어(실험용)

보다 쉬운 라이브러리 버전 관리를 위해 Firebase BoM(Bill of Materials)을 사용해 보세요.

다음 단계

Firebase 알아보기:

앱에 Firebase 기능 추가: