프로젝트에서 Firebase 제품을 여러 개 사용하는 경우 모든 Firebase 제품을 다운로드하고 동일한 버전으로 업그레이드해야 합니다.
한 프로젝트에서 가져오기 방법을 혼합해서 사용하지 마세요. 즉, 애셋 패키지 흐름과 Unity Package Manager 흐름을 사용하여 Firebase 제품을 가져오지 마세요.
각 제품 .tgz 파일의 종속 항목은 자체 .tgz 파일과 함께 연결됩니다. 제품 .tgz 파일과 종속 항목 .tgz 파일을 다운로드하여 올바른 순서로 가져와야 합니다.
외부 종속 항목 관리자(com.google.external-dependency-manager)
Firebase Core(com.google.firebase.app)
프로젝트에서 사용되는 Firebase 제품입니다. Realtime Database 또는 Cloud Storage를 사용하는 경우 먼저 Authentication(com.google.firebase.auth)을 가져옵니다.
다운로드한 후 다음 방법 중 하나를 사용하여 .tgz 파일을 프로젝트로 가져옵니다.
Package Manager UI
Unity의 Package Manager 창을 엽니다.
Package Manager 창의 왼쪽 상단 모서리에 있는 + 아이콘을 클릭하고 Add package from tarball을 선택하여 파일 브라우저를 엽니다.
파일 브라우저에서 원하는 tarball을 선택합니다.
Unity 2019의 일부 이전 버전에서는 tarball을 직접 추가할 수 없습니다.
이 경우 다음을 수행해야 합니다.
.tgz 파일의 압축을 풉니다.
Package Manager 창의 왼쪽 상단 모서리에 있는 + 아이콘을 클릭하고 Add package from disk을 선택하여 파일 브라우저를 엽니다.
파일 브라우저에서 추출된 폴더를 선택합니다.
manifest.json
프로젝트의 Packages 폴더 옆에 새 폴더를 만들고 이름을 GooglePackages로 지정합니다.
이 폴더에 .tgz 파일을 저장합니다.
텍스트 편집기를 사용하여 Unity 프로젝트 폴더 아래에서 Packages/manifest.json을 엽니다.
가져올 각 패키지의 항목을 추가하고 패키지 이름을 디스크의 위치에 매핑합니다. file:을 .tgz 파일 경로에 추가해야 합니다. 예를 들어 com.google.firebase.storage 및 종속 항목을 가져오는 경우 manifest.json은 다음과 같이 표시됩니다.
경우에 따라 Unity Package Manager를 사용하여 Firebase 제품을 추적하는 것에서 Assets 폴더에 제품을 가져오는 것으로 전환할 수 있습니다.
어떤 가져오기 방법을 사용하고 있는지 잘 모르겠다면 Unity 프로젝트 폴더에서 Packages/manifest.json 파일을 엽니다. 파일에 com.google.firebase로 시작하는 항목이 포함된 경우 프로젝트에서 가져오기에 Unity Package Manager를 사용한 것입니다.
다음은 애셋 패키지로 마이그레이션하는 방법입니다.
프로젝트에서 현재 Firebase 패키지 버전을 확인하고 삭제합니다.
창 메뉴에서 Package Manager를 선택합니다. Package Manager 창에서 'Packages: In Project(패키지: 프로젝트 내)'가 선택되었는지 확인합니다.
가져온 Firebase 패키지 버전을 확인합니다.
각 패키지 이름을 클릭한 다음 Remove(삭제)를 클릭합니다. 외부 종속 항목 관리자 패키지(.com.google.external-dependency-manager)와 Firebase 패키지도 삭제해야 합니다.
대체 .unitypackage 파일을 다운로드하고 가져옵니다. 다음과 같은 두 옵션을 선택할 수 있습니다.
현재 .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
열려 있는 Unity 프로젝트에서 Assets(애셋) > External Dependency Manager(외부 종속 항목 관리자) > Version Handler(버전 핸들러) > Uninstall Managed Packages(관리형 패키지 제거)로 이동합니다.
모든 Firebase 패키지 및 외부 종속 항목 관리자를 선택합니다.
Uninstall Selected Package(선택한 패키지 제거)를 클릭합니다.
수동 삭제
파일 시스템 도구를 사용하여 다음 폴더를 수동으로 삭제합니다.
Assets/Editor Default Resources/Firebase
Assets/ExternalDependencyManager
Assets/Firebase
Assets/Parse
Assets/Plugins/iOS/Firebase
이 페이지 위에서 설명된 대로 Unity Package Manager를 사용하여 패키지를 가져옵니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[],[],null,["\u003cbr /\u003e\n\nRather than downloading a large `.zip` file containing all `.unitypackage`\nfiles for both .NET 3.X and .NET 4.X, you can download individual packages from\nthe [Google APIs for Unity site](https://developers.google.com/unity/packages).\n\nThe site provides:\n\n- Individual .NET 4.X `.unitypackage` files to import as Asset packages.\n- Individual `.tgz` archives to import using Unity Package Manager.\n\nThis is especially useful when your app uses a single Firebase product, since\nthe individual `.unitypackage` files contain all needed dependencies, and the\n`.tgz` files are listed alongside related `.tgz` files on which they depend.\n\nThis page provides instructions involving Unity Package Manager, so it's a good\nidea to learn about the tool [from the Unity documentation](https://docs.unity3d.com/Manual/Packages.html).\n| **Note:** If you still need to use .NET 3.x, download the entire Firebase SDK as described in [Add Firebase to your Unity project](/docs/unity/setup#add-sdks).\n\nImport Firebase packages as Assets\n\nWhen importing Firebase products from `.unitypackage` files downloaded from\n[Google APIs for Unity site](https://developers.google.com/unity/packages),\nkeep the following in mind:\n\n- If you are using multiple Firebase products in your project, you must download\n and upgrade all Firebase products to the same version.\n\n- Do not mix import methods in one project. That is, do not import\n Firebase products with the Asset package flow and using the Unity Package\n Manager flow.\n\nAfter downloading, to import:\n\n1. In your open Unity project, navigate to **Assets** \\\u003e **Import Package** \\\u003e\n **Custom Package**.\n\n2. In the *Import Unity Package* window, click **Import**.\n\nImport Firebase packages using Unity Package Manager\n\nWhen importing Firebase products from `.tgz` files downloaded from the [Google APIs for Unity archive](https://developers.google.com/unity/archive), keep the following in mind:\n\n- This method is only available in 2018.3+.\n\n- If you are using multiple Firebase products in your project, you must download\n and upgrade all Firebase products to the same version.\n\n- Do not mix import methods in one project. That is, do not import\n Firebase products with the Asset package flow and with the Unity Package Manager\n flow.\n\n- Dependencies for each product `.tgz` file are linked alongside in their own\n `.tgz` files. You must download and import the product `.tgz` file and\n dependency `.tgz` files, in the correct order:\n\n 1. External Dependency Manager (`com.google.external-dependency-manager`)\n 2. Firebase Core (`com.google.firebase.app`)\n 3. Firebase products used in your project. If you use Realtime Database or Cloud Storage, import Authentication (`com.google.firebase.auth`) first.\n\nAfter downloading, import `.tgz` files into your project using one of the\nfollowing methods: \n\nPackage Manager UI\n\n1. Open Unity's Package Manager window.\n2. Click the `+` icon in the top-left corner of the Package Manager window and select `Add package from tarball` to open the file browser.\n3. Select the desired tarball in the file browser.\n\nSome older versions of Unity 2019 do not support adding tarballs directly.\nIn this case, you will need to:\n\n1. Unzip the `.tgz` file.\n2. Click the `+` icon in the top-left corner of the Package Manager window and select `Add package from disk` to open the file browser.\n3. Select the extracted folder in the file browser.\n\nmanifest.json\n\n1. Create a new folder next to your project's `Packages` folder and name it `GooglePackages`.\n2. Place the `.tgz` files into that folder.\n3. Use a text editor to open `Packages/manifest.json` under your Unity project folder.\n4. Add an entry for each package you want to import, mapping the package name\n to the location on disk. Be sure to append `file:` to the `.tgz` file path. For\n example, if you were importing `com.google.firebase.storage` and its\n dependency's, your `manifest.json` would look like this:\n\n {\n \"dependencies\": {\n \"com.google.external-dependency-manager\": \"file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz\",\n \"com.google.firebase.app\": \"file:../GooglePackages/com.google.firebase.app-7.1.0.tgz\",\n \"com.google.firebase.auth\": \"file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz\",\n \"com.google.firebase.storage\": \"file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz\",\n // com.unity package entries...\n }\n }\n\n5. Save the `manifest.json` file.\n\n6. When Unity regains focus it will reload the `manifest.json` and import the\n newly-added packages.\n\nSome older versions of Unity do not support `.tgz` files in the `manifest.json`.\nIn this case, you should:\n\n1. Unzip the `.tgz` file.\n2. Edit your `manifest.json` to use the path to the extracted folder, instead\n of the `.tgz` file, like so:\n\n {\n \"dependencies\": {\n \"com.google.external-dependency-manager\": \"file:../GooglePackages/com.google.external-dependency-manager-1.2.164\",\n \"com.google.firebase.app\": \"file:../GooglePackages/com.google.firebase.app-7.1.0\",\n \"com.google.firebase.auth\": \"file:../GooglePackages/com.google.firebase.auth-7.1.0\",\n \"com.google.firebase.storage\": \"file:../GooglePackages/com.google.firebase.storage-7.1.0\",\n // com.unity package entries...\n }\n }\n\nMigrate from Unity Package Manager to Asset packages\n\nIn some cases, you might want to switch from using Unity Package Manager to\ntrack Firebase products, to importing products under the `Assets` folder.\n\nIf you're not sure which import method you're using, in your Unity project\nfolder, open the file `Packages/manifest.json`. If the file contains entries\nstarting with `com.google.firebase`, your project used Unity Package Manager for\nimport.\n\nTo migrate to Asset packages:\n\n1. Note current Firebase package versions in your project and remove them.\n\n 1. From the **Window** menu, select **Package Manager** . In the *Package\n Manager* window, make sure \"Packages: In Project\" is selected.\n 2. Note the versions of imported Firebase packages.\n 3. Click on each package name, then click **Remove** . Be sure to remove the External Dependency Manager package (`.com.google.external-dependency-manager`) as well as Firebase packages.\n2. Download and import replacement `.unitypackage` files. You have two options:\n\n - If you can upgrade to the latest version of each package, download the Firebase Unity SDK zip file and import as described in [Add Firebase to\n your Unity project](/docs/unity/setup#add-sdks).\n - If you need to preserve current `.unitypackage` versions, you can download and import individual packages as described [above](#alternative_individual_unitypackages) on this page.\n\nMigrate from Asset packages to Unity Package Manager\n\nIn some cases, you might want to switch from importing products under the\n`Assets` folder to importing and tracking products with Unity Package Manager.\n\nIf you're not sure which import method you're using, in your Unity project\nfolder, open the file `Packages/manifest.json`. If the file contains entries\nstarting with `com.google.firebase` your project is already using Unity Package\nManager for import.\n\nTo migrate to Unity Package Manager:\n\n1. Make sure all Firebase packages and the External Dependency Manager package\n are removed from the `Assets` folder, using either of the following methods.\n\n EDM4U UI\n\n\n 1. In your open Unity project, navigate to **Assets \\\u003e External\n Dependency Manager \\\u003e Version Handler \\\u003e Uninstall Managed\n Packages**.\n 2. Select all Firebase packages and External Dependency Manager.\n 3. Click **Uninstall Selected Package**.\n\n \u003cbr /\u003e\n\n Manual removal\n\n Using file system tools, manually delete the following folders:\n - `Assets/Editor Default Resources/Firebase`\n - `Assets/ExternalDependencyManager`\n - `Assets/Firebase`\n - `Assets/Parse`\n - `Assets/Plugins/iOS/Firebase`\n2. Import packages using Unity Package Manager, as described [above](#alternative_unity_package_manager)\n on this page."]]
