Unity 프로젝트에 Firebase 추가plat_iosplat_androidplat_unity

Firebase Unity SDK를 활용하여 Unity 게임을 업그레이드해 보세요.

Firebase를 Unity 프로젝트에 연결하는 것이 얼마나 간편한지 보여드리기 위해 Google은 MechaHamster라는 샘플 게임을 제작했으며 GitHub, App Store, Google Play 스토어에서 다운로드할 수 있습니다.

MechaHamster(GitHub)

MechaHamster(App Store)

MechaHamster(Play 스토어)

Firebase 게임 페이지에서 Firebase로 게임을 업그레이드하는 방법을 자세히 알아보세요.

1단계: 환경 설정

Unity 5.3 이상을 설치합니다.
(iOS만 해당) 다음에 대한 액세스 권한이 있어야 합니다.
- Xcode 9.4.1 이상
- CocoaPods 1.4.0 이상
Unity 프로젝트가 적절한 OS 수준을 타겟팅해야 합니다.
- iOS의 경우 — iOS 8 이상 타겟팅
- Android의 경우 — API 수준 16(Jelly Bean) 이상 타겟팅
Unity 프로젝트를 실행할 기기 또는 에뮬레이터에 액세스합니다.
- iOS의 경우 — Firebase 클라우드 메시징을 위해 다음 사항을 갖춰야 합니다.
  - 실제 iOS 기기
  - 푸시 알림이 사용 설정된 APN 인증서
- Android의 경우 — 에뮬레이터가 Google Play에서 에뮬레이터 이미지를 사용해야 합니다.
Google 계정을 사용하여 Firebase에 로그인합니다.

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

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

Unity 프로젝트에 Firebase를 추가하려면 Firebase 프로젝트를 만들어 Unity 프로젝트에 연결하면 됩니다.

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

Firebase 콘솔로 이동합니다.
프로젝트 추가를 클릭한 다음 프로젝트 이름을 선택하거나 입력합니다.
- 앱에 연결된 기존 Google 프로젝트가 있으면 프로젝트 이름 드롭다운 메뉴에서 프로젝트를 선택합니다.
- 기존 Google 프로젝트가 없으면 새 프로젝트 이름을 입력합니다.
(선택사항) 프로젝트 ID를 수정합니다.

Firebase는 Firebase 프로젝트에 자동으로 고유한 ID를 할당합니다. 이 식별자는 공개적으로 표시되는 Firebase 서비스에 나타납니다. 예를 들면 다음과 같습니다.
- 기본 실시간 데이터베이스 URL — your-project-id.firebaseio.com
- 기본 Cloud Storage 버킷 이름 — your-project-id.appspot.com
- 기본 호스팅 하위 도메인 — your-project-id.firebaseapp.com
Firebase에서 Firebase 프로젝트용 리소스를 프로비저닝한 후에는 프로젝트 ID를 변경할 수 없습니다.
따라서 Firebase 서비스에서 특정 식별자를 사용하려면 이 설정 단계에서 프로젝트 ID에 해당 식별자를 입력해야 합니다.
Firebase 콘솔에서 나머지 설정 단계를 따른 다음 프로젝트 만들기(또는 기존 Google 프로젝트를 사용 중인 경우 Firebase 추가)를 클릭합니다.

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

3단계: Firebase에 Unity 프로젝트 등록하기

1개 이상의 앱이나 게임을 Firebase 프로젝트에 연결하기 위해 등록할 수 있습니다.

Firebase 프로젝트 개요 페이지에서 Unity용 설정 마법사를 실행합니다.

참고: 이미 Firebase 프로젝트에 앱이나 게임을 추가했다면 앱 추가를 클릭하여 플랫폼 옵션을 표시하세요.
등록할 Unity 프로젝트의 빌드 대상을 선택할 수 있으며, 지금 대상을 둘 다 등록하도록 선택할 수도 있습니다.

참고: 지금 iOS 및 Android 빌드 대상을 동시에 등록할 수 있습니다. 또는 필요한 경우 지금 Unity 프로젝트의 빌드 대상 하나를 등록하고 나중에 이 설정 마법사로 돌아와서 다른 빌드 대상을 등록할 수도 있습니다.
Unity 프로젝트의 플랫폼별 ID를 입력합니다.
1. Unity IDE에서 Unity 프로젝트를 엽니다.
2. 빌드 설정 > iOS 또는 Android > 플레이어 설정 > 기타 설정으로 이동합니다.
  
  Unity 프로젝트의 ID는 번들 식별자 값(예제 ID: com.yourcompany.unity-project-name)입니다.
