NuGet導入、NuGet登録 のバックアップソース(No.5)

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

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• バックアップ を表示
• NuGet導入、NuGet登録 へ行く。
  • 1 (2017-05-11 (木) 16:07:15)
  • 2 (2017-05-11 (木) 16:13:00)
  • 3 (2017-05-17 (水) 13:00:46)
  • 4 (2017-05-17 (水) 14:52:09)
  • 5 (2017-05-18 (木) 10:01:47)
  • 6 (2017-05-18 (木) 16:38:44)
  • 7 (2017-08-21 (月) 15:53:42)
  • 8 (2017-08-23 (水) 09:13:48)
  • 9 (2017-09-09 (土) 20:21:02)
  • 10 (2017-09-11 (月) 19:36:53)
  • 11 (2017-09-15 (金) 13:54:36)
  • 12 (2017-09-21 (木) 18:06:06)
  • 13 (2017-09-22 (金) 16:33:13)
  • 14 (2017-09-22 (金) 20:38:46)
  • 15 (2017-09-23 (土) 15:43:02)
  • 16 (2017-12-06 (水) 09:49:13)
  • 17 (2017-12-06 (水) 20:44:47)
  • 18 (2017-12-23 (土) 15:48:49)
  • 19 (2018-02-07 (水) 10:16:25)
  • 20 (2018-03-07 (水) 13:42:00)
  • 21 (2018-03-12 (月) 12:18:32)
  • 22 (2018-04-03 (火) 10:29:35)
  • 23 (2018-06-19 (火) 13:44:52)
  • 24 (2018-07-30 (月) 16:34:48)
  • 25 (2018-08-28 (火) 14:22:03)
  • 26 (2018-12-15 (土) 19:23:11)
  • 27 (2018-12-17 (月) 18:20:36)
  • 28 (2018-12-19 (水) 11:50:32)
  • 29 (2019-09-04 (水) 10:20:32)
  • 30 (2019-09-04 (水) 14:59:33)
  • 31 (2019-12-24 (火) 12:05:56)

