# UDP 빌드에 Firebase 사용

> Learn how Firebase was used with Unity Distribution Portal builds, for a service that shut down in February 2025.

| **중요**                                                                                                                                                                                                                                                                                                                     |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UDP(유니티 퍼블리싱 포털)는 2025년 2월 17일에 종료됩니다. 이 날부로 UDP 웹 콘솔 및 서비스에 대한 액세스가 영구적으로 비활성화됩니다. 키스토어를 다운로드하고 게임을 앱 스토어에 직접 다시 퍼블리시하는 방법에 대한 지침을 보려면 [UDP 개요](https://api-udp.unity.com/overview) 페이지를 참조하십시오. 계정에 대한 질문이 있으면 [Unity 고객 지원 팀](https://support.unity.com/hc/en-us/requests/new?ticket_form_id=360000323692)에 티켓을 제출하십시오. |

Android 게임에 [Firebase](https://firebase.google.com/)를 구현하면 분석이나 [크래시 분석](https://firebase.google.com/docs/crashlytics) 등의 목적으로 Firebase 제품 레이어를 활용할 수 있습니다. 게임이 Firebase를 사용하는 경우 [UDP](https://unity.com/udp)(유니티 퍼블리싱 포털)에서 다른 스토어용으로 생성하는 빌드를 지원하려면 추가 [설정](#config)을 지정해야 합니다.

앱이 Firebase 제품을 호출하면 Firebase는 다음 정보가 Firebase 콘솔에 등록된 세부 정보와 일치하는지 확인합니다.

* 앱의 패키지 이름
* 앱 서명에 사용된 인증서
* Android 패키지(APK) 리소스의 google\_app\_id

Firebase가 정확한 분석을 제공하려면 이러한 세부 정보가 일치해야 합니다.

UDP를 통해 게임을 퍼블리시하는 특정 스토어의 경우 UDP는 패키지 이름에 스토어별 접미사를 추가합니다. 또한 자체 프라이빗 키를 사용하여 인증서를 생성하지 않는 경우 UDP는 리패킹된 각 빌드에 대한 인증서를 생성합니다. 이러한 이벤트로 인해 인증서 및/또는 패키지 이름이 Firebase 콘솔의 정보와 더 이상 일치하지 않게 됩니다.

패키지 이름 접미사가 필요한 스토어에 앱을 등록하면 UDP 콘솔에 Firebase 서비스 경고가 표시됩니다.


**UDP 콘솔의 Firebase 서비스 경고:**
![](/api/media?file=/engine/6000.0/media/images/udp-firebase-warning.png)

스토어별 빌드에서 Firebase가 올바르게 작동하도록 만들려면 해당 빌드를 Firebase 프로젝트에 등록해야 합니다. 다음 섹션은 UDP 빌드용으로 Firebase를 설정하는 방법에 대해 설명합니다.

## UDP 빌드용으로 Firebase 설정

이 섹션에서는 UDP 빌드(앱)에 대해 Firebase를 설정하는 데 필요한 단계에 대해 간략하게 설명합니다. 자세한 내용은 [Firebase 기술 자료](https://firebase.google.com/docs/unity/setup)를 참조하십시오.

### 선행 조건

* [Firebase 프로젝트를 생성](https://firebase.google.com/docs/unity/setup#create-firebase-project)하고 앱에 추가했습니다.
* 앱에 [Firebase Unity SDK를 추가](https://firebase.google.com/docs/unity/setup#add-sdks)했습니다.
* UDP 콘솔에서 [스토어에 게임을 등록](/engine/6000.0/manual/unity-services/udp/managing-and-publishing.md#register)했습니다.
* UDP에서 생성된 앱 서명 프라이빗 키를 사용하는 경우 앱을 리패킹한 후 퍼블리시해야 인증서가 생성됩니다.

**참고**: 앱 등록 프로세스 중에 google-services.json 파일을 다운로드할 수 있습니다. Unity는 이 파일을 다운로드하기 전에 모든 패키지 버전을 등록할 것을 권장합니다.

1. [Firebase에 앱을 등록](https://firebase.google.com/docs/unity/setup#register-app)합니다.
   * UDP 콘솔에서 스토어별 패키지 이름을 사용합니다. **My Games** > **Publish** > **Store** > **Advanced** 페이지에서 할 수 있습니다.

2. Firebase 콘솔에서 Project Settings로 이동한 후 앱의 지문 스토어 인증서를 추가합니다.

   * 자체 키를 사용하는 경우 다음과 같은 커맨드로 지문을 가져옵니다.

     `keytool -keystore path-to-your-keystore -list -v`
   * 자체 키를 사용하지 않는 경우 해당 UDP 스토어에 대해 SHA1 인증서를 사용합니다(**UDP Console** > **My Games** > **Publish** > **Store** > **Advanced**).
   * 또한 다음 커맨드를 사용하여 APK 인증서를 다운로드하고 지문 정보를 가져올 수 있습니다.

     `openssl x509 -in path-to-your-certificate -fingerprint -noout`

Firebase 프로젝트에 연결하려는 각 스토어별 앱에 대해 이 단계를 반복합니다. Firebase는 추가되는 각 앱에 앱 ID를 추가합니다.

모든 앱을 등록했으면 Unity 프로젝트에 [Firebase 설정 파일을 추가](https://firebase.google.com/docs/unity/setup#add-config-file)하십시오.

## Firebase 설정 파일 추가

Firebase에 앱을 등록하면 Firebase가 google-services.json 설정 파일을 생성합니다. Firebase에 모든 앱을 추가하면 파일을 다운로드하여 프로젝트에 추가합니다.

1. Firebase 콘솔에서 앱의 Project Settings 페이지로 이동합니다.
2. google-services.json 파일을 다운로드합니다.
3. google-services.json 파일을 Unity 프로젝트의 **Assets** 폴더에 복사합니다.

이제 프로젝트가 Firebase에 대해 올바르게 설정되었습니다. 앱의 안정적인 작동을 보장하려면 프로젝트를 다시 빌드하고 퍼블리시합니다.

## UDP 콘솔에서 Firebase ID 추가

Firebase에 추가한 각 빌드에 대해 UDP 콘솔에서 다음 단계에 따라 앱 ID를 추가하십시오.

1. Firebase에서 빌드별 앱 ID를 복사합니다.

2. UDP 콘솔에서 **My Games** > **Publish** > **Store** > **Advanced** 페이지로 이동합니다.

   1. 앱 ID를 **Firebase App ID** 필드에 붙여넣습니다.
   2. **Save**를 선택합니다.

## 프로젝트 재빌드

1. Unity 에디터에서 [프로젝트를 다시 빌드](https://docs.unity3d.com/Packages/com.unity.purchasing.udp@latest/index.html?subfolder=/manual/building-your-game.html)합니다.

2. 빌드를 UDP 콘솔에 업로드합니다.

3. 새 리비전을 릴리스합니다.

4. Publish 탭에서 퍼블리시할 각 스토어를 선택합니다.

   1. 타겟 단계를 **Submit to Store**로 설정합니다.
   2. **Publish**를 선택합니다.

이 단계에 대한 자세한 내용은 [UDP 콘솔에서 게임 관리 및 퍼블리싱](/engine/6000.0/manual/unity-services/udp/managing-and-publishing.md)을 참조하십시오.