Unity 패키지 관리자 설정 및 인증 방법
Unity는 다양한 패키지를 관리하기 위해 패키지 관리자 시스템을 제공합니다. 이 문서에서는 인증이 필요한 프라이빗 패키지를 설정하는 방법과 인증 토큰을 사용하는 법에 대해 설명하겠습니다.
인증이 필요한 레지스트리 설정
일부 기업에서는 패키지를 프라이빗 레지스트리에 호스팅하고 있으며, 접근을 위해 인증이 요구됩니다. npm 인증을 이용해 범위 지정 레지스트리를 설정하는 방법은 다음과 같습니다.
npm 인증 토큰 가져오기
- npm 설치: 먼저, 컴퓨터에 npm을 로컬로 설치하세요.
- 레지스트리 로그인: 터미널에서 아래 커맨드를 사용해 레지스트리에 로그인합니다.
$ npm login --registry <registry url> - .npmrc 파일 찾기: 생성된
.npmrc파일을 열고_authToken또는_auth항목을 찾아 해당 값을 복사합니다.
.npmrc 파일 예시
| 항목 | 예시 |
|---|---|
| 레지스트리 URL | https://example.com:1234/mylocation |
| _authToken | <AUTH TOKEN> |
| _auth | <AUTH TOKEN> |
<EMAIL> |
|
| always-auth | true |
인증 정보 추가하기
upmconfig.toml 파일에 인증 정보를 추가하여 패키지 관리자가 요청을 보낼 때 이 정보를 사용할 수 있도록 합니다.
upmconfig.toml 설정 예시
| 항목 | 설명 |
|---|---|
| [npmAuth." |
필수. 레지스트리 URL 예: npmAuth."https://example.com:8081/mylocation" |
필수. npm 레지스트리에서 생성된 인증 토큰. 예: token = "<AUTH TOKEN>" |
|
| 선택 사항. 레지스트리 사용자 이메일과 일치하는 이메일 주소 | |
| alwaysAuth | 선택 사항. 서버가 다를 경우 true로 설정 |
Bearer 인증 예시
| 항목 | 예시 |
|---|---|
| URL | http://localhost:8081/myrepository/mylocation |
| token | NpmToken.2348c7ea-6f86-3dbe-86b6-f257e86569a8 |
| alwaysAuth | true |
네트워크 문제 해결
네트워크 연결과 관련된 문제가 발생할 경우 다음 단계를 따르세요:
- 물리적 연결 확인: 네트워크 케이블이나 Wi-Fi의 연결이 정상인지 확인합니다.
- 레지스트리 URL 확인: 입력한 레지스트리 URL이 정확한지 확인합니다.
- 방화벽 설정 확인: 방화벽이나 보안 소프트웨어에서 인터넷 연결이 차단되었는지 확인합니다.
결론
이 가이드는 Unity 패키지를 사용할 수 있도록 인증이 필요한 레지스트리의 설정 방법을 설명했습니다. 인증 과정을 잘 마치면, Unity의 다양한 패키지를 효율적으로 관리할 수 있습니다. 더 궁금하신 사항이 있으시면 Unity 공식 문서나 커뮤니티 포럼에 문의해 주시기 바랍니다.