C++에서 Firebase 시작하기

1. 개요

이 Codelab에서는 Google 애널리틱스를 예로 사용하여 샘플 Android 게임에 C++ Firebase 게임 SDK를 통합하는 방법을 알아봅니다. 필요한 기능을 추가하고, 기본적인 분석 로직을 통합하여 플레이어의 진행 상황을 측정하며, 게임을 테스터와 공유하여 조기에 의견을 얻을 수 있습니다.

둘러보기

저자와 함께 이 Codelab을 살펴보려면 다음 동영상을 시청하세요.

학습할 내용

• Android CMake 기반 게임에 Firebase를 추가하는 방법
• 필요한 C++ 및 Gradle 종속 항목을 파악하는 방법
• 애널리틱스 이벤트를 로깅하는 방법
• 애널리틱스 이벤트를 디버그하는 방법
• 앱 배포와 게임을 공유하는 방법

필요한 항목

• Android 스튜디오
• 샘플 코드
• Google Play 서비스가 포함된 테스트 기기 또는 에뮬레이터

2. 샘플 코드 가져오기

GitHub에서 결제 또는 다운로드:

git clone https://github.com/FirebaseExtended/cmake-way-for-firebase.git

Firebase SDK 다운로드

MacOS/Linux:

sh download.sh

Windows (PowerShell에서):

./download.ps1

SDK를 직접 다운로드할 수도 있습니다. 이렇게 하려면 Firebase C++ SDK를 /third_party로 추출하여 firebase_cpp_sdk라는 폴더에 Firebase SDK의 루트 CMakeLists.txt가 포함되도록 해야 합니다.

3. 샘플 게임 실행

먼저 샘플 게임을 플레이하고 모든 것이 작동하는지 확인합니다. 순차적으로 생성된 레벨과 점프할 수 있는 단일 버튼이 있는 간단한 무한 러너입니다.

1. 파일 선택 > 신규 > 프로젝트 가져오기 (또는 스플래시 화면에서 프로젝트 가져오기 선택)
2. 저장소에 포함된 proj.android/ 폴더를 엽니다.

이 프로젝트는 일반적인 Android 프로젝트가 아닌 Cocos2dx 프로젝트입니다. 일반적으로 이 저장소의 루트에 build.gradle 파일이 있을 것으로 예상하지만 이 파일은 proj.android/ 아래에 있으므로 각 대상 운영체제가 자체 포함된 자체 빌드 프로세스를 보유할 수 있습니다.

3. [선택사항] proj.android/gradle.properties를 열고 PROP_APP_ABI을 실행합니다. 타겟 아키텍처를 제외한 나머지는 모두 삭제하여 빌드 시간을 줄일 수 있습니다. PROP_APP_ABI=x86는 PROP_APP_ABI=armeabi-v7a에서 대부분의 휴대전화용으로 빌드할 에뮬레이터 전용으로 빌드됩니다.
4. 디버그 버튼 을 클릭하여 게임을 빌드하고 실행합니다. Cocos2dx 게임 엔진을 구축하는 데는 시간이 걸립니다.

숙련된 Cocos2dx 개발자는 Cocos2dx CLI가 설치되어 있는 경우 cocos run -p android를 사용하도록 선택할 수 있습니다. Android 개발자는 ./gradlew installDebug를 선호할 수 있습니다. 이 튜토리얼에서는 Android 스튜디오를 사용하여 개발, 빌드, 배포한다고 가정합니다.

4. Firebase Console 설정

1. Firebase Console에서 새 프로젝트를 만듭니다. <ph type="x-smartling-placeholder"></ph>
2. 'Popsicle Runner'와 같은 이름을 지정하세요.
3. 애널리틱스 사용 설정
4. 애널리틱스 계정 추가 또는 만들기
5. 프로젝트에 새 Android 앱 추가
6. 패키지 이름으로 com.firebase.popsiclerunner를 추가합니다.

이 Codelab에서는 SHA-1이 필요하지 않습니다.

7. google-services.json을 다운로드하여 proj.android/app 에 복사합니다.

여러 소스 호스팅 서비스에서 google-services.json을(를) '보안 비밀'로 신고합니다. 커밋을 시도하지만 이 파일의 어떠한 내용도 실제 비밀이 아닙니다 (출시되는 게임에서는 이 파일의 콘텐츠를 검색하는 것이 간단함). 공개 소스 코드 리포지토리에 커밋할 계획이라면 여전히 주의해야 합니다. 이 파일이 공개적으로 게시되면 강력한 보안 규칙을 작성하기 전에 데이터베이스 또는 클라우드 스토리지 버킷을 훨씬 더 쉽게 찾을 수 있습니다.

