NuGet導入、NuGet登録のバックアップ(No.14)

実装 ---> テストの容易性を維持するために本体（母体）側の基本的なビルド・システムは現行を維持する。
しかし、NuGet?パッケージに登録するためのTarget Framework毎のビルドが可能になるようにする。
- Target Frameworkとして、以下をサポートする。
  - ~~net35~~ ( .NET Standard がサポートしている .NET Framework は 4.5 以上)
  - ~~net452~~ ( VS2015テンプレートが、既にnet46のため。)
  - net46
  - net47

プロジェクト・ファイル（*.csproj）をTarget Framework毎に準備する。
- プロジェクト・ファイル（*.csproj）の名称付与基準は、「*{framework name}[{version}].csproj」とする。
- プロジェクト・ファイル（*.csproj）では、以下のようなビルド出力を行う（src側のフォルダ構成を参考にする）。
  以下は、*.nuspecファイルのfilesセクションの定義例。
```
<files>
  <file src="bin\Release\net46\MyAssembly.dll" target="lib\net46" />
  <file src="bin\Release\net461\MyAssembly.dll" target="lib\net461" />    
  <file src="bin\Release\uap\MyAssembly.dll" target="lib\uap" />    
  <file src="bin\Release\netcore\MyAssembly.dll" target="lib\netcore" />
</files>
```

Target Framework毎のプロジェクト・ファイル（*.csproj）を纏めるソリューション・ファイル（*.sln）を準備する。
- ソリューション・ファイル（*.sln）の名称付与基準は、「*{framework name}[{version}].sln」とする。
ビルドバッチ（*.bat）では全てのTarget Framework毎のソリューション・ファイル（*.sln）をビルドする。

本体（母体）側のVisual Studioのバージョン
- 本体（母体）側は、最古のバージョンに固定するが、
- Public名前空間、Framework名前空間については、
  - ソリューション・ファイル（*.sln）
  - プロジェクト・ファイル（*.csproj）

を複数用意してmulti-version化する。

↑

テンプレート †

Public名前空間、Framework名前空間が、Nuget化される。

対象となる、Public名前空間、Framework名前空間のライブラリの参照設定をNuGet?に置き換える。

以下のカスタマイズ可能レイヤ、テンプレート部分は、
root_VS20XXのテンプレートに重複して保持する。

カスタマイズ可能レイヤ
- Business名前空間
- 各種カスタムコントロール
- 各種サービスインターフェイス
- , etc.

テンプレート部分
- Web系
- C/S系
- バッチ系
- , etc.

↑

nuspecファイル †

以下にnuspecファイルのコンテンツの方向性を纏める。

↑

概要 †

#	要素	内容
1	id	Touryo.Infrastructure.Public, etc.
2	title	OpenTouryo?.Public, etc.
3	version	・02-00 -> 2.0.0 ・02-10 - > 2.1.0 ・α・β -> こちら
4	authors	OSS Consortium .net subcommittee（※ comma 区切り）
5	owners	daisukenishino77（※ comma 区切り）
6	projectUrl	https://github.com/OpenTouryoProject
7	licenseUrl	https://github.com/OpenTouryoProject/OpenTouryo/blob/master/license/LICENSE.txt
8	iconUrl	64 * 64.icoファイルを別途準備してリンク - https://jyn.jp/iconfile_how_to_create/#i-5 - https://opentouryo.osscons.jp/OpenTouryo.ico
9	releaseNotes	https://github.com/OpenTouryoProject/OpenTouryo/releases
10	requireLicenseAcceptance?	true (エンプラ風)
11	tags	OpenTouryo?（※ space 区切り）
12	summary	概要説明文（一覧用）
13	description	詳細説明文
14	frameworkAssemblies - frameworkAssembly	.NET Frameworkアセンブリへの参照だが、テンプレート・プロジェクト経由の利用なので必須ではない。
15	dependencies - dependency	NuGet?パッケージへの参照だが、テンプレート・プロジェクト経由の利用なので必須ではない。
16	files - file	複数のTarget Frameworksのサポートする場合、Target Frameworks向けのassemblyを直接指定する
17	contentFiles - file	該当無し

↑

参考 †

https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/NuGet/template.nuspec

★ は必須入力

↑

Public, Framework †

共通部品とフレームワーク

↑

Public †

https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/NuGet/Public.nuspec

↑

Framework †

↑

DataAccess? †

データーアクセス部品

↑

カスタマイズ †

Public名前空間、Framework名前空間をカスタマイズが必要になった場合は、
本体（母体）側からソースコードを取出してローカルでビルド・参照設定を行う。

↑

.NET Standard †

Public名前空間から、.NET Standardに対応可能なクラスライブラリを抽出、
Standard名前空間のStandard.dllとして、NuGet?パッケージに登録する。

このライブラリは、Linuxや、Win10 IoT Core上で動作する
プログラム開発でユーティリティとして利用されることを想定する。

↑

注意 †

↑

一度登録すると通常消せない。 †

バージョン番号を上げてアップロードすることでアップデートする。
必要に応じて、別途、運営に連絡して削除することはできる。

↑

ビルドとデバッグ †

↑

ビルド †

'*.pdbを同梱する場合は、ビルド時のフォルダ構成に注意すること。

↑

デバッグ †

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

NuGet?パッケージは、「OpenTouryoProject/OpenTouryo」のソースファイルを使用している。
デバッグする際は、「OpenTouryoProject/OpenTouryo」のrootフォルダからファイルを取り出して、
フォルダ構成を維持したまま、上記の対象モジュールのソースファイルをC:\rootフォルダに配置する。

上記の準備が整えば、デバッグ実行で、これらのファイルに

ステップ・インしたり、
ブレーク・ポイントを設定したり、

して、デバック実行を、することができる。

しかし、

ステップ・インする際に、
「ソースファイルがモジュールがビルドされたときのものと異なります。デバッガでこのファイルを使用しますか？」

ブレーク・ポイントを設定した際に、
「ブレークポイントは、現在の設定ではヒットしません。ソースコードが元のバージョンと異なります。」

というメッセージが表示されデバッグできない場合は、

ソースファイルがモジュールがビルドされたときのものと異なります。デバッガでこのファイルを使用しますか？
https://visual-studio-professional.com/source-file-module-build
[ツール] ---> [オプション] ---> [デバッグ] ---> [全般] の順にクリックし、
[元のバージョンと完全に一致するソースファイルを必要とする] チェックボックスをオフにする。

の手順に従って、デバッグ実行が可能な設定に変更することができる。

↑