0Pricing
Angular Academy · レッスン

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 version

npm へのログイン

公開前にレジストリで認証します。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フィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. ng generateによるライブラリ作成
  2. パブリックAPIとエントリーポイント
  3. ng-packagrによるビルド
  4. npmへの公開
← Angular Academyに戻る