8. Firebase SDK를 추가하는 방법을 무시하고 다음을 클릭합니다.
9. '이 단계 건너뛰기'를 클릭할 수 있습니다. 설치 확인 메시지가 표시되면

5. 게임에 Firebase 추가

CMakeLists.txt에 Firebase SDK 추가

루트 수준 CMakeLists.txt를 엽니다. 상단에 다음 코드가 있어야 합니다.

CMakeLists.txt

cmake_minimum_required(VERSION 3.6)

set(APP_NAME popsiclerunner)

project(${APP_NAME})

CMakeLists.txt 파일의 끝에 다음 줄을 추가합니다.

CMakeLists.txt

add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/third_party/firebase_cpp_sdk)
target_link_libraries(${APP_NAME} firebase_analytics firebase_app)

add_subdirectory에는 Firebase C++ SDK가 포함되어 있으며 이 게임에서 사용할 수 있습니다.

target_link_libraries Android용으로 빌드된 Firebase의 C++ 라이브러리로 게임에 연결합니다.

이 표를 참조하여 사용하려는 각 기능에 필요한 라이브러리를 알아보세요. 이렇게 firebase_analytics에 firebase_app이(가) 필요하다는 것을 알았습니다.

Google 서비스 플러그인 추가

Firebase SDK를 연결하려면 Gradle 빌드 스크립트에 Google 서비스 플러그인을 추가해야 합니다. 이렇게 하려면 프로젝트 수준 build.gradle 파일 (proj.android 폴더에 있음)을 엽니다. classpath 'com.google.gms:google-services:4.3.3'를 buildscript 종속 항목으로 추가합니다.

build.gradle

buildscript {
    repositories {
        google()
        jcenter()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:4.0.1'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
        classpath 'com.google.gms:google-services:4.3.3'  // Google Services plugin
    }
}

그런 다음 플러그인을 모듈 수준 build.gradle 파일 (proj.android/app 폴더에 있음)에 추가합니다. apply plugin: 'com.android.application' 아래에 apply plugin: 'com.google.gms.google-services'를 추가합니다.

build.gradle

apply plugin: 'com.android.application'
apply plugin: 'com.google.gms.google-services'  // Google Services plugin

Gradle에서 C++ SDK 찾기

Gradle에 Firebase C++ SDK를 찾을 위치를 알리려면 settings.gradle 파일 하단에 다음 줄을 추가합니다.

settings.gradle

gradle.ext.firebase_cpp_sdk_dir = "$settingsDir/../third_party/firebase_cpp_sdk/"
includeBuild "$gradle.ext.firebase_cpp_sdk_dir"

이는 CMake에서 add_subdirectory 호출과 동일한 위치를 가리켜야 합니다.

Android 종속 항목 추가

