콘텐츠로 이동

Unity

Hercules Unity Package 설치 가이드

Hercules는 Unity Package Manager(UPM)를 통해 설치할 수 있습니다.

아래 두 가지 방법 중 하나를 선택하여 저장소와 Hercules 패키지를 추가합니다.


방법 1. manifest.json 파일을 직접 편집하여 설치

Unity 프로젝트의 다음 파일을 엽니다.

<유니티 프로젝트 경로>/Packages/manifest.json

manifest.json의 루트에 아래 내용을 추가하거나 기존 설정과 병합합니다.

{
  "scopedRegistries": [
    {
      "name": "Com2uS Platform Security Repo",
      "url": "https://aas-auth.withhive.com/upm",
      "scopes": [
        "com.com2us.security"
      ]
    }
  ],
  "dependencies": {
    "com.com2us.security.hercules": "26.9.8",
    ...
  }
}
Warning

기존 scopedRegistries 또는 dependencies 항목이 있는 경우 해당 항목을 삭제하거나 덮어쓰지 말고 위 내용을 기존 목록에 추가합니다.

설정을 저장한 후 Unity 프로젝트를 열면 Hercules 패키지가 자동으로 설치됩니다.

버전 변경

dependencies에 지정된 버전을 변경하면 원하는 버전의 Hercules로 업데이트할 수 있습니다.

"com.com2us.security.hercules": "26.9.8"

제거

dependencies에서 다음 항목을 삭제하면 Hercules 패키지가 제거됩니다.

"com.com2us.security.hercules": "26.9.8"

Hercules를 더 이상 사용하지 않는 경우 scopedRegistries에 추가했던 Com2uS Platform Security Repo도 함께 제거할 수 있습니다.

manifest.json 편집 방법에 대한 자세한 내용은 Unity 공식 문서를 참고하세요.


방법 2. Unity Editor에서 설치

1. Scoped Registry 추가

Unity 프로젝트를 열고 다음 메뉴로 이동합니다.

Edit > Project Settings > Package Manager

Scoped Registries에 다음 저장소를 추가합니다.

항목 값
Name Com2uS Platform Security Repo
URL https://aas-auth.withhive.com/upm
Scope(s) com.com2us.security

2. Hercules 패키지 추가

다음 메뉴를 엽니다.

Window > Package Manager

Package Manager 좌측 상단의 + 버튼을 누르고 Add package by name...을 선택합니다.

다음 정보를 입력합니다.

항목 값
Name com.com2us.security.hercules
Version 설치할 Hercules 버전 (선택 사항)

Version을 입력하지 않으면 최신 버전이 선택됩니다.

설치가 완료되면 Package Manager에서 Hercules 패키지를 확인할 수 있습니다.

버전 변경 및 제거

설치 이후에는 Unity Package Manager에서 Hercules의 버전을 변경하거나 패키지를 제거할 수 있습니다.

Hercules를 제거하고 더 이상 저장소를 사용하지 않는 경우 다음 위치에서 추가했던 Scoped Registry도 제거합니다.

Edit > Project Settings > Package Manager > Scoped Registries

Hercules 패키지를 직접 수정하여 사용하는 방법

설치된 Hercules 패키지를 직접 수정하여 사용하려면 패키지를 Embedded package로 변경합니다.

Unity Editor의 Project 창에서 설치된 Hercules 패키지를 우클릭한 후 Show in Explorer(Windows) 또는 Reveal in Finder(macOS)를 선택합니다.

열린 Hercules 패키지 폴더를 프로젝트의 Packages 폴더에 복사하고, 폴더명 뒤의 @<fingerprint> 부분을 제거합니다.

예를 들어 설치된 패키지가 다음과 같은 경우:

Library/PackageCache/com.com2us.security.hercules@26.9.8

다음 아래와 같은 형태가 되도록 합니다.

Packages/com.com2us.security.hercules

복사된 패키지는 Unity 프로젝트에 포함된 Embedded package로 인식되며, 이후 Packages/com.com2us.security.hercules 폴더의 파일을 직접 수정하여 사용할 수 있습니다.

Embedded package에 대한 자세한 내용은 Unity 공식 문서를 참고하세요.