FCM 설정 및 안드로이드 앱 AAB, APK 파일 신청하기

구글 플레이에 내 모바일 앱을 등록하고 배포하려면 AAB(기존 사용자는 APK 파일도 이용 가능)이 필요합니다. 이 도움말에서는 아임웹 Android(안드로이드) 앱 신청자를 대상으로 푸시 알림 발송을 위한 FCM(Firebase Cloud Messaging)을 설정하고, Google 플레이에 앱을 등록하기 위한 AAB(또는 APK) 파일을 내려받는 과정을 설명합니다.

시작에 앞서

  • Android 앱 제작을 위해서는 Google Play 개발자 계정이 필요합니다.
  • 아임웹 Android 모바일 앱 이용료 결제를 완료해야 합니다. 모바일 앱 신청이 처음이라면, 전체적인 모바일 앱 제작 과정을 설명하는 모바일 앱 만들기 도움말을 확인해 보시길 바랍니다.

설정방법

내 사이트 관리자 페이지에서 Android 패키지 코드를 복사합니다.

  1. 내 사이트 관리자 페이지에 접속합니다. 접속방법
  2. 왼쪽 메뉴에서 [모바일 앱 > Android 앱]을 클릭해 이동합니다.
  3. 패키지 코드 항목에서 com.으로 시작하는 패키지 코드를 마우스로 드래그하여 복사합니다. (단축키: CTRL + C)

  4. 복사를 완료했으면 다음 2단계로 넘어갑니다.
  1. 새 브라우저 탭을 켜고, Firebase Console에 접속합니다. (Google 계정으로 로그인 필요)
  2. 프로젝트 만들기 버튼을 클릭합니다.

  3. 프로젝트 이름을 작성하고, 계속 버튼을 클릭합니다. (첫 프로젝트 생성 시 약관 동의 항목이 나타날 수 있으며, 항목 체크를 한 후 계속 버튼을 클릭 합니다.)

    참고: Google 지도 API 등으로 이미 생성한 기존 프로젝트가 있는 경우, 해당 프로젝트를 선택할 수 있습니다.

  4. Firebase 프로젝트를 위한 Google 애널리틱스 설정 화면이 나오면, 이 프로젝트에서 Google 애널리틱스 사용 설정을 끄고, 프로젝트 만들기 버튼을 클릭합니다.

    주의: 이 프로젝트에서 Google 애널리틱스 사용 설정을 활성화해도 전환추적 기능은 작동하지 않습니다.

  5. 잠시 후 아래와 같이 프로젝트 생성이 완료되면 계속 버튼을 클릭합니다.

  1. 새 프로젝트가 생성되면 프로젝트 개요 페이지가 나타납니다.
  2. 왼쪽 메뉴에서 [프로젝트 개요 > 2단계에서 생성한 프로젝트명]을 클릭하고, Android 아이콘을 클릭합니다.

  3. Android 패키지 이름에 위 1단계 3번 과정에서 복사한 패키지 코드를 입력하고, 앱 등록 버튼을 클릭합니다.

  4. google-services.json 다운로드 버튼을 클릭하여 google-services.json 파일을 내 PC에 내려받고, 다음 버튼을 클릭합니다.

  5. 3단계의 Firebase SDK 추가 단계는 생략하고 다음 버튼을 클릭합니다.
  6. 콘솔로 이동 버튼을 클릭합니다.
  1. 왼쪽 메뉴에서 프로젝트 개요(Project Overview)를 클릭합니다.

  2. 화면 상단에서 FCM을 설정할 Android 앱 프로젝트를 클릭합니다.

  3. 톱니바퀴 아이콘을 클릭합니다.

  4. 서비스 계정 탭을 클릭한 다음, 새 비공개 키 생성 버튼을 클릭합니다.

  5. 새 비공개 키 생성 창이 나타나면, 키 생성 버튼을 클릭합니다.

  6. 자동으로 json 확장자 형식 파일이 다운로드 됩니다.
참고: 만약 Firebase 의 한 프로젝트 내에 여러 앱이 존재하는 경우 동일한 비공개 키 파일을 사용해도 무방합니다.