Firebase용 Android 종속 항목을 연결하려면 proj.android/app/build.gradle에서 popsicle_runner의 모듈 수준 gradle 파일을 열고 끝의 일반적인 dependences { 섹션 바로 앞에 다음을 추가합니다.

build.gradle

apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
firebaseCpp.dependencies {
    analytics
}

각 C++ SDK는 특정 버전의 Android SDK에 대해 빌드됩니다. firebaseCpp.dependencies는 필요한 Gradle 종속 항목을 검색하고 구성하여 확인된 구성이 있는지 확인하는 편의 함수입니다.

AndroidX 및 Jetifier

gradle.properties를 열고 이를 끝에 추가하여 AndroidX 및 Jetifier 지원을 추가합니다.

gradle.properties

android.useAndroidX = true
android.enableJetifier = true

게임에서 Firebase 초기화

게임에서 Classes/AppDelegate.cpp를 열어 Firebase를 초기화합니다. 상단에 다음 #include 지시어를 추가합니다.

AppDelegate.cpp

#include <firebase/app.h>
#include <firebase/analytics.h>

그런 다음 App::Create를 추가하고 필요한 Firebase 기능을 초기화합니다. 이렇게 하려면 AppDelegate::applicationDidFinishLaunching를 찾아 auto scene = MainMenuScene::createScene() 앞에 다음 코드를 추가합니다.

AppDelegate.cpp

{
    using namespace firebase;
    auto app = App::Create(JniHelper::getEnv(), JniHelper::getActivity());
    analytics::Initialize(*app);
}

익명의 블록 {}를 사용하여 using namespace firebase;와 같은 using 문의 범위를 제한하는 것이 좋습니다.

게임을 디버그하고 Firebase 대시보드를 새로고침하면 1분 정도 후에 신규 사용자 한 명이 표시됩니다.

6. 애널리틱스 추가

분석은 개발 초기 단계에서도 베타 테스터가 게임과 상호작용하는 방식을 측정하는 유용한 도구입니다. 유지 보고서와 같이 자동으로 수집되는 분석도 있지만 특정 게임에 맞춤화된 맞춤 이벤트를 추가하는 것이 유용합니다.

플레이어가 레벨을 시작할 때 분석 이벤트를 기록하는 것으로 시작하는 것이 좋습니다. 레벨 시작 이벤트의 수를 사용하여 플레이어가 한 세션에서 게임을 다시 플레이하는 빈도를 확인할 수 있습니다.

플레이어가 죽었을 때의 거리와 함께 이벤트가 기록됩니다. 이렇게 하면 변경사항이 단일 세션의 지속 시간을 어떻게 변경하는지 확인할 수 있고 플레이어가 더 짧은/더 어려운 게임을 또는 더 길거나 쉬운 게임을 원하는지 결정하는 데 도움이 됩니다.

애널리틱스 헤더 추가

Classes/PopsicleScene.cpp를 열고 분석을 호출할 수 있도록 상단에 Firebase 헤더를 추가합니다.

PopsicleScene.cpp

#include <firebase/analytics.h>
#include <firebase/analytics/event_names.h>

레벨 시작 이벤트 기록

Cocos2dx Director가 이 장면을 스테이징할 때 이벤트를 기록하려면 스텁 처리된 함수 PopsicleScene::onEnter()를 찾습니다. 다음 코드를 입력하여 여기에 레벨 시작 이벤트를 기록하세요.

PopsicleScene.cpp

using namespace firebase;
analytics::LogEvent(analytics::kEventLevelStart);

레벨 종료 이벤트 기록

플레이어가 얼마나 잘 하고 있는지 확인하기 위해 플레이어가 마침내 죽었을 때 이동한 거리와 함께 레벨 종료 이벤트를 기록해 보겠습니다. 이렇게 하려면 PopsicleScene::gameOver()를 찾아 _gameOver = true;를 설정하기 전에 if(!_gameOver) { 블록 끝에 다음을 추가합니다.

PopsicleScene.cpp

{
    using namespace firebase;
    analytics::LogEvent(analytics::kEventLevelEnd, "distance", _lastDistance);
}

kEventLevelEnd는 레벨 종료 이벤트입니다. 반면 "distance"는 '이벤트 매개변수'입니다. 여기에는 마지막으로 기록된 이동 거리가 추가됩니다. 이는 플레이어가 죽기 전에 이동한 거리의 추정치입니다.

7. 이벤트 테스트

지금 디버그 를 클릭할 수 있지만 애널리틱스 대시보드에 이벤트가 보고되기까지 시간이 걸립니다. 여기에는 두 가지 이유가 있습니다. 1) 배터리를 보존하기 위해 이벤트가 1시간에 한 번 일괄 처리 및 업로드되고 2) 보고서가 24시간마다 생성됩니다.

여러 가지 방법으로 이벤트를 더 빠르게 확인할 수 있습니다. 이벤트가 전환 이벤트로 표시되면 많은 상황에서 거의 실시간으로 보고됩니다. 또한 일중 표는 약 4시간 후인 BigQuery로 내보내도록 Google 애널리틱스를 구성할 수도 있습니다.

디버그 모드 사용 설정

기기를 디버그 모드로 설정하여 애널리틱스 이벤트를 디버그할 수도 있습니다.

먼저 Android 디버그 브리지 (ADB)가 설치되어 있는지 확인합니다. adb devices를 입력하면 테스트할 기기가 표시됩니다.

$ adb devices
List of devices attached
emulator-5554   device

그런 후 다음 adb shell 명령어를 실행합니다.

adb shell setprop debug.firebase.analytics.app com.firebase.popsiclerunner