3. 플랫폼별 ID를 해당되는 각 필드에 입력합니다.
  - iOS의 경우 — iOS 번들 ID 필드에 Unity 프로젝트의 iOS ID를 입력합니다.
  - Android의 경우 — Android 패키지 이름 필드에 Unity 프로젝트의 Android ID를 입력합니다.
    - 패키지 이름과 애플리케이션 ID라는 명칭이 종종 서로 바꿔서 사용됩니다.
(선택사항) Unity 프로젝트의 플랫폼별 닉네임을 입력합니다.

이러한 닉네임은 편의상 지정하는 내부용 식별자로 Firebase 콘솔에서 나에게만 표시됩니다.
앱 등록을 클릭합니다.

4단계: Unity 프로젝트에 Firebase 구성 파일 추가

Firebase 콘솔 설정 마법사에서 플랫폼별 Firebase 구성 파일을 가져옵니다.

Unity 프로젝트의 iOS 및 Android 빌드 대상을 둘 다 등록하려는 경우 두 플랫폼 모두를 위한 구성 파일을 다운로드하고 추가해야 합니다.
- iOS의 경우 — GoogleService-Info.plist 다운로드를 클릭합니다.
  - 언제든 Firebase iOS 구성 파일을 다시 다운로드할 수 있습니다.
- Android의 경우 — google-services.json 다운로드를 클릭합니다.
  - 언제든 Firebase Android 구성 파일을 다시 다운로드할 수 있습니다.
Unity 프로젝트의 프로젝트 창을 연 다음 구성 파일을 Assets 폴더로 이동합니다.

참고: Assets 폴더 내의 원하는 위치에 Firebase 구성 파일을 배치할 수 있습니다.
Firebase 콘솔로 돌아가 설정 마법사 대화상자에서 다음을 클릭합니다.

참고: Firebase 구성 파일은 앱을 Firebase 프로젝트 및 리소스에 연결합니다.
플랫폼별 ID(Firebase 콘솔 설정 마법사에서 입력) 및 Firebase 프로젝트에 해당하는 값을 비롯한 파일 콘텐츠는 실시간 데이터베이스 URL 및 저장소 버킷 이름처럼 공개 상태로 간주됩니다. 이 경우 보안 규칙을 사용하여 실시간 데이터베이스, Cloud Firestore, 저장소의 데이터를 보호하세요.

대부분의 경우 사용자는 자체 Firebase 프로젝트를 만들고 앱을 자체 백엔드로 지정해야 하기 때문에 오픈소스 프로젝트에서는 소스 제어에 구성 파일을 포함하지 않는 것이 좋습니다.

5단계: Unity 프로젝트에 Firebase SDK 추가

이 섹션에서는 임의의 지원 Firebase 서비스를 Unity 프로젝트에 추가하는 방법을 예를 들어 단계별로 설명합니다. 이 예제에서는 Firebase용 Google 애널리틱스를 추가하는 과정을 단계별로 살펴봅니다.

Firebase 콘솔에서 Firebase Unity SDK 다운로드를 클릭한 다음, 원하는 위치에 SDK의 압축을 풉니다.
- 언제든 Firebase Unity SDK를 다시 다운로드할 수 있습니다.
- Firebase Unity SDK는 플랫폼별로 제공되지 않습니다.
Unity 프로젝트 열기 창에서 애셋 > 패키지 가져오기 > 맞춤 패키지로 이동합니다.
압축을 푼 SDK에서 선택하여 애널리틱스 SDK(FirebaseAnalytics.unitypackage)를 가져옵니다.

다른 지원 Firebase 서비스를 가져올 수도 있습니다.

Unity 5.x 이하 버전은 .NET 3.x 프레임워크를 사용하므로 dotnet3/FirebaseAnalytics.unitypackage를 가져오세요.

Unity 2017.x 이상 버전에서는 .NET 4.x 프레임워크를 사용할 수 있습니다. Unity 프로젝트가 .NET 4.x를 사용하는 경우 dotnet4/FirebaseAnalytics.unitypackage를 가져오세요.
Unity 패키지 가져오기 창에서 가져오기를 클릭합니다.
Firebase 콘솔로 돌아가 설정 마법사 대화상자에서 다음을 클릭합니다.

