NuGetパッケージのデバッグのバックアップ(No.3) - マイクロソフト系技術情報 Wiki

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

「マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

戻る

目次 †

目次
概要
登録
- （Primary packageに）PDB同梱
  - ポイント
  - 手順
- Symbol Package利用
利用
- （Primary packageに）PDB同梱
- Symbol Package
参考

概要 †

NuGetパッケージで展開されているモジュール内の
デバッグ実行が必要になった時の手順も確立しておく必要がある。

登録 †

（Primary packageに）PDB同梱 †

「NuGetパッケージの開発と公開」を参照。

ポイント †

Primary packageに、*.pdbファイル以外のすべてのファイル（*.dll、*.pdb、*.xml）を含める。

手順 †

パッケージ名
{identifier}.nupkg

Symbol Package利用 †

NuGetは、Symbol Packageを作成し、SymbolSource?リポジトリに公開することもサポート

ポイント †

*.dll、*.pdb、*.xmlに加え、ソースファイル（任意）を同梱。
libフォルダの構造はPrimary packageと完全に同じにする。
追加で、ソースファイルのルートフォルダをsrcに指定する。

準備 †

nuspecファイルの書き方の例（srcはソースファイルのルートフォルダ）

<files>
    <file src="Full\bin\Debug\*.dll" target="lib\net40" />
    <file src="Full\bin\Debug\*.pdb" target="lib\net40" />
    <file src="Silverlight\bin\Debug\*.dll" target="lib\sl40" />
    <file src="Silverlight\bin\Debug\*.pdb" target="lib\sl40" />
    <file src="**\*.cs" target="src" />
</files>

作成方法（以下の何れか）

nuget pack [*.nuspecファイルパス] -Symbols
nuget pack [*.csprojファイルパス] -Symbols

パッケージ名
{identifier}.symbols.nupkg

登録 †

概要
- NuGetプロトコルを実装するnuget.exe v4.1.0以上を使用
- nuget.orgとsymbolsource.orgの両方に登録を行う。

操作

便宜上、NuGetを使用してAPIキーを保存
```
nuget SetApiKey Your-API-Key
```

Primary packageをプッシュした後に、Symbol Packageをプッシュ
（*.symbols.nupkgとあれば自動的にsymbolsource.orgがターゲットになる。）
```
nuget push *.symbols.nupkg
```

Sourceオプションを使用して、Symbol Packageを別のSymbol Repositoryにプッシュ
- 命名規則に従わないSymbol PackageをSymbol Repositoryにプッシュする場合
- nuget.exe 4.5.0以降では、Symbol Packageを個別にsymbolsource.orgにプッシュする必要がある。
```
nuget push *.symbols.nupkg -source https://nuget.smbsrc.net/
```

Primary package、Symbol Packageの両方を同時に両方のRepositoryにプッシュすることもできる。
```
nuget push *.nupkg
```

※ https://nuget.smbsrc.net/ は、symbolsource.orgのプッシュURL。

利用 †

（Primary packageに）PDB同梱 †

*.pdbファイルが同梱されていれば、そのままデバッグ可能。
ただし、ソースファイルの配置については考慮が必要。

Symbol Package †

*.pdbファイルとソースファイルを自動的に取得してソースコードのステップインが可能

ただし、以下の設定が必要になる。

カスタムシンボルサーバ、ソースサーバの順序を有効にする。
[ツール] ---> [オプション] ---> [デバッグ] ---> [全般]
- [マイコードのみを有効にする]のチェックを外す。
- [.NET Framework ソースのステッピングを有効にする]のチェックを外す。

ソースサーバを有効にする。

シンボルサーバ、ソースサーバの追加
[ツール] ---> [オプション] ---> [デバッグ] ---> [シンボル] ---> [シンボルファイル (.pdb) の場所]
- http://referencesource.microsoft.com/symbols
- http://srv.symbolsource.org/pdb/Public or the authenticated variant (see above)
- http://srv.symbolsource.org/pdb/MyGet or the authenticated variant (see above)
- (other symbol servers with sources)
- http://msdl.microsoft.com/download/symbols
- (other symbol servers without sources)

参考 †

Microsoft Docs †

How to create NuGet symbol packages
https://docs.microsoft.com/ja-jp/nuget/create-packages/symbol-packages
How to Publish a NuGet Package
https://docs.microsoft.com/ja-jp/nuget/create-packages/publish-a-package

SymbolSource?.org †

Your source for debugging symbols... and sources.

Register
https://www.symbolsource.org/Public/Account/Register

Metadata
- Public
  http://www.symbolsource.org/Public/Metadata
- MyGet?
  http://www.symbolsource.org/MyGet/Metadata

ビルド環境と開発環境のソースファイルパスを一致させる（PDB）。 †

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