Unity용 Google 패키지 설치

Unity용 Google 패키지는 두 가지 형식으로 배포됩니다.

  • 애셋 패키지: <ph type="x-smartling-placeholder">
      </ph>
    • .unitypackage 확장자가 있어야 합니다.
    • 프로젝트의 Assets 디렉터리에 설치합니다.
    • Unity 5 이상에서 가져올 수 있습니다.
    • 일반적으로 종속 패키지가 포함됩니다.
  • Unity Package Manager (UPM) 패키지: <ph type="x-smartling-placeholder">
      </ph>
    • .tgz 확장자가 있어야 합니다.
    • 프로젝트의 Packages 디렉터리에 설치합니다.
    • Unity 2018.4 이상에서 가져올 수 있습니다.
    • 별도로 설치해야 하는 종속 패키지를 참조합니다.

패키지 페이지에는 최신 .unitypackage 파일이 포함되어 있습니다. 일부 패키지의 경우 .tgz 파일을 사용할 수 있습니다.

보관 파일 페이지에는 다음 사용자의 .unitypackage.tgz 파일이 포함되어 있습니다. 확인할 수 있습니다

아래에서 두 가지 유형의 패키지를 설치하는 방법에 대한 안내를 확인할 수 있습니다. .

이러한 설치 옵션에 익숙해지면 Firebase에 대한 추가 제품별 안내를 참조하세요.

.unitypackage 파일이 포함된 애셋 패키지 가져오기

Unity 메뉴 옵션을 선택하여 .unitypackage 파일 가져오기 Assets > Import package > Custom Package 및 모든 항목을 가져오는 중입니다. 애셋 아래의 프로젝트에 패키지 콘텐츠가 추가됩니다. 를 참조하세요.

.tgz 파일이 포함된 UPM 패키지 가져오기 (2018.4 이상)

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

manifest.json

  1. 프로젝트의 Packages 폴더 옆에 새 폴더를 만들고 이름을 지정합니다. GooglePackages입니다.
  2. 이 폴더에 .tgz 파일을 배치합니다.
  3. 텍스트 편집기를 사용하여 Unity 프로젝트에서 Packages/manifest.json 열기 있습니다.
  4. 설치하려는 각 패키지의 항목을 추가하여 패키지 이름을 매핑합니다. Packages/manifest.json 파일을 기준으로 디스크 상의 위치에 연결됩니다. .tgz 파일 경로에 file:를 추가해야 합니다. 대상 예를 들어 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. 추출된 폴더를 GooglePackages 폴더에 넣습니다.
  3. 추출된 폴더의 경로를 사용하도록 manifest.json을 수정하세요. 파일을 .tgz 파일로 변경합니다.

    {
      "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...
      }
    }
    

패키지 관리자 UI

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

    Unity Package Manager 창의 스크린샷

  3. 파일 브라우저에서 원하는 tarball을 선택합니다.

Unity의 일부 이전 버전은 tarball을 직접 추가하는 것을 지원하지 않습니다. 이 경우 다음을 수행해야 합니다.

  1. .tgz 파일의 압축을 풉니다.
  2. Package Manager의 왼쪽 상단에 있는 + 아이콘을 클릭합니다. 창을 열고 Add package from disk을 선택하여 파일 브라우저를 엽니다.

    Unity Package Manager 창의 스크린샷

  3. 파일 브라우저에서 추출된 폴더를 선택합니다.

패키지의 종속 항목의 .tgz 파일도 가져와야 합니다. 보관 파일 페이지의 선택합니다.

예를 들어 com.google.firebase.storage를 설치하는 경우 다음 .tgz 파일을 다음 순서로 설치합니다.

  1. 외부 종속 항목 관리자 (com.google.external-dependency-manager)
  2. Firebase Core (com.google.firebase.app)
  3. Firebase 인증 (com.google.firebase.auth)
  4. Firebase 저장소 (com.google.firebase.storage)

.tgz 파일을 한 번에 모두 추가하고 싶은 경우 자세히 알아보려면 manifest.json 탭에 입력합니다.

버전 제어

버전 제어 소프트웨어를 사용하여 프로젝트 파일을 관리하는 경우 관련 .tgz 파일을 버전 제어에 추가하는 것이 좋습니다. 수동으로 프로젝트의 manifest.json를 수정합니다. 위의 안내) 및 참조 로컬 .tgz 파일 상대 경로를 비교합니다.

git을 사용하는 경우 Git Large File Storage (LFS) - 대용량 .tgz 파일 관리에 적합합니다.

UPM 패키지에서 애셋 패키지로 마이그레이션

경우에 따라 Unity 패키지 관리자 Assets 폴더 아래 패키지를 설치할 수 있습니다.

다음을 사용하여 Unity Package Manager에서 모든 Google 패키지가 삭제되었는지 확인합니다. 다음 방법 중 하나를 사용합니다.

패키지 관리자 UI

  1. Unity의 Package Manager 창을 엽니다.
  2. 왼쪽 상단의 드롭다운에서 In Project를 선택합니다.

    Unity Package Manager 창의 스크린샷

  3. 검색창에 com.google를 입력하여 Google 패키지를 필터링합니다.

    Unity Package Manager 창의 스크린샷

  4. 각 패키지 이름을 클릭한 후 Remove를 클릭합니다.

manifest.json

  1. 텍스트 편집기를 사용하여 Unity 프로젝트에서 Packages/manifest.json 열기 있습니다.
  2. '종속 항목'에 Google의 패키지가 있는지 확인합니다. 패키지 이름은 'com.google'로 시작해야 합니다(예: 'com.google.firebase.app').
  3. 해당 줄을 삭제하고 json 파일을 저장합니다.
  4. Unity가 다시 포커스를 받으면 manifest.json 파일을 새로고침하고 삭제할 수 있습니다

Unity Package Manager에서 이러한 패키지를 제거한 후에는 다음을 수행할 수 있습니다. 아카이브에서 .unitypackage 대체 파일 다운로드 및 가져오기 페이지를 참조하세요.

애셋 패키지에서 UPM 패키지로 마이그레이션

경우에 따라 Search Console에서 제품을 설치하는 것에서 Unity Package Manager로 제품을 설치하고 추적하는 애셋 트리

어떤 설치 방법을 사용하고 있는지 잘 모르겠다면 Unity UI에서 원하는 Google 패키지가 프로젝트 탭의 애셋.

UPM 패키지로 마이그레이션하려면 다음 안내를 따르세요.

  1. 애셋 폴더에서 모든 Google 패키지가 삭제되었는지 확인합니다.

    • Firebase 패키지를 제거하려면 다음 단계를 따르세요. 이 안내를 따르세요.
    • Unity용 Play 플러그인을 제거하려면 GooglePlayPlugins 폴더를 삭제하세요. Assets 미만
  2. 설명한 대로 Unity Package Manager를 사용하여 패키지 설치 에서 확인하세요.

제품별 이전 안내

Firebase 안내는 여기를 참조하세요.