중요: iOS용 Firebase Unity SDK를 사용하는 경우 메소드 재구성을 중지하지 마세요. SDK에는 재구성이 필요하며 재구성이 없으면 FCM 토큰 처리와 같은 주요 Firebase 기능이 제대로 작동하지 않습니다.

6단계: Google Play 서비스 버전 요건 확인

Google Play 서비스가 최신 상태여야 Android용 Firebase Unity SDK를 사용할 수 있습니다.

애플리케이션 시작 시 다음 코드를 추가하세요. Firebase Unity SDK에서 다른 메소드를 호출하기 전에 Google Play 서비스를 확인하고 필요한 경우 SDK에 필요한 버전으로 업데이트해야 합니다.

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
    //   app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

이제 준비가 끝났습니다. Firebase 서비스를 사용하기 위한 Unity 프로젝트 등록 및 구성 작업을 마쳤습니다.

알려진 문제

Unity 2017.x 이상 버전을 사용하는 경우 .NET 호환성

Firebase는 Unity 2017 이상 버전에서 실험용 빌드 옵션으로 .NET 4.x를 지원합니다. 이전 버전의 .NET에서는 Firebase 플러그인이 Parse SDK 구성요소를 사용해 일부 .NET 4.x 클래스를 제공합니다.

따라서 Firebase Unity SDK 5.4.0 이상 버전은 Firebase Unity SDK의 dotnet3 및 dotnet4 디렉토리에서 .NET 3.x 또는 .NET 4.x와 호환되는 플러그인을 제공합니다.

프로젝트에서 사용 설정된 .NET 버전과 호환되지 않는 Firebase 플러그인을 가져오면 Parse SDK로 구현된 .NET 프레임워크에서 컴파일 오류가 발생할 수 있습니다.

.NET 3.x를 사용하는 경우 다음과 같은 방법으로 컴파일 오류를 해결하세요.

모든 플랫폼에서 다음 DLL을 삭제하거나 사용 중지합니다.
- Parse/Plugins/dotNet45/Unity.Compat.dll
- Parse/Plugins/dotNet45/Unity.Tasks.dll
모든 플랫폼에서 다음 DLL을 사용 설정합니다.
- Parse/Plugins/Unity.Compat.dll
- Parse/Plugins/Unity.Tasks.dll

.NET 4.x를 사용하는 경우 다음과 같은 방법으로 컴파일 오류를 해결하세요.

모든 플랫폼에서 다음 DLL을 삭제하거나 사용 중지합니다.
- Parse/Plugins/Unity.Compat.dll
- Parse/Plugins/Unity.Tasks.dll
모든 플랫폼에서 다음 DLL을 사용 설정합니다.
- Parse/Plugins/dotNet45/Unity.Compat.dll
- Parse/Plugins/dotNet45/Unity.Tasks.dll

다른 Firebase 플러그인을 가져오는 경우

Unity 프로젝트에서 애셋 > Play 서비스 리졸버 > 버전 핸들러 > 업데이트로 이동하여 프로젝트에 해당하는 정확한 DLL을 사용 설정합니다.

.NET 4.x 프로젝트에서 Unity 2017.1 IL2CPP 컴파일

