Angular Academy · 강의

ng-packagr로 빌드하기

Angular 패키지 형식의 출력을 생성합니다.

ng-packagr로 빌드하기은(는) CoddyKit의 무료 Angular Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Angular Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Angular Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

라이브러리에는 특별한 빌드가 필요합니다

가공하지 않은 TypeScript와 템플릿을 게시할 수는 없습니다. 사용자는 컴파일되고 표준화된 출력을 기대합니다. 앵귤러 라이브러리는 앵귤러 패키지 형식(APF)으로 빌드하며, ng-packagr은 CLI가 내부적으로 사용하는 도구입니다.

앵귤러 패키지 형식

APF는 배포 가능한 앵귤러 라이브러리를 위한 공식 구조입니다. 최적화된 ES 모듈, 형식 정의, 메타데이터를 모든 앵귤러 앱이 라이브러리를 안정적으로 사용하고 트리 셰이킹할 수 있도록 배치합니다.

라이브러리 빌드하기

라이브러리 프로젝트를 대상으로 ng build를 실행합니다. CLI가 ng-packagr을 호출하고 패키징된 출력을 dist/에 기록합니다.

ng build ui-kit
# outputs dist/ui-kit in Angular Package Format

ng-packagr이 생성하는 항목

dist 폴더에는 컴파일된 FESM(평탄화된 ES 모듈) 번들, .d.ts 형식 파일, 그리고 올바른 module 및 types 진입 필드가 포함된 생성된 package.json이 들어 있습니다.

dist/ui-kit/
  fesm2022/ui-kit.mjs   # flattened ES module
  index.d.ts            # type declarations
  package.json          # generated, points to the above

ng-package.json 구성

각 라이브러리에는 출력 위치와 진입 파일을 ng-packagr에 알려 주는 ng-package.json이 있습니다. CLI는 빌드 중에 이 파일을 읽습니다.

// projects/ui-kit/ng-package.json
{
  "$schema": "../../node_modules/ng-packagr/ng-package.schema.json",
  "dest": "../../dist/ui-kit",
  "lib": { "entryFile": "src/public-api.ts" }
}

프로덕션 빌드

전체 최적화를 활성화하려면 프로덕션 구성으로 빌드하세요. 출력물이 게시할 대상이므로 항상 최적화된 버전을 패키징해야 합니다.

ng build ui-kit --configuration production

부분 컴파일

라이브러리는 완전히 컴파일하지 않고 부분 Ivy 모드로 컴파일합니다. 이를 통해 앵귤러 버전 간 호환성을 확보하며, 사용하는 앱이 자체 빌드 중에 컴파일 연결을 완료합니다.

출력물의 동료 의존성

ng-packagr은 앵귤러와 다른 동료 의존성을 번들에 포함하지 않고 외부 항목으로 유지합니다. 생성된 package.json에는 이 항목들이 peerDependencies로 나열되므로, 사용하는 쪽에서 공유 사본 하나를 제공합니다.

자산과 스타일

패키지에 스타일과 정적 자산을 포함할 수 있습니다. ng-package.json에 이를 선언하면 ng-packagr이 복사하고 처리하여 사용자를 위한 dist 출력물에 넣습니다.

"assets": ["./styles/theme.css"]

빌드 확인하기

빌드한 후 dist/ui-kit을 검사하세요. FESM 번들, .d.ts 파일, 그리고 exports/module 필드가 빌드된 파일을 가리키는 package.json이 있는지 확인합니다. 이것이 npm이 받게 될 결과물입니다.

개발용 감시 모드

--watch를 추가하여 편집할 때마다 자동으로 다시 빌드하세요. 데모 앱과 함께 사용하면 라이브러리 개발 중 빠른 피드백 순환을 얻을 수 있습니다.

ng build ui-kit --watch

빠른 확인

앵귤러 라이브러리는 어떤 형식으로 빌드되나요?

요약

ng build <lib>로 라이브러리를 빌드하면 ng-packagr이 실행되어 앵귤러 패키지 형식(FESM 번들, .d.ts, 생성된 package.json)을 dist/에 출력합니다. ng-package.json으로 출력을 구성하고, 프로덕션으로 빌드하며, 버전 간 호환성을 위해 부분 컴파일을 사용하고, 동료 의존성은 외부 항목으로 유지하세요.

자주 묻는 질문

“ng-packagr로 빌드하기” 강의는 무료인가요?

네 — “ng-packagr로 빌드하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Angular Academy 강의 전체를 잠금 해제할 수 있습니다. Angular Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“ng-packagr로 빌드하기”에서 뭘 배우나요?

Angular 패키지 형식의 출력을 생성합니다. 브라우저에서 직접 실행하는 실습 코드로 Angular Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Angular Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Angular Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“ng-packagr로 빌드하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Angular Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Angular Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Angular Academy(으)로 돌아가기