2022년 10월 18일에 오프라인과 온라인으로 진행될 Firebase Summit에 참여하세요. Firebase로 앱을 빠르게 개발하고 안심하고 앱을 출시하며 손쉽게 확장하는 방법을 알아보세요. 지금 등록하기

추가 Unity 설치 옵션

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

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

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

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

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

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

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

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

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

  • 한 프로젝트에서 가져오기 방법을 혼합하지 마십시오. 즉, 에셋 패키지 플로우와 Unity 패키지 관리자 플로우를 사용하여 Firebase 제품을 가져오지 마십시오.

다운로드 후 가져오기:

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

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

Unity 패키지 관리자를 사용하여 Firebase 패키지 가져오기

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

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

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

  • 한 프로젝트에서 가져오기 방법을 혼합하지 마십시오. 즉, 자산 패키지 플로우 및 Unity 패키지 관리자 플로우를 사용하여 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의 일부 이전 버전은 tarball을 직접 추가하는 것을 지원하지 않습니다. 이 경우 다음을 수행해야 합니다.

  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 패키지 관리자에서 에셋 패키지로 마이그레이션

경우에 따라 Unity 패키지 관리자를 사용하여 Firebase 제품을 추적하는 것에서 Assets 폴더 아래에 제품을 가져오는 것으로 전환하고 싶을 수 있습니다.

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

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

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

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

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

에셋 패키지에서 Unity 패키지 관리자로 마이그레이션

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

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

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

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

    패키지 관리자 UI

    1. 열려 있는 Unity 프로젝트에서 자산 > 외부 종속성 관리자 > 버전 처리기 > 관리 패키지 제거 로 이동합니다.
    2. 모든 Firebase 패키지와 외부 종속성 관리자를 선택합니다.
    3. 선택한 패키지 제거 를 클릭합니다.

    수동 제거

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

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