パッケージの作成は、パブリック nuget.org ギャラリーまたは組織内のプライベート ギャラリーを使用して、パッケージ化して他のユーザーと共有するコンパイル済みコード (通常は .NET アセンブリ) から始まります。 パッケージには、パッケージのインストール時に表示される readme などの追加ファイルを含め、特定のプロジェクト ファイルへの変換を含めることもできます。
パッケージは、それ自体のコードを含まずに、他の任意の数の依存関係のみをプルするようにも機能します。 このようなパッケージは、複数の独立したパッケージで構成される SDK を提供する便利な方法です。 また、デバッグに役立つシンボル (.pdb) ファイルのみがパッケージに含まれている場合もあります。
注
他の開発者が使用するパッケージを作成するときは、作業に依存していることを理解しておくことが重要です。 そのため、パッケージの作成と公開は、バグを修正して他の更新を行う、または少なくともパッケージをオープン ソースとして利用できるようにするというコミットメントを意味し、他のユーザーがそれを維持するのに役立ちます。
どのような場合でも、パッケージの作成は、その識別子、バージョン番号、ライセンス、著作権情報、およびその他の必要なコンテンツを決定することから始まります。 完了したら、"pack" コマンドを使用して、すべてを .nupkg ファイルにまとめることができます。 このファイルは、nuget.org などの NuGet フィードに発行できます。
ヒント
.nupkg拡張子を持つ NuGet パッケージは、単なる ZIP ファイルです。 パッケージの内容を簡単に調べるには、拡張機能を .zip に変更し、通常どおりに内容を展開します。 ホストにアップロードする前に、拡張機能を .nupkg に戻してください。
作成プロセスを学習して理解するには、まず、すべてのパッケージに共通するコア プロセスをガイドするパッケージの 作成 から始めます。
そこから、パッケージのその他の多くのオプションを検討できます。
- 複数のターゲット フレームワークのサポートでは、 異なる .NET Framework の複数のバリアントを含むパッケージを作成する方法について説明します。
- ローカライズされたパッケージの作成 では、複数の言語リソースを使用してパッケージを構成する方法と、個別のローカライズされたサテライト パッケージを使用する方法について説明します。
- プレリリース パッケージ では、関心のあるお客様にアルファ、ベータ、rc のパッケージをリリースする方法を示します。
-
ソース ファイル変換と構成ファイル変換 では、プロジェクトに追加されたファイルで一方向トークンの置換を行い、パッケージのアンインストール時にもバックアウトされる設定で
web.configとapp.configを変更する方法について説明します。 - シンボル パッケージ には、デバッグ中にコンシューマーがコードにステップ インできるようにする、ライブラリのシンボルを指定するためのガイダンスが用意されています。
- パッケージのバージョン管理 では、依存関係に対して許可する正確なバージョン (パッケージから使用する他のパッケージ) を識別する方法について説明します。
- ネイティブ パッケージ では、C++ コンシューマー用のパッケージを作成するプロセスについて説明します。
- 署名パッケージ では、デジタル署名をパッケージに追加するプロセスについて説明します。
パッケージを nuget.org に発行する準備ができたら、「パッケージを発行する」の簡単なプロセス に従います。
nuget.org ではなくプライベート フィードを使用する場合は、「ホスティング パッケージの概要」を参照してください。