ng generateによるライブラリ作成

複数のアプリで同じコンポーネント、サービス、ユーティリティが必要な場合は、それらを Angular ライブラリとしてパッケージ化します。ライブラリは再利用、バージョン管理、公開が可能で、プロジェクト間でコードをコピー＆ペーストする必要がありません。

ライブラリは Angular の ワークスペース内に配置されます。ワークスペースとは、1 つの angular.json で管理され、複数のアプリやライブラリを含められるフォルダーです。既存のワークスペースにライブラリを追加することも、専用のワークスペースを作成することもできます。

ng generate library（エイリアスは ng g lib）を使うと、projects/ 配下に新しいライブラリプロジェクトのひな形が作成されます。

ライブラリには、専用の src/lib フォルダー、public-api.ts バレル、ビルド用の ng-package.json、そして angular.json のエントリが用意されます。自己完結したビルド可能なプロジェクトです。

--project で対象のライブラリを指定すると、ライブラリ内にコードを生成できます。CLI が適切なフォルダーにファイルを配置します。

現在のライブラリでは、スタンドアロンコンポーネントが推奨されています。利用側は NgModule なしで直接インポートできます。コンポーネントに standalone: true を指定すると、アプリから簡単なインポートで使用できます。

各ライブラリには独自の package.json があり、名前、バージョン、@angular/core などの peer dependencies を定義します。Peer dependency にすると Angular は利用側のアプリから提供されるため、重複したコピーを避けられます。

ライブラリの開発中に動作を確認できるよう、同じワークスペースにデモアプリを用意しておきます。ライブラリ名でインポートすると、tsconfig の TypeScript パスマッピングによってローカルのソースが解決されます。

アプリケーションはデプロイするためのもので、ライブラリは利用されるためのものです。ライブラリを直接サーブすることはできません。配布可能なパッケージにビルドし、公開するか、ワークスペース内のアプリからインポートします。

優れたライブラリには、UI キットやデータアクセス層など、明確な目的があります。無関係なコードを一緒に詰め込むのは避けてください。凝集度の高いライブラリほど、バージョン管理、ドキュメント作成、再利用が容易になります。

ライブラリのひな形ができたら、残る作業は public API の定義、Angular Package Format へのビルド、そして公開です。次のレッスンでは、それぞれについて学びます。

ライブラリはどのように作成しますか？

ライブラリは、複数のアプリで再利用するコードをパッケージ化したものです。ワークスペース内で ng generate library を実行して作成すると、src/lib、public-api.ts、ng-package.json、および peer dependencies を含む package.json が生成されます。--project でコードを追加し、スタンドアロンコンポーネントを優先し、各ライブラリの責務を明確にしてください。