[안드로이드] Firebase 적용하기

본 문서는 Firebase Console을 사용하여 Firebase를 추가하는 방법을 기술하고 있습니다.

시작하기 전에

• Firebase를 적용하려는 프로젝트의 API Level이 16(Jelly Bean) 이상인지 확인한다.
• Gradle 4.1 이상인지 확인한다.
• com.android.tools.build:gradle v3.2.1, compileSdkVersion 28 이상의 Jetpack(AndroidX)인지 확인한다.
• Google 계정으로 Firebase에 로그인한다.

Firebase Console을 사용하여 Firebase 추가하기

• Firebase 에서 Android 앱에 연결할 Firebase 프로젝트를 만든다.
• Firebase 프로젝트에 앱을 등록한다.
  • Firebase Console 에서 프로젝트 개요 페이지의 앱 추가를 클릭하여 설정 워크 플로를 시작한다.
• Android 패키지 이름을 입력한다. 앱에서 실제로 사용중인 패키지 이름을 입력한다.
  • 패키지 이름 값은 대소문자를 구분하며 등록 후에는 이름을 변경할 수 없다.
• (선택) 추가적인 앱 정보를 입력한다.
  • 앱 닉네임
    • 내부용 식별자로 본인만 볼 수 있다.
  • 디버그 SHA-1 (디버그 서명 인증서)
    • Firebase 인증을 사용하는 경우 및 동적 링크게 필요
• Firebase 구성 파일 추가
  • google-services.json 파일을 다운로드하여 앱 수준 모듈의 디렉터리로 이동
• Gradle 추가

// project 수준 Gradle
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.5'  // Google Services plugin
  }
}

allprojects {
  // ...

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
    // ...
  }
}

//App 수준 Gradle
apply plugin: 'com.android.application'
// Add the following line:
apply plugin: 'com.google.gms.google-services'  // Google Services plugin

android {
  // ...
}

• Firebase SDK 추가
  • Firebase Android BoM(Bill of Materials)을 사용하여 앱에서 사용할 Firebase 제품의 종속 항목을 선언한다.
    • BoM이 자동으로 해당 버전에 매핑된 개별 라이브러리 버전을 가져오기 때문에 BoM 버전을 업데이트하면 앱에서 사용하는 모든 Firebase라이브러리가 해당 BoM 버전에 매핑된 버전으로 업데이트 된다.

dependencies {
  // ...

  // Import the Firebase BoM
  implementation platform('com.google.firebase:firebase-bom:26.5.0')

  // BoM을 사용하기 때문에 Firebase 들의 version을 명시할 필요가 없다.

  // 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'
}

debug 인증서 지문

• 개발하는 과정에서 보통 release 용으로 빌드하지 않기 때문에 debug 인증서 지문으로 테스트할 수도 있으나, 배포단계에서는 사용하지 않아야 한다.

release 인증서 지문

• 실제로 배포한 앱에서 SHA-1 지문이 필요하다면, release 인증서 지문을 이용해야 하며, 배포용 앱을 생성할 때 서명한 keystore 파일의 경로와 비밀번호를 알고 있어야 한다.

참고 링크

• https://firebase.google.com/docs/android/learn-more?hl=ko#bom
• https://firebase.google.com/docs/android/setup?hl=ko