NuGet を使用したパッケージ管理 のバックアップ(No.4)

[ トップ ]   [ 新規 | 一覧 | 単語検索 | 最終更新 | ヘルプ ]

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• NuGet を使用したパッケージ管理 へ行く。
  • 1 (2015-10-07 (水) 16:17:26)
  • 2 (2016-01-26 (火) 13:35:28)
  • 3 (2017-01-16 (月) 10:10:20)
  • 4 (2017-01-16 (月) 17:02:45)
  • 5 (2017-02-16 (木) 14:26:55)
  • 6 (2017-03-03 (金) 21:40:06)
  • 7 (2017-04-22 (土) 17:42:47)
  • 8 (2017-12-08 (金) 10:13:06)
  • 9 (2018-01-09 (火) 19:30:23)
  • 10 (2018-01-12 (金) 11:39:53)
  • 11 (2018-01-16 (火) 16:27:51)
  • 12 (2018-01-22 (月) 17:10:59)
  • 13 (2018-09-16 (日) 20:00:49)
  • 14 (2018-09-19 (水) 12:17:53)
  • 15 (2019-03-18 (月) 23:32:06)
  • 16 (2019-03-27 (水) 20:47:28)
  • 17 (2019-03-28 (木) 09:05:08)

---

Open棟梁Project - マイクロソフト系技術情報 Wiki

• 戻る

目次 †

NuGet の操作 †

GUI での操作 †

Visual Studio の「NuGet パッケージの管理」画面で操作する。
[ツール]-[NuGet パッケージ マネージャー]-[ソリューションの NuGet パッケージの管理]

• CUI に比べると、できることが少ない
  インストールできるパッケージは、最新版のみで、バージョンを指定してのインストールはできない
• 更新ができない
  一旦アンインストールしたあと、再度最新版をインストールする

CUI での操作 †

Visual Studio の「パッケージ マネージャー コンソール」でコマンドを送信
[ツール]-[NuGet パッケージ マネージャー]-[パッケージ マネージャー コンソール]

参考 †

• NuGet で使用できる全コマンド
  https://docs.nuget.org/consume/package-manager-console-powershell-reference

主なコマンド †

• Get-Package
  インストール済みのパッケージ一覧を表示する。

• Get-Package {パッケージ名の一部}
  インストール済みのパッケージの中で、指定した名前をパッケージ名に含むものの一覧を表示する。

• Install-Package {パッケージ名}
  • 指定したパッケージの、最新バージョンをインストールする。
  • 指定したパッケージが、別のパッケージに依存している場合、そのパッケージもあわせてインストールされる。

• Install-Package {パッケージ名} -Version {バージョン番号}
  • 指定したパッケージの、指定したバージョンをインストールする。
  • 指定したパッケージが、別のパッケージに依存している場合、そのパッケージもあわせてインストールされる。

• Install-Package {パッケージ名} -ProjectName? {プロジェクト名}
  指定したパッケージを、指定したプロジェクトにインストールする。

• Update-Package
  現在インストールされているパッケージを、すべて最新版に更新する。

• Update-Package {パッケージ名}
  指定したパッケージを、最新バージョンに更新する。

• Update-Package {パッケージ名} -Version {バージョン番号}
  指定したパッケージを、指定したバージョンに更新する。

• Uninstall-Package {パッケージ名}
  指定したパッケージをアンインストールする。

• Uninstall-Package {パッケージ名} -RemoveDependencies?
  指定したパッケージが別のパッケージに依存している場合、
  指定したパッケージを削除することによって、依存している別のパッケージがどこからも参照されない状態になるのであれば、
  その依存している別のパッケージもアンインストールする。

• Uninstall-Package {パッケージ名} -Force
  指定したパッケージが、別のパッケージから依存されていても、強制的にそのパッケージをアンインストールする。

パッケージの更新 †

パッケージの更新 (Update-Package) を行うと、以下の操作が行われる。
(簡単のため、依存関係は省略している)

1. プロジェクトから、当該パッケージを削除する
   1. アセンブリ (*.dll) の場合、参照設定を解除する
   2. JavaScript や CSS の場合、ファイルそのものを削除する
2. packages.config から、当該パッケージの項目を削除する
3. packages フォルダから、古いバージョンのパッケージを削除する
4. 更新後のバージョンのパッケージを、packages フォルダにダウンロードする
5. packages.config に、更新後のパッケージの項目を追加する
6. プロジェクトに、更新後のパッケージを追加する
   1. アセンブリ (*.dll) の場合、参照設定を追加する
      (参照先は、packages フォルダの中)
   2. JavaScript や CSS の場合、プロジェクトにファイルをコピーする

このため、NuGet パッケージについては、この

• プロジェクトの参照設定 または プロジェクトに含まれる JavaScript / CSS などのファイル
• packages.config
• packages フォルダ

の整合性を保つため、コマンドを使用して NuGet 経由で管理することを基本とする。
(これらを手で編集することはオススメしない)

もし、こんなことをしてしまった場合はどうなる？ †

手動で、NuGet でインストールしたパッケージの参照設定を解除した †

ビルド †

• 参照設定を解除したパッケージを使用していない場合は、通る。
  
• (ただし、整合性は崩れたまま)

Install-Package †

• 既にインストールされています。というメッセージが表示され、変わりなし。
  
