npmへの公開
ライブラリのバージョンを管理して公開します
「npmへの公開」はCoddyKit上の無料Angular Academyレッスンです。 これはレッスン4/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはAngular Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Angular Academyコースには全4レッスンが含まれています。
ライブラリを世界に共有する
Angular Package Format にビルドしたライブラリは、通常は 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公開済みライブラリのインストール
利用者は通常の依存関係として追加し、public API からインポートします。Angular は生成された package.json を通じて FESM バンドルと型を見つけます。
npm install ui-kit
// then:
import { ButtonComponent } from 'ui-kit';プレリリースとタグ
不安定版のビルドは next などの dist-tag を付けて公開し、デフォルトの 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 でインストールし、public API からインポートします。信頼性を高めるため、公開は CI で自動化してください。
よくある質問
「npmへの公開」レッスンは無料ですか?
はい。「npmへの公開」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し(組み込みコードエディタと24時間対応のAIチューター)、Angular Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Angular Academyコースには全4レッスンが含まれています。
「npmへの公開」で何を学びますか?
ライブラリのバージョンを管理して公開します ブラウザで直接実行するハンズオンコードでAngular Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
Angular Academyを始めるのに経験は必要ですか?
事前経験は必要ありません。CoddyKitのAngular Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン4/4です。
「npmへの公開」レッスンにはどのくらい時間がかかりますか?
ほとんどのCoddyKitレッスンは約5~10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このAngular Academyレッスンでコードを書いて実行できますか?
はい。すべてのAngular Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。