유의사항

구글에서 보안정책 강화의 방법으로 비공개키 등록이 의무화 되었습니다.

기존 프로젝트 생성 시 비공개 키를 만들어 앱 생성 당시 만들었던 json 파일과 비공개키가 바르게 매칭되어야 알림이 발송됩니다. 기존에 이미 앱이 출시되었고, 비공개키 등록이 필요한 사이트는 기존 앱을 출시한 계정 및 프로젝트의 확인이 반드시 필요합니다. 

이 때, 구글 계정(개발자 계정) - 파이어베이스 세팅 계정과는 일반적으로 같지만 간혹 계정 확인이 어려운 경우가 있을 수 있습니다. 

  • 파이어베이스 세팅 계정 확인이 불가한 경우
  • 파이어베이스 프로젝트가 어떤 계정인지 모르는 경우
이런 경우에는 앱 푸쉬 설정을 다시하고 아임웹과 구글플레이에서 앱 업데이트를 진행해야 합니다. 아래 순서대로 진행을 해주세요.
  1. 아임웹 모바일 앱 메뉴에서 앱 업데이트를 클릭합니다.
  2. 업데이트가 완료된 파일을 다운로드 받습니다.
  3. 구글 플레이 스토어에서 앱 생성부터 다시 진행합니다. 
  4. 최종적으로 실제 유저(사용자)가 앱 업데이트를 진행하여야 알맞게 알림을 받을 수 있습니다.
    1. 앱 버전은 앱의 설정 버튼을 클릭한 뒤 확인이 가능합니다.
  1. 내 아임웹 사이트 관리자 페이지의 FCM 설정으로 돌아갑니다.
  2. google-service.json 파일 업로드 버튼을 클릭하고, 위 3단계 4번 과정에서 내려받은 google-services.json 파일을 올려줍니다.

    참고: 위 3단계 4번 과정에서 google-services.json파일을 내려받지 못했다면 일반 탭에서 다시 받을 수 있습니다.

  3. 비공개 키 파일의 파일 업로드 버튼을 클릭하고, 위 4단계 5번 과정에서 내려받은 json 파일을 올려줍니다. (파일명은 사용자 및 프로젝트에 따라 다릅니다.)

  4. 오른쪽 하단의 다음 버튼을 클릭해 앱 설정 단계로 이동합니다.
  5. 비공개 키만 등록하는 경우, FCM 설정페이지에서 파일을 업로드하고, '수정' 버튼을 클릭하시면 등록이 완료됩니다.

  1. 앱 설정에 필요한 정보를 입력합니다.

    참고: 앱 제목고해상도 아이콘은 필수 등록사항입니다.

  2. 오른쪽 하단의 다음 버튼을 클릭해 앱 등록 단계로 이동합니다.
  1. 약 5~10분 후 Android 앱 파일이 생성되면 AAB(또는 APK) 파일 다운로드 버튼을 클릭해 내 PC에 내려받습니다
  2. 이제 Google 플레이에 내 모바일 앱을 등록할 수 있습니다. 내 아임웹 모바일 앱을 구글 플레이(Google Play)에 등록하기도움말을 참고하여 Google 플레이에 앱 등록을 진행합니다.

    중요: 2021년 8월 이후 신규 앱 등록자는 Google Play에서 AAB 파일 형식으로만 앱 등록 진행할 수 있습니다.
  3. 앱 등록을 마쳤다면 완료버튼을 클릭해 Android 앱 관리 페이지로 이동합니다.

관련 도움말: 앱 업데이트란 무엇이고 어떻게 신청하나요?

아임웹은 사용자의 모바일 앱이 최신 iOS 및 Android 버전에 맞춰 유지될 수 있도록, 사용자의 모바일 앱 업데이트 서비스를 제공합니다. 내 모바일 앱을 최신 버전으로 유지하기 위해 아래 도움말 링크를 확인해 보시길 권장합니다.

앱 업데이트란 무엇이고 어떻게 신청하나요?

목록으로