NuGet導入、NuGet登録のバックアップ(No.9) - Open 棟梁 Wiki

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

「Open棟梁 wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

戻る

目次 †

概要 †

v01-72から、NuGet利用を開始した。
これによりビルドシステムは大幅に改善した。

v02-00から、ASP.NET の Modernizationにより、
NuGet利用を大幅に拡大し、更なるビルドシステの改善を図った。

v02-10から、NuGet登録を行い、更なるビルドシステムの改善を図る。

NuGet? Gallery | Packages matching Touryo
https://www.nuget.org/packages?q=Touryo

NuGet?利用 †

NuGet?利用を開始したことにより、ビルドシステムは大幅に改善した。

v01-72から、 †

log4net や DotNetZip? などのライブラリ管理を NuGet? に変更。
これにより、今まで別途ダウンロードする必要のあったDLLをNuGet?から取得可能になった。

v02-00から、 †

ASP.NET Web Optimizationを行ったため、多数のコンポーネントをNuGet? から追加した。

また、Nuget使用時に「error MSB3086 Task could not find AL.exe」が発生し、
コレを解決するために、NuGet? 2.7 以降の自動復元への移行を行った。

v02-10から、 †

カスタマイズ可能レイヤ以外のライブラリをNuGet登録を行い、更なるビルドシステムの改善を図る。

NuGet?登録 †

対象 †

Public名前空間 †

Public.dll
その他、各種Dam*.dll
- NuGet?にdllが適切に登録されているものに限る
  - DamManagedOdp?
  - DamMySQL
  - DamPstGrS

これにより、テンプレート版も既定で以下のDBをサポートできるようになる。
- SQL Server
- ODBC, OLEDB
- Oracle
- MySQL
- PostgreSQL

Framework名前空間 †

Framework.dll

構成の変更 †

本体（母体） †

Public名前空間、Framework名前空間にのみ適用される。

実装 ---> テストの容易性を維持するために本体（母体）側の基本的なビルドシステムは現行を維持する。
しかし、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	OpenTouryo?.Public, etc.
2	title	Open棟梁 Public namespace, 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
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 †

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

DataAccess? †

データーアクセス部品

DamManagedOdp? †

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

DamPstGrS †

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

DamMySQL †

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

カスタマイズ †

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

.NET Standard †

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

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

参考 †

マイクロソフト系技術情報 Wiki †

NuGet †

NuGet を使用したパッケージ管理

NuGetパッケージの開発と公開

,etc.

.NETバージョンアップ > .NET Framework のバージョン †