パッケージを NuGet.org に発行する

  • [アーティクル]

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

NuGet.org は、開発者が再利用可能なコードを共有できるようにするパッケージ マネージャーです。 NuGet パッケージは、他のプロジェクトで使用できるコンパイル済みコードを含む拡張子を持つ .nupkg 圧縮ファイルです。 NuGet.org でホストされているパッケージは、世界中のすべての開発者が利用できます。

前提条件

プロジェクトの作成

独自の .NET プロジェクトを使用して NuGet パッケージをビルドして生成するか、次のように新しい基本的な .NET クラス ライブラリを作成できます。

  1. Visual Studio で、[ファイル]、[新規作成]、[プロジェクト] の順に選択します。

  2. クラス ライブラリ (.NET Standard) テンプレートを選択し、[次へ] を選択します。

  3. プロジェクトとソリューションに名前を付け、プロジェクトをローカルに保存する場所を選択します。 完了したら、[作成] を選択します。

    クラス ライブラリ プロジェクトを作成する

テンプレート クラス ライブラリは NuGet パッケージを作成するのに十分であるため、このチュートリアルでは既存のテンプレートを使用し、追加のコードは記述しません。

パッケージを設定して生成する

  1. ソリューション エクスプローラーからプロジェクトを選択し、右クリックして[プロパティ]、[パッケージ]の順に選択します。

  2. フォームに入力し、パッケージ ID が一意であることを確認します。そうしないと、NuGet.org 上の既存のパッケージと競合する可能性があります。一般的な名前付け規則は、Company.Product.Feature のようなものです。 プロジェクトをビルドするたびにパッケージを生成する場合は、[ビルド時に NuGet パッケージを生成する] チェック ボックスを選択します。

    パッケージのプロパティを構成する

  3. ソリューション エクスプローラーからプロジェクトを選択し、右クリックして [パック] を選択してパッケージを.nupkg生成します。

    パッケージを生成します

  4. 出力ウィンドウで pack コマンドの状態を確認します。

    パック出力

API キーを生成します

パッケージを nupkg 作成したので、発行する準備が整いましたが、まず、NuGet.org API に接続するための API キーを生成する必要があります。

  1. NuGet.org アカウントにサインインするか、まだ作成していない場合は作成します。

  2. ユーザー名アイコンを選択し、[API キー] を選択 します。

  3. [作成] を選択し、キーの名前を入力します。 キーに新しいパッケージとパッケージバージョンのスコープをプッシュし、glob パターン フィールドに入力*してすべてのパッケージを選択します。 完了したら、[作成] を選択します。

    API キーを作成する

  4. [コピー] を選択し、API キーを安全な場所に保存します。 NuGet パッケージを発行するには、このキーが必要です。

    API キーをコピーする

パッケージを NuGet.org に発行する

Web UI、dotnet CLI、または nuget.exe CLI を使用してパッケージを発行できます。 このセクションのコマンド ラインを使用して、パッケージの発行に重点を置きます。 これを行うには、パッケージの名前、API キー、およびソース URL が必要です。

  1. 管理者特権でのコマンド プロンプトで、パッケージが含まれているフォルダーに nupkg 移動します。

  2. 次のコマンドを実行して、パッケージを NuGet.org に発行します。プレースホルダーをパッケージ名と API キーに置き換えます。

    dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.json

  3. 前のコマンドの出力は次のようになります。

    パッケージの出力を発行する