이렇게 하면 Firebase 애널리틱스에 즉시 이벤트를 로깅하고, 테스트 시 라이브 이벤트의 오염을 방지하기 위해 일반 보고서에서 이러한 이벤트가 자동으로 제외됩니다. 나중에 이 작업을 실행취소하려면 다음과 같이 작성하면 됩니다.

adb shell setprop debug.firebase.analytics.app .none.

이벤트 보기

'DebugView'를 엽니다. (Firebase Console )

디버그 를 클릭하고 게임을 플레이합니다. 게임에서 새 이벤트가 발생하면 거의 즉시 표시됩니다.

level_end 이벤트를 펼치면 맞춤 '거리'도 표시됩니다. 매개변수만 표시됩니다.

level_end가 결국 이벤트 보고서에 포함되면 기본적으로 거리를 가져오지 않습니다. 이벤트 를 선택하고 level_end을 찾아 오른쪽에 있는 점 3개 를 펼친 후 매개변수 보고 수정을 선택하여 이벤트 보고서에 매개변수로 추가해야 합니다. 이 작업을 수행하고 나면 선수의 점수와 같은 통계를 볼 수 있습니다. 경기당 평균 이동거리입니다.

8. 테스터 찾기

다음으로는 스튜디오 내부 플레이어든, 가까운 친구든, 커뮤니티 플레이어든 상관없이 게임을 지켜보는 것이 좋습니다. Firebase 앱 배포를 사용하면 플레이어를 게임에 초대할 수 있습니다.

독립형 바이너리 빌드

먼저 빌드에서 공유할 독립형 APK를 빌드합니다. > 번들/APK 빌드 > APK 빌드

이전에 ABI 필터를 변경했다면 테스트할 기기를 포함하도록 gradle.properties로 돌아가서 PROP_APP_ABI를 변경해야 합니다.

PROP_APP_ABI=armeabi-v7a:arm64-v8a:x86

Android 스튜디오에 빌드된 파일을 찾을 수 있는 대화상자가 표시됩니다. 놓친 경우 '이벤트 로그'를 클릭하세요. 링크를 다시 가져올 수 있습니다.

Firebase 앱 배포에 업로드

1. 앱 배포를 열고 '시작하기'를 클릭합니다.
2. '새 버전을 만들려면 .apk를 여기로 드래그하세요.'라고 표시된 상자에 .apk 파일을 드래그 앤 드롭합니다.
3. 첫 번째 테스터로 이메일 주소를 입력합니다.
4. '다음'을 클릭합니다.
5. 설명을 추가하고 배포를 클릭

테스터 초대

모든 이메일 주소를 직접 입력할 필요 없이 초대 링크를 만들 수 있습니다. 이 초대 링크로 사용자를 캡처할 때 테스터 그룹에도 추가할 수 있습니다. 이렇게 하면 예를 들어 내부 테스터와 외부 테스터를 구분할 수 있습니다.

1. '테스터 및 그룹스"
2. 새 그룹 을 만들고 'Android 테스터'와 같은 이름을 지정합니다.
3. '링크 초대'를 클릭합니다.
4. '새 초대 링크'를 클릭합니다.
5. 드롭다운에서 그룹을 여기로 설정합니다.
6. '연결 만들기'를 클릭합니다.
7. '링크 복사'를 클릭합니다. 원하는 대로 공유할 수 있습니다.

9. 축하합니다

지금까지 C++ 기반 게임에 분석을 성공적으로 추가하고, 친구를 게임에 초대했으며, Android 개발에서 흔히 사용되는 CMake 및 Gradle 기반 빌드 시스템에서 Firebase 라이브러리를 찾아 연결하는 방법을 알아보았습니다.

학습한 내용

• Android CMake 기반 게임에 Firebase를 추가하는 방법
• 필요한 C++ 및 Gradle 종속 항목을 파악하는 방법
• 애널리틱스 이벤트를 로깅하는 방법
• 애널리틱스 이벤트를 디버그하는 방법
• 앱 배포와 게임을 공유하는 방법

다음 단계

• 익명으로 사용자를 로그인 처리하고 실시간 데이터베이스에 최고 점수를 저장해 보세요.
• 자체 게임에서 애널리틱스 이벤트를 로깅합니다.
• iOS 게임에 분석을 추가해 보세요.

자세히 알아보기

• 게임별 이벤트 목록을 확인하고 내 게임에 어떻게 적용될 수 있을지 생각해 보세요.