NPM 설치 안내서
이 안내서는 React 애플리케이션용 NPM 설치를 다룹니다. React를 사용하지 않는 애플리케이션이나 간단한 스크립트 태그 통합의 경우 CDN 설치 안내서를 참조하세요.설치 방법
Moss SDK는 두 가지 설치 방법을 제공합니다:| 방법 | 최적 용도 | 설정 복잡도 |
|---|---|---|
| CDN 설치 | React 미사용 앱, 간단한 통합 | ⭐ 간단 |
| NPM 설치 (이 안내서) | React 앱, 완전한 TypeScript 지원 | ⭐⭐ 보통 |
전제 조건
- React 애플리케이션 (v17 이상)
- 활성화된 Node.js 환경 (v16 이상 권장)
1. GitHub 패키지 인증
Moss SDK는 GitHub에서 비공개 패키지로 호스팅됩니다. 이를 설치하려면 먼저 패키지 관리자(npm, pnpm, 또는 yarn)를 GitHub 패키지 레지스트리에 인증해야 합니다.개인용 액세스 토큰(PAT) 생성하기
- GitHub 개발자 설정에서 개인용 액세스 토큰(Personal access tokens)으로 이동합니다.
- **새 토큰 생성(Generate new token)**을 클릭하고 **새 토큰 생성(클래식)(Generate new token (classic))**을 선택합니다.
- 토큰에 설명적인 이름을 지정합니다(예:
moss-sdk-access). - 토큰의 **만료 기간(Expiration)**을 설정합니다. 보안을 위해 운영 환경에서는 “만료 없음(No expiration)“을 피하세요.
- **스코프 선택(Select scopes)**에서
read:packages스코프를 선택합니다. 이는 GitHub 패키지 레지스트리에서 패키지를 다운로드할 수 있는 권한을 부여합니다. - **토큰 생성(Generate token)**을 클릭합니다.
- 중요: 생성된 토큰을 즉시 복사하세요. 다시는 볼 수 없습니다.
패키지 관리자 설정하기
프로젝트 루트에.npmrc 파일을 생성하거나 업데이트해야 합니다. 이 파일은 패키지 관리자에게 @principles-first 스코프의 패키지를 처리하는 방법을 알려줍니다.
프로젝트의 루트 디렉토리에 .npmrc라는 이름의 파일을 만들고 다음 줄을 추가하세요:
.npmrc
.npmrc 파일에 한 줄을 추가하여 수행됩니다.
- macOS/Linux의 경우: 파일은
~/.npmrc에 위치합니다. - Windows의 경우: 파일은
C:\Users\YOUR_USERNAME\.npmrc에 위치합니다.
YOUR_PAT를 방금 생성한 개인용 액세스 토큰으로 바꾸세요:
2. SDK 설치하기
환경이 인증되면 선호하는 패키지 관리자를 사용하여 Moss SDK를 설치할 수 있습니다.3. 통합
설치 후에는 빠른 시작 안내서에 설명된 대로 SDK를 애플리케이션에 통합할 수 있습니다. 문제가 발생하면 개인용 액세스 토큰이 만료되지 않았는지, 올바른read:packages 스코프를 가지고 있는지 다시 확인하세요.