Android 프로젝트에 Firebase 추가

기본 요건

  • 다음을 실행하는 기기:
    • Android 4.1(API 수준 16, Jelly Bean) 이상
    • Google Play 서비스 15.0.0 이상
  • Android 스튜디오 최신 버전

Android 스튜디오 프로젝트가 준비되지 않은 경우 빠른 시작 샘플 중 하나를 다운로드하여 Firebase 기능을 시험해 볼 수 있습니다. 빠른 시작을 사용하는 경우 프로젝트의 모듈 폴더(일반적으로 app/)에 있는 build.gradle 파일의 애플리케이션 ID를 확인하세요. 다음 단계에서 이 패키지 이름이 필요합니다.

앱에 Firebase 추가

Android 스튜디오 버전 2.2 이상을 사용한다면 Firebase Assistant로 가장 간단한 방법으로 앱을 Firebase에 연결할 수 있습니다. Assistant로 기존 프로젝트를 연결하거나, 필요한 모든 Gradle 종속 항목을 포함하여 새 프로젝트를 만들 수 있습니다.

이전 버전의 Android 스튜디오를 사용하거나 프로젝트 구성이 복잡한 경우에는 수동으로 앱에 Firebase를 추가할 수도 있습니다.

Firebase Assistant 사용

Android 스튜디오에서 Firebase Assistant를 여는 방법은 다음과 같습니다.

  • 도구 > Firebase를 클릭하여 Assistant 창을 엽니다.
  • 나열된 기능 중 하나(예: 애널리틱스)를 클릭하여 펼치고, 제공되는 가이드 링크(예: 애널리틱스 이벤트 기록하기)를 클릭합니다.
  • Firebase에 연결 버튼을 클릭하여 Firebase에 연결하고, 앱에 필요한 코드를 추가합니다.

모든 설명을 마쳤습니다. 이제 다음 단계로 진행할 수 있습니다.

수동으로 Firebase 추가

앱에 Firebase를 추가할 차례입니다. 이를 위해 Firebase 프로젝트 및 앱의 Firebase 구성 파일이 필요합니다.

Firebase 프로젝트를 만드는 방법은 다음과 같습니다.

  1. Firebase 콘솔로 이동합니다.

  2. 프로젝트 추가를 클릭한 다음 프로젝트 이름을 선택하거나 입력합니다.

    • 앱에 연결된 기존 Google 프로젝트가 있으면 프로젝트 이름 드롭다운 메뉴에서 프로젝트를 선택합니다.
    • 기존 Google 프로젝트가 없으면 새 프로젝트 이름을 입력합니다.
  3. (선택사항) 프로젝트 ID를 수정합니다.

    Firebase는 Firebase 프로젝트에 자동으로 고유한 ID를 할당합니다. 이 식별자는 공개적으로 표시되는 Firebase 서비스에 나타납니다. 예를 들면 다음과 같습니다.

    • 기본 실시간 데이터베이스 URL — your-project-id.firebaseio.com
    • 기본 Cloud Storage 버킷 이름 — your-project-id.appspot.com
    • 기본 호스팅 하위 도메인 — your-project-id.firebaseapp.com
  4. Firebase 콘솔에서 나머지 설정 단계를 따른 다음 프로젝트 만들기(또는 기존 Google 프로젝트를 사용 중인 경우 Firebase 추가)를 클릭합니다.

Firebase에서 Firebase 프로젝트용 리소스를 자동으로 프로비저닝합니다. 이 프로세스는 일반적으로 몇 분 정도 걸립니다. 과정이 완료되면 Firebase 콘솔에서 Firebase 프로젝트의 개요 페이지로 이동하게 됩니다.

