npm에 게시하기
라이브러리의 버전을 관리하고 게시합니다.
npm에 게시하기은(는) CoddyKit의 무료 Angular Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Angular Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Angular Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
라이브러리를 세상과 공유하기
앵귤러 패키지 형식으로 빌드한 라이브러리는 레지스트리, 일반적으로 npm에 게시합니다. 그러면 모든 프로젝트에서 npm install로 설치할 수 있습니다. 이 강의에서는 버전 관리와 게시 작업 흐름을 다룹니다.
소스가 아닌 dist 출력물 게시하기
생성된 package.json과 컴파일된 번들이 들어 있는 빌드된 패키지를 dist/<lib>에 게시하며, 원본 소스 프로젝트는 게시하지 않습니다. 빌드 단계가 패키지를 사용할 수 있는 형태로 만듭니다.
ng build ui-kit --configuration production
cd dist/ui-kit유의적 버전 관리
npm 패키지는 semver를 사용합니다: MAJOR.MINOR.PATCH. 수정 사항에는 PATCH, 하위 호환 기능에는 MINOR, 호환성을 깨는 변경에는 MAJOR를 올립니다. 사용자는 이를 바탕으로 안전하게 업그레이드합니다.
0.0.1 -> 0.1.0 # new feature, no breaks (minor)
0.1.0 -> 0.1.1 # bug fix (patch)
0.1.1 -> 1.0.0 # breaking change (major)버전 설정하기
버전은 라이브러리 자체의 package.json에서 가져옵니다. 빌드 전에 버전을 업데이트하거나 npm version을 사용해 일관되게 올리세요.
# inside projects/ui-kit (or use the field directly)
npm version minor # bumps and tags the versionnpm에 로그인하기
게시하기 전에 레지스트리에 인증하세요. npm login은 토큰을 저장하여 게시 명령을 인증합니다.
npm login
# enter username, password / token, email게시하기
빌드된 패키지 디렉터리에서 npm publish를 실행합니다. npm이 패키지를 업로드하면 이름과 버전으로 설치할 수 있게 됩니다.
cd dist/ui-kit
npm publish범위가 지정된 패키지
조직 패키지는 @myorg/ui-kit 같은 범위를 사용합니다. npm에서 범위가 지정된 패키지는 기본적으로 비공개이므로 공개하려면 --access public을 전달하세요.
npm publish --access public게시된 라이브러리 설치하기
사용자는 이를 다른 의존성과 같은 방식으로 추가하고 공개 API에서 가져옵니다. 앵귤러는 생성된 package.json을 통해 FESM 번들과 형식을 찾습니다.
npm install ui-kit
// then:
import { ButtonComponent } from 'ui-kit';사전 출시 버전과 태그
불안정한 빌드는 next 같은 배포 태그로 게시하여 기본값인 latest가 되지 않도록 하세요. 사용자는 명시적으로 선택하여 사용합니다.
npm publish --tag next
npm install ui-kit@next비공개 레지스트리
내부 전용 라이브러리는 .npmrc를 구성하여 비공개 레지스트리(npm 비공개 패키지, GitHub Packages 또는 Verdaccio)에 게시하세요. 레지스트리 URL과 인증 정보만 다를 뿐 게시 작업 흐름은 동일합니다.
CI에서 자동화하기
성숙한 팀은 태그가 지정된 출시 버전에서 CI를 통해 게시합니다. 파이프라인이 라이브러리를 빌드하고, 테스트를 실행하며, 저장된 토큰으로 npm publish를 실행합니다. 이렇게 하면 수동 실수를 피하고 버전을 커밋과 추적 가능하게 연결할 수 있습니다.
빠른 확인
npm에 무엇을 게시하나요?
요약
semver로 버전을 지정한 빌드된 dist/<lib> 출력물을 게시합니다. 버전을 올리고 npm login을 실행한 다음 npm publish를 실행하세요(범위가 지정된 패키지에는 --access public, 사전 출시 버전에는 --tag next를 추가합니다). 사용자는 npm install로 설치하고 공개 API에서 가져옵니다. 안정성을 위해 CI에서 게시를 자동화하세요.
자주 묻는 질문
“npm에 게시하기” 강의는 무료인가요?
네 — “npm에 게시하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Angular Academy 강의 전체를 잠금 해제할 수 있습니다. Angular Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“npm에 게시하기”에서 뭘 배우나요?
라이브러리의 버전을 관리하고 게시합니다. 브라우저에서 직접 실행하는 실습 코드로 Angular Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Angular Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Angular Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“npm에 게시하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Angular Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Angular Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.