Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

추가 Unity 설치 옵션

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

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

  • 에셋 패키지로 가져올 개별 .NET 4.X .unitypackage 파일.
  • Unity 패키지 관리자를 사용하여 가져올 개별 .tgz 아카이브.

이는 앱이 단일 Firebase 제품을 사용할 때 특히 유용합니다. 개별 .unitypackage 파일에는 필요한 모든 종속 항목이 포함되어 있고 .tgz 파일은 관련 .tgz 파일과 함께 나열되기 때문입니다.

이 페이지는 Unity 패키지 관리자와 관련된 지침을 제공하므로 Unity 설명서에서 도구에 대해 알아보는 것이 좋습니다.

Firebase 패키지를 자산으로 가져오기

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

  • 프로젝트에서 여러 Firebase 제품을 사용하는 경우 모든 Firebase 제품을 동일한 버전으로 다운로드하고 업그레이드해야 합니다.

  • 한 프로젝트에서 가져오기 방법을 혼합하지 마십시오. 즉, 에셋 패키지 흐름과 Unity Package Manager 흐름을 사용하여 Firebase 제품을 가져오지 마세요.

다운로드 후 가져오기:

  1. 열려 있는 Unity 프로젝트에서 Assets > Import Package > Custom Package 로 이동합니다.

  2. Unity 패키지 가져오기 창에서 가져오기 를 클릭합니다.

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

Google API for Unity 아카이브 에서 다운로드한 .tgz 파일에서 Firebase 제품을 가져올 때 다음 사항에 유의하세요.

  • 이 방법은 2018.3+에서만 사용할 수 있습니다.

  • 프로젝트에서 여러 Firebase 제품을 사용하는 경우 모든 Firebase 제품을 동일한 버전으로 다운로드하고 업그레이드해야 합니다.

  • 한 프로젝트에서 가져오기 방법을 혼합하지 마십시오. 즉, Asset 패키지 흐름 및 Unity Package Manager 흐름을 사용하여 Firebase 제품을 가져오지 마세요.

  • 각 제품 .tgz 파일의 종속성은 자체 .tgz 파일과 함께 연결됩니다. 올바른 순서로 제품 .tgz 파일 및 종속성 .tgz 파일을 다운로드하고 가져와야 합니다.

    1. 외부 종속성 관리자( com.google.external-dependency-manager )
    2. Firebase 코어( com.google.firebase.app )
    3. 프로젝트에 사용된 Firebase 제품입니다. 실시간 데이터베이스 또는 Cloud Storage를 사용하는 경우 먼저 인증( com.google.firebase.auth )을 가져옵니다.

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

패키지 관리자 UI

  1. Unity의 패키지 관리자 창을 엽니다.
  2. 패키지 관리자 창의 왼쪽 상단 모서리에 있는 + 아이콘을 클릭하고 Add package from tarball 를 선택하여 파일 브라우저를 엽니다.
  3. 파일 브라우저에서 원하는 타르볼을 선택합니다.

Unity 2019의 일부 이전 버전은 타르볼 직접 추가를 지원하지 않습니다. 이 경우 다음을 수행해야 합니다.

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

매니페스트.json

  1. 프로젝트의 Packages 폴더 옆에 새 폴더를 만들고 이름을 GooglePackages 로 지정합니다.
  2. .tgz 파일을 해당 폴더에 넣습니다.
  3. 텍스트 편집기를 사용하여 Unity 프로젝트 폴더에서 Packages/manifest.json 을 엽니다.
  4. 가져오려는 각 패키지에 대한 항목을 추가하여 패키지 이름을 디스크의 위치에 매핑합니다. 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...
      }
    }
    
  5. manifest.json 파일을 저장합니다.

  6. Unity가 다시 포커스를 받으면 manifest.json 을 다시 로드하고 새로 추가된 패키지를 가져옵니다.

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

  1. .tgz 파일의 압축을 풉니다.
  2. 다음과 같이 .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 패키지 관리자를 사용하여 Firebase 제품을 추적하는 것에서 Assets 폴더 아래의 제품을 가져오는 것으로 전환할 수 있습니다.

사용 중인 가져오기 방법이 확실하지 않은 경우 Unity 프로젝트 폴더에서 Packages/manifest.json 파일을 엽니다. 파일에 com.google.firebase 로 시작하는 항목이 포함되어 있으면 프로젝트에서 가져오기에 Unity 패키지 관리자를 사용한 것입니다.

자산 패키지로 마이그레이션하려면:

  1. 프로젝트의 현재 Firebase 패키지 버전을 기록하고 제거합니다.

    1. 메뉴에서 패키지 관리자 를 선택합니다. Package Manager 창에서 "Packages: In Project"가 선택되어 있는지 확인합니다.
    2. 가져온 Firebase 패키지의 버전을 기록해 둡니다.
    3. 각 패키지 이름을 클릭한 다음 제거 를 클릭하십시오. 외부 종속성 관리자 패키지( .com.google.external-dependency-manager )와 Firebase 패키지를 제거해야 합니다.
  2. 대체 .unitypackage 파일을 다운로드하고 가져옵니다. 두 가지 옵션이 있습니다.

    • 각 패키지의 최신 버전으로 업그레이드할 수 있는 경우 Firebase Unity SDK zip 파일을 다운로드하고 Unity 프로젝트에 Firebase 추가 에 설명된 대로 가져옵니다.
    • 현재 .unitypackage 버전을 유지해야 하는 경우 이 페이지에서 위에서 설명한 대로 개별 패키지를 다운로드하고 가져올 수 있습니다.

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

경우에 따라 Assets 폴더 아래의 제품 가져오기에서 Unity 패키지 관리자를 사용하여 제품 가져오기 및 추적으로 전환해야 할 수 있습니다.

사용 중인 가져오기 방법이 확실하지 않은 경우 Unity 프로젝트 폴더에서 Packages/manifest.json 파일을 엽니다. 파일에 com.google.firebase 로 시작하는 항목이 포함된 경우 프로젝트는 이미 가져오기에 Unity 패키지 관리자를 사용하고 있습니다.

Unity 패키지 관리자로 마이그레이션하려면:

  1. 다음 방법 중 하나를 사용하여 모든 Firebase 패키지와 외부 종속성 관리자 패키지가 Assets 폴더에서 제거되었는지 확인합니다.

    패키지 관리자 UI

    1. 열려 있는 Unity 프로젝트에서 Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages 로 이동합니다.
    2. 모든 Firebase 패키지와 외부 종속성 관리자를 선택합니다.
    3. 선택한 패키지 제거 를 클릭합니다.

    수동 제거

    파일 시스템 도구를 사용하여 다음 폴더를 수동으로 삭제합니다.

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase
  2. 이 페이지 의 위에 설명된 대로 Unity 패키지 관리자를 사용하여 패키지를 가져옵니다.