추가 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
파일을 다운로드하여 올바른 순서로 가져와야 합니다.
- 외부 종속 항목 관리자(
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
은 다음과 같이 표시됩니다.
{
"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 패키지 버전을 확인하고 삭제합니다.
- 창 메뉴에서 Package Manager를 선택합니다. Package Manager 창에서 'Packages: In Project(패키지: 프로젝트 내)'가 선택되었는지 확인합니다.
- 가져온 Firebase 패키지 버전을 확인합니다.
- 각 패키지 이름을 클릭한 다음 Remove(삭제)를 클릭합니다. 외부 종속 항목 관리자 패키지(
.com.google.external-dependency-manager
)와 Firebase 패키지도 삭제해야 합니다.
대체 .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를 사용하여 패키지를 가져옵니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-12(UTC)
[null,null,["최종 업데이트: 2025-08-12(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."]]