따라서 Firebase Unity SDK 5.4.0이상 버전은 Parse 유형(예: System.Threading.Tasks.Task의 Parse 구현)을 .NET 프레임워크에 전달하는 유형 전달 DLL을 제공합니다. 하지만 Unity 2017.1.x에 제공된 IL2CPP(C#을 C++로 변환하는 변환기)는 유형 전달 DLL을 올바르게 처리하지 않기 때문에 다음과 비슷한 빌드 오류가 발생합니다.

Fatal error in Unity CIL Linker Mono.Cecil.ResolutionException: Failed to
resolve System.Threading.Tasks.TaskCompletionSource`1<T>

현재 Unity 2017.1에서 발생하는 .NET 4.x IL2CPP 빌드 오류에 사용 가능한 해결 방법은 없으므로 IL2CPP로 컴파일한 프로젝트에서 .NET 4.x를 사용하려면 Unity 2017.2 이상으로 업그레이드해야 합니다.

Unity 2017.2 네트워킹

Firebase 실시간 데이터베이스는 .NET 네트워킹 스택을 사용해 TLS 네트워크 연결을 만듭니다. Unity 2017.2에서는 .NET 4.6 사용 시 TLS 기능에 문제가 생겨 편집기 및 데스크톱의 실시간 데이터베이스 플러그인에 오류가 발생합니다.

이 문제는 해결할 방법이 없으며 2017.1 또는 2017.3 등 다른 버전의 Unity를 사용해야 합니다.

데스크톱 워크플로(베타) 설정

게임을 만들 때 Unity 편집기와 데스크톱 플랫폼에서 먼저 게임을 테스트한 다음, 개발 과정의 이후 단계에서 휴대기기에 배포하고 테스트하는 것이 한결 간편한 경우가 많습니다. Google에서는 이러한 워크플로를 지원하기 위해 Windows, OS X, Linux, Unity 편집기 내에서 실행할 수 있는 Firebase Unity SDK의 하위 집합을 제공합니다.

모바일 플랫폼과 동일한 안내에 따라 데스크톱 플랫폼 Unity 프로젝트를 설정합니다(위의 Firebase에 Unity 프로젝트 등록하기 단계부터 시작).
Unity IDE에서 내 Unity 프로젝트를 실행하거나 데스크톱용 Unity 프로젝트 빌드를 선택합니다.

참고: Firebase는 내가 Unity 프로젝트에 추가한 모바일 Firebase 구성 파일(GoogleService-Info.plist 또는 google-services.json)을 찾습니다. 그런 다음 모바일 구성 파일에서 데스크톱 Firebase 구성 파일(google-services-desktop.json)을 자동으로 생성합니다.
이 데스크톱 구성 파일에는 Firebase 콘솔 설정 마법사에 입력한 Unity 프로젝트 ID가 포함되어 있습니다. 이 파일은 앱을 Firebase 프로젝트와 연결합니다.
(선택사항) Unity 프로젝트를 편집 모드로 실행합니다.

Unity의 편집 모드에서도 Firebase Unity SDK를 실행할 수 있으므로 편집기 플러그인에서 사용할 수 있습니다.
1. 편집기에서 사용하는 FirebaseApp을 만들 때 기본 인스턴스를 사용하지 마세요.
2. 대신 FirebaseApp.Create() 호출에 고유한 이름을 제공합니다.
  
  이렇게 해야 Unity IDE에서 사용하는 인스턴스와 Unity 프로젝트에서 사용하는 인스턴스 간에 옵션 충돌을 방지할 수 있습니다.

지원 Firebase 서비스

iOS 및 Android에서 Firebase Unity SDK가 지원하는 Firebase 서비스는 다음과 같습니다.

Firebase 서비스	Unity 패키지
AdMob	AdMob Unity 플러그인으로 별도 배포
Analytics	FirebaseAnalytics.unitypackage
인증	FirebaseAuth.unitypackage
Crashlytics(베타)	FirebaseCrashlytics.unitypackage
실시간 데이터베이스	FirebaseDatabase.unitypackage
동적 링크	FirebaseDynamicLinks.unitypackage
Cloud Functions	FirebaseFunctions.unitypackage
초대	FirebaseInvites.unitypackage
클라우드 메시징	FirebaseMessaging.unitypackage
원격 구성	FirebaseRemoteConfig.unitypackage
Cloud Storage	FirebaseStorage.unitypackage

지원 Firebase 서비스(데스크톱)

Firebase Unity SDK에는 Unity 편집기 및 Windows, OS X, Linux의 독립형 데스크톱 빌드에서 Firebase의 특정 부분을 사용할 수 있도록 일부 기능에 대한 데스크톱 워크플로 지원이 포함되어 있습니다.

데스크톱 기능	라이브러리
인증	FirebaseAuth.unitypackage
Cloud Functions	FirebaseFunctions.unitypackage
실시간 데이터베이스	FirebaseDatabase.unitypackage
원격 구성	FirebaseRemoteConfig.unitypackage
Cloud Storage	FirebaseStorage.unitypackage

Firebase는 Windows, OS X, Linux용으로 빌드할 때 편의상 작동하지 않는 스텁 구현으로 나머지 데스크톱 라이브러리를 제공합니다. 따라서 데스크톱을 타겟팅하기 위해 코드를 조건부로 컴파일할 필요가 없습니다.

지원

Firebase 지원