Unity용 Google 패키지 설치

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

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

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

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

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

이러한 설치 옵션을 숙지한 후 Firebase에 관한 추가 제품별 안내를 참고하세요.

OpenUPM을 사용하여 패키지 가져오기

OpenUPM 레지스트리를 사용하여 Unity 프로젝트에 외부 패키지를 추가할 수 있습니다. OpenUPM은 사기 및 악용으로부터 앱을 보호하는 데 도움이 되는 Google Play Integrity 플러그인과 같은 유용한 플러그인과 SDK를 많이 호스팅합니다.

다음은 OpenUPM을 사용하여 Google Play Integrity 플러그인을 추가하는 방법을 보여주는 예입니다.

OpenUPM-CLI

OpenUPM CLI가 설치되어 있으면 다음 명령어를 사용하여 OpenUPM 레지스트리를 설치할 수 있습니다.

openupm add com.google.play.integrity

OpenUPM

1. Unity 메뉴 옵션 Edit > Project Settings > Package Manager(수정 > 프로젝트 설정 > 패키지 관리자)를 선택하여 패키지 관리자 설정을 엽니다.

2. 패키지 관리자 창에 OpenUPM을 범위 지정된 레지스트리로 추가합니다.

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
    com.google.play.common
    com.google.play.core
    com.google.play.integrity
   

3. Unity 메뉴 옵션 Window > Package Manager를 선택하여 패키지 관리자 메뉴를 엽니다.

4. 관리자 범위 드롭다운을 설정하여 내 레지스트리를 선택합니다.

   

5. 패키지 목록에서 Unity용 Google Play 무결성 플러그인 패키지를 선택하고 설치를 누릅니다.

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

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

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

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

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

manifest.json

1. 프로젝트의 Packages 폴더 옆에 새 폴더를 만들고 이름을 GooglePackages로 지정합니다.
2. 이 폴더에 .tgz 파일을 저장합니다.
3. 텍스트 편집기를 사용하여 Unity 프로젝트 폴더 아래에서 Packages/manifest.json을 엽니다.

4. 설치할 각 패키지의 항목을 추가하고 패키지 이름을 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...
     }
   }
   

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

Package Manager 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 대용량 파일 저장소 (LFS)를 사용하는 것이 좋습니다.

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

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

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

Package Manager UI

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

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

   

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

   

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 패키지로 마이그레이션

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

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

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

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

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

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

제품별 이전 안내

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