Cloud Next 2025에서 Firebase의 최신 소식을 확인하세요. 자세히 알아보기

추가 Unity 설치 옵션

.NET 3.X 및 .NET 4.X용 .unitypackage 파일이 모두 포함되어 용량이 큰 .zip 파일을 다운로드하는 대신 Unity용 Google API 사이트에서 개별 패키지를 다운로드할 수 있습니다.

이 사이트에서는 다음을 제공합니다.

애셋 패키지로 가져올 개별 .NET 4.X .unitypackage 파일
Unity Package Manager를 사용하여 가져올 개별 .tgz 보관 파일

개별 .unitypackage 파일에는 필요한 모든 종속 항목이 포함되고 .tgz 파일은 의존하는 .tgz 파일과 함께 나열되므로 이 기능은 앱에서 단일 Firebase 제품을 사용할 때 특히 유용합니다.

이 페이지에서는 Unity Package Manager와 관련된 안내를 제공하므로 Unity 문서에서 해당 도구에 관한 내용을 살펴보는 것이 좋습니다.

Firebase 패키지를 애셋으로 가져오기

Unity용 Google API 사이트에서 다운로드한 .unitypackage 파일로 Firebase 제품을 가져올 때 다음 사항에 유의하세요.

프로젝트에서 Firebase 제품을 여러 개 사용하는 경우 모든 Firebase 제품을 다운로드하고 동일한 버전으로 업그레이드해야 합니다.
한 프로젝트에서 가져오기 방법을 혼합해서 사용하지 마세요. 즉, 애셋 패키지 흐름과 Unity Package Manager 흐름을 사용하여 Firebase 제품을 가져오지 마세요.

다운로드 후 가져오는 방법은 다음과 같습니다.

Unity 프로젝트를 열고 Assets(애셋) > Import Package(패키지 가져오기) > Custom Package(커스텀 패키지)로 이동합니다.
Import Unity Package(Unity 패키지 가져오기) 창에서 Import(가져오기)를 클릭합니다.

Unity Package Manager를 사용하여 Firebase 패키지 가져오기

Unity용 Google API 보관 파일에서 다운로드한 .tgz 파일로 Firebase 제품을 가져올 때 다음 사항에 유의하세요.

이 방법은 2018.3 이상에서만 사용할 수 있습니다.
프로젝트에서 Firebase 제품을 여러 개 사용하는 경우 모든 Firebase 제품을 다운로드하고 동일한 버전으로 업그레이드해야 합니다.
한 프로젝트에서 가져오기 방법을 혼합해서 사용하지 마세요. 즉, 애셋 패키지 흐름과 Unity Package Manager 흐름을 사용하여 Firebase 제품을 가져오지 마세요.
각 제품 .tgz 파일의 종속 항목은 자체 .tgz 파일과 함께 연결됩니다. 제품 .tgz 파일과 종속 항목 .tgz 파일을 다운로드하여 올바른 순서로 가져와야 합니다.
1. 외부 종속 항목 관리자(com.google.external-dependency-manager)
2. Firebase Core(com.google.firebase.app)
3. 프로젝트에서 사용되는 Firebase 제품입니다. Realtime Database 또는 Cloud Storage를 사용하는 경우 먼저 Authentication(com.google.firebase.auth)을 가져옵니다.

다운로드한 후 다음 방법 중 하나를 사용하여 .tgz 파일을 프로젝트로 가져옵니다.

Package Manager UI manifest.json

Unity의 Package Manager 창을 엽니다.
Package Manager 창의 왼쪽 상단 모서리에 있는 + 아이콘을 클릭하고 Add package from tarball을 선택하여 파일 브라우저를 엽니다.
파일 브라우저에서 원하는 tarball을 선택합니다.

Unity 2019의 일부 이전 버전에서는 tarball을 직접 추가할 수 없습니다. 이 경우 다음을 수행해야 합니다.

.tgz 파일의 압축을 풉니다.
Package Manager 창의 왼쪽 상단 모서리에 있는 + 아이콘을 클릭하고 Add package from disk을 선택하여 파일 브라우저를 엽니다.
파일 브라우저에서 추출된 폴더를 선택합니다.

프로젝트의 Packages 폴더 옆에 새 폴더를 만들고 이름을 GooglePackages로 지정합니다.
이 폴더에 .tgz 파일을 저장합니다.
텍스트 편집기를 사용하여 Unity 프로젝트 폴더 아래에서 Packages/manifest.json을 엽니다.

