パッケージ作成ワークフロー
パッケージの作成はコンパイル済みコード (通常は .NET アセンブリ) から始めます。このコードはパッケージ化して、パブリック nuget.org ギャラリーまたは組織内のプライベート ギャラリーを通じて他のユーザーと共有します。 パッケージには、パッケージのインストール時に表示される Readme などの追加ファイルを含めることができます。また、特定のプロジェクト ファイルへの変換を含めることもできます。
パッケージは、独自のコードを含めずに、任意の数の他の依存関係にプルする場合にも対応できます。 このようなパッケージは、複数の独立したパッケージで構成される SDK を配信する便利な方法です。 その他の場合、パッケージにはデバッグを支援するシンボル (.pdb) ファイルのみを含めることができます。
Note
他の開発者が使用するパッケージを作成する場合は、他の開発者が自分の作業に依存していることを理解することが重要です。 したがって、パッケージの作成と発行は、バグの修正とその他の更新を行うことへのコミットメントも意味します。また、容易に保持できるように、少なくともパッケージをオープン ソースとして使用できるようにすることへのコミットメントも意味します。
どのような場合でも、パッケージの作成は、その識別子、バージョン番号、ライセンス、著作権情報、およびその他の必要なコンテンツを決定することから始まります。 完了したら、"pack" コマンドを使ってそれらすべてを 1 つの .nupkg ファイルにまとめることができます。 このファイルは、nuget.org などの NuGet フィードに公開することができます。
ヒント
.nupkg 拡張子を持つ NuGet パッケージは単なる ZIP ファイルです。 パッケージの内容を簡単に確認するには、拡張子を .zip に変更し、その内容を通常どおり展開します。 念のため、ホストへのアップロードを試行する前に拡張子を .nupkg に戻してください。
作成プロセスを学習して理解するために、まず、「Creating a package」 (パッケージの作成) を参照してください。ここでは、すべてのパッケージに共通の中核となるプロセスについて説明されています。
そこから、パッケージの他の多くのオプションを検討することができます。
- 「Supporting Multiple Target Frameworks」 (複数のターゲット フレームワークのサポート) では、さまざまな .NET Framework の複数のバリアントを含むパッケージを作成する方法が説明されています。
- 「Creating Localized Packages」 (ローカライズされたパッケージの作成) では、複数の言語リソースを含むパッケージを構築する方法と、個別のローカライズされたサテライト パッケージを使用する方法が説明されています。
- 「Pre-release Packages」 (プレリリース パッケージ) では、アルファ、ベータ、rc パッケージをそれらに関心のあるユーザー向けにリリースする方法が示されています。
- 「Source and Config File Transformations」 (ソースと構成ファイルの変換) では、プロジェクトに追加されたファイルでの一方向のトークン置換を実行する方法と、パッケージのアンインストール時に取り消すこともできる設定を使用して
web.configとapp.configを変更する方法が説明されています。 - 「Symbol Packages」 (シンボル パッケージ) では、コンシューマーがデバッグ時にコードにステップ インできるように、ライブラリでシンボルを提供するためのガイダンスが提供されています。
- 「Package versioning」 (パッケージのバージョン管理) では、依存関係 (自分のパッケージから利用する他のパッケージ) がある場合に使用できる正確なバージョンを特定する方法が説明されています。
- 「Native Packages」 (ネイティブ パッケージ) では、C++ コンシューマー用のパッケージの作成プロセスが説明されています。
- 「Signing Packages」(パッケージの署名) では、パッケージにデジタル署名を追加するプロセスが説明されています。
nuget.org にパッケージを発行する準備ができたら、「Publish a package」 (パッケージの発行) の簡単なプロセスに従います。
nuget.org ではなくプライベート フィードを使用する場合は、パッケージのホスティングの概要に関するページを参照してください。