• (ただし、整合性は崩れたまま)

Update-Package †

• 当該パッケージに更新がなかった場合
  • 更新はありません。というメッセージが表示され、変わりなし。
  • (整合性は崩れたまま)

• 当該パッケージに更新があった場合
  • 問題なく更新が行われる。
  • 参照設定、packages.config、packages フォルダの整合性もなおる。

Uninstall-Package †

• packages.config からは削除されるが、packages フォルダから削除する際に、正常に削除できなかった旨の警告が出る。
• Visual Studio を再起動し、プロジェクトを再度開くと、そのときにpackages フォルダからパッケージが削除される。
  
• 参照設定、packages.config、packages フォルダの整合性もなおる。

packages フォルダから、手動でフォルダを消した †

消したパッケージが自動的に復元され、ビルドは正常終了する。

パッケージの復元は、Visual Studio や、MSBuild でビルドした際、
足りないパッケージを自動的に NuGet サイトからダウンロードする機能である。

パッケージの復元を行うための設定 †

• Visual Studio の [ツール]-[オプション] でオプション画面を開く。
• ツリーの中から、[NuGet パッケージ マネージャー]-[全般] を選択する。
• 「足りないパッケージをダウンロードすることを NuGet に許可」にチェックを入れる。

さらに、MSBuild などのコマンドラインツールでのビルド時に、足りないパッケージをダウンロードするには、以下の設定を行う。

• Visual Studio の [ソリューション エクスプローラー] を右クリックし、「Enable NuGet Package Restore」を選択する。

これにより、ソリューションフォルダ直下に「.nuget」フォルダができ、コマンドラインツールでのビルド時でも、足りないパッケージがあれば、ダウンロードしてくれる。
(MSBuild だけでなく、devenv によるビルドでも有効)

packages フォルダそのものを削除した †

上記と同様、パッケージが復元され、ビルドは正常終了する。

packages.config を手動で編集した †

<package> タグを消した †

• Install-Package
  成功 (ふたたび packages.config に <package> が生成される)
• Update-Package
  失敗 (パッケージがインストールされていないとのメッセージが表示される)
• Uninstall-Package
  警告 (packages フォルダから削除する際に、正常に削除できなかった旨の警告が出る。
  Visual Studio を再起動し、プロジェクトを再度開くと、そのときに packages フォルダからパッケージが削除される)

バージョン番号を編集した †

• 存在するバージョン番号の場合
  ビルドは成功し、編集したバージョン番号のパッケージが packages フォルダに格納される。
  このとき、編集前のバージョンのパッケージは packages フォルダからは削除されない。
  このため、以下の不整合が起きる。
  • packages フォルダに、バージョンの異なる 2 つのパッケージが混在する。
  • 参照設定も解除されないので、プロジェクトは編集前のバージョンのパッケージを参照し続ける。
  • このため、packages.config に書かれたバージョン番号と、実際に参照しているバージョン番号が一致しないことになる。
• 存在しないバージョン番号の場合 「NuGet パッケージの復元がプロジェクト {プロジェクト名} に対して失敗しました」というメッセージは表示されるが、
  • ビルド自体は成功する(編集前のバージョン番号のパッケージの削除が行われないため。)。
  • この場合も、以下の不整合が起きる。
    • packages フォルダには、編集前のバージョン番号のパッケージのみが残る。
    • 参照設定も解除されないので、プロジェクトは編集前のバージョンのパッケージを参照し続ける。
    • このため、packages.config に書かれたバージョン番号と、実際に参照しているバージョン番号が一致しないことになる。

アセンブリ参照先の種類 †

GAC (Global Assembly Cache) †

GAC に登録されるような従来のMicrosoft Windows Installerで配布されるようなパッケージは、今までどおり GAC に登録されているものを参照する。

NuGet †

GAC に登録されていないパッケージ (OSS ライブラリなど) は、もちろん個別にパッケージをダウンロードし、それを参照することもできる。
しかし、そのパッケージが NuGet に登録されていれば、NuGet のメリットを享受するために NuGet 経由でインストールするのが良いのではないかと思われる。

それ以外 †

GAC にも NuGet にも登録されていないパッケージを使用する場合は、個別にダウンロードし、プロジェクトから参照させる。

注意事項 †

ローカルコピー †

NuGet でインストールしたパッケージ (*.dll) は、GAC には含まれない。
このため、NuGet でインストールしたパッケージをアプリケーションで使用する場合、「ローカルコピー」は必ず「True」にしておくこと。

参考サイト †

• NuGet Gallery | Home
  https://www.nuget.org/
  • 現在登録されている NuGet パッケージを検索可能
• NuGet Docs
  http://docs.nuget.org/
  • NuGet の機能や使い方などのドキュメントを閲覧可能 (英語)
• .NET 用パッケージマネージャー NuGet のインストールと使い方
  http://yohshiy.blog.fc2.com/blog-entry-236.html

---

Tags: :デプロイ, :NuGet, :.NET開発

     

Site admin: dotNetDevelopmentInfrastructure

PukiWiki 1.4.7 Copyright © 2001-2006 PukiWiki Developers Team. License is GPL.
Based on "PukiWiki" 1.3 by yu-ji. Powered by PHP 5.3.3. HTML convert time: 0.040 sec.