이제 프로젝트가 준비되었으므로 Android 앱을 추가할 수 있습니다.

  1. Android 앱에 Firebase 추가를 클릭하고 설정 단계를 따릅니다. 기존 Google 프로젝트를 가져오면 이 단계가 자동으로 이루어지므로 구성 파일만 다운로드하면 됩니다.

  2. 메시지가 표시되면 앱의 패키지 이름을 입력합니다. 앱에서 사용하는 패키지 이름을 입력해야 합니다. 이 설정은 Firebase 프로젝트에 앱을 추가할 때만 가능합니다.

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

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

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

    2. 구성 파일을 루트 수준 build.gradle 파일과 같은 디렉토리로 이동합니다.

  4. 초기화 코드를 추가한 후 앱을 실행하여 Firebase를 성공적으로 설치했다는 확인을 Firebase 콘솔에 보냅니다.

SDK 추가

프로젝트 중 하나에 Firebase 라이브러리를 통합하려는 경우 몇 가지 기본적인 작업을 수행하여 Android 스튜디오 프로젝트를 준비해야 합니다. 앱에 Firebase를 추가하면서 이 단계를 이미 완료했을 수 있습니다.

우선 루트 수준 build.gradle 파일에 규칙을 추가하여 google-services 플러그인 및 Google의 Maven 저장소를 포함합니다.

buildscript {
    // ...
    dependencies {
        // ...
        classpath 'com.google.gms:google-services:4.2.0' // google-services plugin
    }
}

allprojects {
    // ...
    repositories {
        google() // Google's Maven repository
        // ...
    }
}

이제 모듈의 Gradle 파일(일반적으로 app/build.gradle) 하단에 apply plugin 줄을 추가하여 Gradle 플러그인을 사용 설정합니다.

apply plugin: 'com.android.application'

android {
  // ...
}

dependencies {
  // ...
  implementation 'com.google.firebase:firebase-core:16.0.7'

  // Getting a "Could not find" error? Make sure you have
  // added the Google maven respository to your root build.gradle
}

// ADD THIS AT THE BOTTOM
apply plugin: 'com.google.gms.google-services'

또한 사용할 Firebase SDK에 대한 종속 항목을 추가해야 합니다. 우선 Firebase용 Google 애널리틱스 기능을 제공하는 com.google.firebase:firebase-core부터 시작하는 것이 좋습니다. 사용 가능한 라이브러리 목록을 참조하세요.

사용 가능한 라이브러리

다양한 Firebase 기능에 대해 다음과 같은 라이브러리를 사용할 수 있습니다.

Gradle 종속성 계통 서비스
com.google.firebase:firebase-core:16.0.7 애널리틱스
com.google.firebase:firebase-database:16.0.6 실시간 데이터베이스
com.google.firebase:firebase-firestore:18.0.1 Cloud Firestore
com.google.firebase:firebase-storage:16.0.5 Storage
com.crashlytics.sdk.android:crashlytics:2.9.9 Crashlytics
com.google.firebase:firebase-auth:16.1.0 인증
com.google.firebase:firebase-messaging:17.3.4 클라우드 메시징
com.google.firebase:firebase-config:16.3.0 원격 구성
com.google.firebase:firebase-invites:16.1.0 초대 및 동적 링크
com.google.firebase:firebase-ads:17.1.3 AdMob
com.google.firebase:firebase-appindexing:17.1.0 앱 색인 생성
com.google.firebase:firebase-perf:16.2.3 성능 모니터링
com.google.firebase:firebase-functions:16.1.3 Firebase용 Cloud Functions 클라이언트 SDK
com.google.firebase:firebase-ml-vision:19.0.2 ML Kit(Vision)
com.google.firebase:firebase-ml-model-interpreter:17.0.3 ML Kit(맞춤 모델)
com.google.firebase:firebase-ml-natural-language:18.1.1 ML Kit(자연어)
com.google.firebase:firebase-ml-natural-language-language-id-model:18.0.2 ML Kit(자연어 ID 모델)

다음 단계

Firebase 알아보기:

앱에 Firebase 기능 추가:

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.