Unity용 Google 패키지 설치

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

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

패키지 페이지에는 사용 가능한 모든 패키지의 최신 .unitypackage 파일이 포함되어 있습니다.

보관 파일 페이지에는 모든 패키지 버전의 .unitypackage 및 .tgz 파일이 포함됩니다.

아래에서 두 유형의 패키지를 모두 설치하는 방법과 패키지 유형에서 다른 유형으로 전환하는 이전 안내를 확인할 수 있습니다.

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

.unitypackage 파일로 애셋 패키지 가져오기

Unity 메뉴 옵션 Assets > Import package > Custom Package를 선택하고 모든 항목을 가져와 .unitypackage 파일을 가져옵니다. 그러면 Assets 디렉터리 아래의 프로젝트에 패키지 콘텐츠가 추가됩니다.

참고: Unity의 Package Manager 창을 사용하여 패키지를 이미 설치한 경우 새 패키지를 가져오기 전에 이전 버전의 패키지를 제거합니다. 자세한 안내는 아래를 참고하세요.

.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. 다음과 같이 .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...
     }
   }
   

패키지 관리자 UI

1. Unity의 Package Manager 창을 엽니다.

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

   

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

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

1. .tgz 파일의 압축을 풉니다.

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

   

   참고: Unity 2018에서는 패키지 목록 창의 왼쪽 하단에 + 아이콘을 배치합니다.

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 Storage (com.google.firebase.storage)

순서를 걱정하지 않고 모든 .tgz 파일을 한 번에 추가하려면 manifest.json 탭의 안내를 따르세요.

참고: .unitypackage 파일이 있는 패키지를 이미 설치한 경우 새 패키지를 추가하기 전에 기존 버전의 패키지를 삭제해야 합니다. 자세한 안내는 아래를 참고하세요.

버전 제어

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

git을 사용하는 경우 큰 .tgz 파일을 관리하기 위한 Git Large File Storage (LFS)를 사용하는 것이 좋습니다.

UPM 패키지에서 애셋 패키지로 이전

경우에 따라 Unity Package Manager를 사용하여 Google 패키지를 관리하는 방식에서 Assets 폴더에 패키지를 설치하는 것으로 전환할 수 있습니다.

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

패키지 관리자 UI

1. Unity의 Package Manager 창을 엽니다.

2. 왼쪽 상단의 드롭다운에서 In Project를 선택합니다.

   

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

   

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

manifest.json

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

Unity Package Manager에서 이러한 패키지를 제거한 후에는 보관 페이지에서 대체 .unitypackage 파일을 다운로드하여 가져올 수 있습니다.

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

경우에 따라 애셋 트리 아래에 제품을 설치하는 것에서 Unity Package Manager를 사용하여 제품을 설치하고 추적하는 것으로 전환할 수 있습니다.

어떤 설치 방법을 사용하고 있는지 잘 모르겠다면 Unity UI에서 애셋 아래 프로젝트 탭에 원하는 Google 패키지가 표시되는지 확인합니다.

UPM 패키지로 마이그레이션하는 방법은 다음과 같습니다.

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

   • Firebase 패키지를 제거하려면 이 안내를 따르세요.
   • Unity용 Play 플러그인을 제거하려면 Assets에서 GooglePlayPlugins 폴더를 삭제합니다.

2. 위에서 설명한 대로 Unity Package Manager를 사용하여 패키지를 설치합니다.

제품별 이전 안내

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