가져올 각 패키지의 항목을 추가하고 패키지 이름을 디스크의 위치에 매핑합니다. file:을 .tgz 파일 경로에 추가해야 합니다. 예를 들어 com.google.firebase.storage 및 종속 항목을 가져오는 경우 manifest.json은 다음과 같이 표시됩니다.

{
  "dependencies": {
    "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz",
    "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0.tgz",
    "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz",
    "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz",
    // com.unity package entries...
  }
}

manifest.json 파일을 저장합니다.
Unity가 다시 포커스를 받으면 manifest.json 새로고침 수행 후 새로 추가된 패키지를 가져옵니다.

Unity의 일부 이전 버전은 manifest.json에서 .tgz 파일을 지원하지 않습니다. 이 경우 다음을 수행해야 합니다.

.tgz 파일의 압축을 풉니다.

다음과 같이 .tgz 파일 대신 추출된 폴더의 경로를 사용하도록 manifest.json을 수정합니다.

{
  "dependencies": {
    "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164",
    "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0",
    "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0",
    "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0",
    // com.unity package entries...
  }
}

Unity Package Manager에서 애셋 패키지로 마이그레이션

경우에 따라 Unity Package Manager를 사용하여 Firebase 제품을 추적하는 것에서 Assets 폴더에 제품을 가져오는 것으로 전환할 수 있습니다.

어떤 가져오기 방법을 사용하고 있는지 잘 모르겠다면 Unity 프로젝트 폴더에서 Packages/manifest.json 파일을 엽니다. 파일에 com.google.firebase로 시작하는 항목이 포함된 경우 프로젝트에서 가져오기에 Unity Package Manager를 사용한 것입니다.

다음은 애셋 패키지로 마이그레이션하는 방법입니다.

프로젝트에서 현재 Firebase 패키지 버전을 확인하고 삭제합니다.
1. 창 메뉴에서 Package Manager를 선택합니다. Package Manager 창에서 'Packages: In Project(패키지: 프로젝트 내)'가 선택되었는지 확인합니다.
2. 가져온 Firebase 패키지 버전을 확인합니다.
3. 각 패키지 이름을 클릭한 다음 Remove(삭제)를 클릭합니다. 외부 종속 항목 관리자 패키지(.com.google.external-dependency-manager)와 Firebase 패키지도 삭제해야 합니다.
대체 .unitypackage 파일을 다운로드하고 가져옵니다. 다음과 같은 두 옵션을 선택할 수 있습니다.
- 각 패키지의 최신 버전으로 업그레이드할 수 있는 경우 Add Firebase to your Unity project(Unity 프로젝트에 Firebase 추가)에 설명된 대로 Firebase Unity SDK zip 파일을 다운로드하고 가져옵니다.
- 현재 .unitypackage 버전을 유지해야 하는 경우 이 페이지 위에서 설명한 대로 개별 패키지를 다운로드하고 가져올 수 있습니다.

애셋 패키지에서 Unity Package Manager로 마이그레이션

경우에 따라 Assets 폴더 아래에 제품 가져오기에서 Unity Package Manager를 사용하여 제품을 가져오고 추적하는 것으로 전환할 수 있습니다.

어떤 가져오기 방법을 사용하고 있는지 잘 모르겠다면 Unity 프로젝트 폴더에서 Packages/manifest.json 파일을 엽니다. 파일에 com.google.firebase로 시작하는 항목이 포함된 경우 프로젝트에서 이미 Unity Package Manager를 사용하여 가져오고 있는 것입니다.

Unity Package Manager로 마이그레이션하려면 다음 단계를 따르세요.

다음 방법 중 하나를 사용하여 모든 Firebase 패키지와 외부 종속 항목 관리자 패키지가 Assets 폴더에서 삭제되었는지 확인합니다.
EDM4U UI 수동 삭제
1. 열려 있는 Unity 프로젝트에서 Assets(애셋) > External Dependency Manager(외부 종속 항목 관리자) > Version Handler(버전 핸들러) > Uninstall Managed Packages(관리형 패키지 제거)로 이동합니다.
2. 모든 Firebase 패키지 및 외부 종속 항목 관리자를 선택합니다.
3. Uninstall Selected Package(선택한 패키지 제거)를 클릭합니다.
파일 시스템 도구를 사용하여 다음 폴더를 수동으로 삭제합니다.
- Assets/Editor Default Resources/Firebase
- Assets/ExternalDependencyManager
- Assets/Firebase
- Assets/Parse
- Assets/Plugins/iOS/Firebase
이 페이지 위에서 설명된 대로 Unity Package Manager를 사용하여 패키지를 가져옵니다.