「[[Open棟梁 wiki>https://opentouryo.osscons.jp]]」は、「[[Open棟梁Project>https://github.com/OpenTouryoProject/]]」,「[[OSSコンソーシアム .NET開発基盤部会>https://www.osscons.jp/dotNetDevelopmentInfrastructure/]]」によって運営されています。

-[[戻る>リリース情報]]

*目次 [#p14e365a]
#contents

*概要 [#sa0c2baa]
-[[v01-72>リリース情報#g5e9bdde]]から、[[NuGet利用>#mda95a7a]]を開始した。これによりビルドシステムは大幅に改善した。
-[[v02-x0>リリース情報#j62bae77]]から、[[NuGet登録>#l902543f]]を行い、更なるビルドシステムの改善を図る。

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

**[[v01-72>リリース情報#g5e9bdde]]から、 [#m04b1223]
-log4net や DotNetZip などのライブラリ管理を NuGet に変更。
-これにより、今まで別途ダウンロードする必要のあったDLLをNuGetから取得可能になった。

**[[v02-00>リリース情報#i11149ce]]から、 [#y5dd5d4e]
-[[ASP.NET Web Optimization>https://techinfoofmicrosofttech.osscons.jp/index.php?ASP.NET%20%E3%81%AE%20Modernization]]を行ったため、多数のコンポーネントをNuGet から追加した。

-また、[[Nuget使用時に「error MSB3086 Task could not find AL.exe」が発生>https://techinfoofmicrosofttech.osscons.jp/index.php?Nuget%E4%BD%BF%E7%94%A8%E6%99%82%E3%81%AB%E3%80%8Cerror%20MSB3086%20Task%20could%20not%20find%20AL.exe%E3%80%8D%E3%81%8C%E7%99%BA%E7%94%9F]]し、~
コレを解決するために、NuGet 2.7 以降の自動復元への移行を行った。

*NuGet登録 [#l902543f]
[[v02-x0>リリース情報#j62bae77]]から、[[NuGet登録>#l902543f]]を行い、更なるビルドシステムの改善を図る。

**対象 [#t3904a3d]
***Public名前空間 [#zff034a6]
-Public.dll
-その他、各種Dam*.dll
--NuGetにdllが''適切に''登録されているものに限る
---DamPstGrS
---DamMySQL
---DamManagedOdp

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

***Framework名前空間 [#v5069030]
-Framework.dll

**構成の変更 [#b311f203]
***本体（母体） [#a8abbd84]
Public名前空間、Framework名前空間にのみ適用される。

-実装 ---> テストの容易性を維持するために本体（母体）側の基本的なビルドシステムは現行を維持する。
-しかし、NuGetパッケージに登録するためのTarget Framework毎のビルドが可能になるようにする。
--[[Target Framework>https://docs.microsoft.com/ja-jp/nuget/schema/target-frameworks#supported-frameworks]]として、以下をサポートする。
---%%net35%% ( .NET Standard がサポートしている .NET Framework は 4.5 以上)
---%%net452%% ( VS2015テンプレートが、net46のため。)
---net46
---net47

--プロジェクト・ファイル（*.csproj）をTarget Framework毎に準備する。
---プロジェクト・ファイル（*.csproj）の名称付与基準は、「*{framework name}[{version}].csproj」とする。
---プロジェクト・ファイル（*.csproj）では、以下のようなビルド出力を行う（src側のフォルダ構成を参考にする）。~
以下は、[[*.nuspecファイル>https://techinfoofmicrosofttech.osscons.jp/index.php?NuGet%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E9%96%8B%E7%99%BA%E3%81%A8%E5%85%AC%E9%96%8B]]の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のバージョン
--ソリューション・ファイル（*.sln）を複数用意してmulti-version化する。

***テンプレート [#f6b03dfc]
Public名前空間、Framework名前空間が、Nuget化される。

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

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

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

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

-カスタマイズ可能レイヤ、テンプレート部分をメンテナンスする場合、
--最も古いVisual Studioのバージョンを使用したテンプレートでメンテナンスをする。
--そして、新しいVisual Studioのバージョンのテンプレート、本体（母体）にマージを行う。

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

|#|要素|内容|h
|1|id|OpenTouryo.Public, etc.|
|2|title|Open棟梁 Public namespace, etc.|
|3|version|・02-00 -> 2.0.0&br;・02-10 - > 2.1.0&br;・α・β -> [[こちら>https://techinfoofmicrosofttech.osscons.jp/index.php?NuGet%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E9%96%8B%E7%99%BA%E3%81%A8%E5%85%AC%E9%96%8B#r8c14f07]]|
|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ファイルを別途準備してリンク&br;https://jyn.jp/iconfile_how_to_create/#i-5|
|9|releaseNotes|https://github.com/OpenTouryoProject/OpenTouryo/releases|
|10|requireLicenseAcceptance|true (エンプラ風)|
|11|tags|OpenTouryo その他の依存関係パッケージのtitle（※ space 区切り）|
|12|description|詳細用 説明文|
|13|summary|一覧用 説明文|
|14|files - file|[[下記参照>#r0e62132]]|
|15|contentFiles - file|該当無し|
|16|frameworkAssemblies - frameworkAssembly|.NET Frameworkアセンブリへの参照だが、テンプレート・プロジェクト経由の利用なので必須ではない。|
|17|dependencies - dependency|NuGetパッケージへの参照だが、テンプレート・プロジェクト経由の利用なので必須ではない。|

***files [#r0e62132]

-ワイルドカードを使用して、Localized resource assembly（Localized satellite assembly）を同梱する。
-基本的に、プロジェクト出力の一式を同梱するようにする。

 <files>
   <file src="\bin\Release\net452\**" target="lib\net452" />
   <file src="\bin\Release\net46\**" target="lib\net46" />
   <file src="\bin\Release\net47\**" target="lib\net47" />
 </files>

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

*LicenseのSub Component表記の変更 [#re6a7d96]

**基本方針 [#m98a242e]
Sub ComponentはNuGet化されているので、~
NuGetの packages.configをリンクする。

ここで、利用者各位、ライセンスを確認する。

***Frameworksフォルダ以下のpackages.config [#nac6483b]
-https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Frameworks/Infrastructure/Public/packages.config
--https://github.com/OpenTouryoProject/OpenTouryo/tree/develop/root/programs/C%23/Frameworks/Infrastructure/Public/Db/DamOraOdp/packages.config
--https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Frameworks/Infrastructure/Public/Db/DamPstGrS/packages.config
--https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Frameworks/Infrastructure/Public/Db/DamMySQL/packages.config
--https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Frameworks/Infrastructure/Public/Db/DamSqlDbWithMultiShard/packages.config

-https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Frameworks/Infrastructure/Framework/packages.config
-https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Frameworks/Infrastructure/Business/packages.config
-https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Frameworks/Tools/DeployZipPackWithHTTP/packages.config

***Samplesフォルダ以下のpackages.config [#s239d856]
-https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Samples/WebApp_sample/ProjectX_sample/packages.config
-https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Samples/WebApp_sample/MVC_Sample/MVC_Sample/packages.config
-https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Samples/WebApp_sample/SPA_Sample/SPA_Sample/packages.config
-https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/programs/C%23/Samples/UWP_sample/UWP_Sample.Html/packages.config

**分かり易くする。 [#m7216c3e]
しかし、これだと解り難いので以下のように対応方法を選り分ける。

***Frameworksフォルダ以下 [#ka298482]
「/root/programs/C%23/Frameworks」以下のpackages.configは、
-Sub ComponentをDISTINCT（重複を削除）してComponent名を列挙する。
-前提（log4netなど）とオプション（ADO.NETデータプロバイダなど）に分ける。

***Samplesフォルダ以下 [#iff3b451]
「/root/programs/C%23/Frameworks/Samples」以下のpackages.configは、~
リンクするだけにする（特にASP.NET系のライブラリが色々と多すぎるので）。

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

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

*参考 [#maff7024]
**NuGetについて [#od5f2a1e]
***[[NuGet - マイクロソフト系技術情報 Wiki>https://techinfoofmicrosofttech.osscons.jp/index.php?NuGet]] [#z83884b2]

-[[NuGet を使用したパッケージ管理>https://techinfoofmicrosofttech.osscons.jp/index.php?NuGet%20%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%97%E3%81%9F%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E7%AE%A1%E7%90%86]]

-[[NuGetパッケージの開発と公開>https://techinfoofmicrosofttech.osscons.jp/index.php?NuGet%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E9%96%8B%E7%99%BA%E3%81%A8%E5%85%AC%E9%96%8B]]

-,etc.

**.NET Framework のバージョン [#ydd0f328]
-.NETバージョンアップ - マイクロソフト系技術情報 Wiki > .NET Framework のバージョン~
https://techinfoofmicrosofttech.osscons.jp/index.php?.NET%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E3%82%A2%E3%83%83%E3%83%97#kc9b3965

     

Site admin: OpenTouryo

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.014 sec.