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

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

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

戻る
- NuGet対応
- リリース情報

目次 †

概要 †

改善点 †

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登録を行い、

更なるビルド・システムの改善と、
リポジトリ内のソース・ファイルの重複の軽減を図る。

v02-20から、 †

以下の対応が行われた。

デバッグ用のシンボル・パッケージ格納
パッケージの作成・登録の自動化

バージョンアップ †

バージョンアップ（バージョン変更）は

GUI操作
CUI操作（Update-Packageなど）

により行うことができる。

参考 †

NuGet?登録 †

対象 †

Public名前空間 †

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

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

Framework名前空間 †

OpenTouryo?.Framework.dll
OpenTouryo?.Framework.RichClient?.dll

構成の変更 †

本体（母体） †

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

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

プロジェクト・ファイル（*.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	該当無し

.NET Standard対応 †

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

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

参考 †

NuGet導入後のデバッグ方法 †

NuGetからローカルに切り替える。 †

nuspecファイル †

テンプレート †

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

★ は必須入力

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

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
- https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/NuGet/Framework.RichClient.nuspec

DataAccess?