.NET Standardへの移行 のバックアップ(No.15)

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

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• .NET Standardへの移行 へ行く。
  • 1 (2018-03-28 (水) 15:45:31)
  • 2 (2018-03-28 (水) 18:31:11)
  • 3 (2018-03-29 (木) 11:57:15)
  • 4 (2018-03-29 (木) 14:37:24)
  • 5 (2018-03-29 (木) 16:59:22)
  • 6 (2018-03-30 (金) 10:34:44)
  • 7 (2018-03-30 (金) 15:54:30)
  • 8 (2018-03-30 (金) 21:29:52)
  • 9 (2018-04-02 (月) 11:59:06)
  • 10 (2018-04-02 (月) 21:29:55)
  • 11 (2018-04-03 (火) 12:31:43)
  • 12 (2018-04-04 (水) 12:00:34)
  • 13 (2018-04-05 (木) 11:37:57)
  • 14 (2018-04-05 (木) 20:20:53)
  • 15 (2018-04-06 (金) 10:20:10)
  • 16 (2018-04-09 (月) 11:58:52)
  • 17 (2018-04-10 (火) 09:39:59)
  • 18 (2018-04-17 (火) 13:04:22)
  • 19 (2018-04-19 (木) 18:33:48)
  • 20 (2018-04-19 (木) 18:52:26)
  • 21 (2018-04-20 (金) 10:38:58)
  • 22 (2018-04-23 (月) 14:14:31)
  • 23 (2018-04-24 (火) 09:12:22)
  • 24 (2018-04-24 (火) 17:53:35)
  • 25 (2019-02-19 (火) 11:34:58)
  • 26 (2019-08-07 (水) 18:47:52)
  • 27 (2019-08-22 (木) 12:49:18)
  • 28 (2019-08-23 (金) 11:02:02)
  • 29 (2019-08-26 (月) 17:26:16)

---

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

• 戻る
  • .NET Standard
  • 移行・マイグレーション
    • .NETのクロスプラットフォーム対応

目次 †

概要 †

※ 対象は、.NET Standard 2.0。

• 下記の「移行元 / 移行先」の、「.NET Standard」移行ノウハウをサマリする。
  
• コチラに書いた通り、PCLと比べて移行はし易い感じ。

詳細 †

準備 †

移行プロセスの確認 †

移行性評価の実施 †

必要に応じて、以下ツールを使用し移行性を評価する。

• .NET Portability Analyzer
  • .NET Portability Analyzer - .NET | Microsoft Docs
    https://docs.microsoft.com/ja-jp/dotnet/standard/analyzers/portability-analyzer
  • Portability Analyzerを使ってライブラリの.NET Standard準拠を調べよう - ryuichi111stdの技術日記
    http://ryuichi111std.hatenablog.com/entry/2017/03/07/142248

• .NET Compatibility Diagnostic Tools
  • NuGet Gallery | Microsoft.DotNet?.FrameworkCompatibilityDiagnostics? 0.5.0
    https://www.nuget.org/packages/Microsoft.DotNet.FrameworkCompatibilityDiagnostics/
  • .NET Framework の互換性の診断 – Visual Studio 日本チーム Blog
    https://blogs.msdn.microsoft.com/visualstudio_jpn/2016/03/02/net-framework/
  • .NET API アナライザー | Microsoft Docs
    https://docs.microsoft.com/ja-jp/dotnet/standard/analyzers/api-analyzer
  • .NET Coreへの移植 | ++C++; // 未確認飛行 C ブログ
    http://ufcpp.net/blog/2016/2/porting-to-net-core/

移行先プロジェクトを準備する。 †

不要なファイルを削除する。

• packages.config
• Properties\AssemblyInfo?.cs

Projectファイルを準備する。 †

• 以下のようなProjectファイルを準備する。
  （既存のProjectファイルの中身を以下で置き換えればイイ）

  <Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
      <TargetFramework>netstandard2.0</TargetFramework>
    </PropertyGroup>
  </Project>

• .NET Standardでは、配下のSourceファイルが自動で追加される。
  必要に応じて、ファイルやフォルダの除外設定を行う。
  ※ netstandardやnetcoreでは、除外されるファイルやフォルダだけがProjectファイルに明記される。

ProjectをVisual Studioから開く。 †

Projectファイルをダブルクリックするか、空のソリューションに追加する。

Projectの初期設定を行う。 †

<PropertyGroup>
  <TargetFramework>netstandard2.0</TargetFramework>
  <AssemblyName>XXXX</AssemblyName>
  <RootNamespace>YYYY</RootNamespace>
</PropertyGroup>

ポーティング移行 †

移行対象ファイルを選別する。 †

コンパイル・エラーをチェックしながら移行対象ファイルを選別する。

必要に応じて、NuGetパッケージを追加する。 †

• 「参照無し」が発生したら、NuGetパッケージを確認しインストール。
  NuGetパッケージにnetstandardが含まれるかどうかを確認する。
  （パッケージを解凍して、中を直接確認してもイイ）

• 以下のライブラリの移行先をNuGetパッケージから探す。
  • System系ライブラリ
    • System.Configuration.ConfigurationManager

• System.Data系ライブラリ
  ADO.NETデータプロバイダ
  • System.Data.SqlClient?
  • System.Data.Odbc
  • Npgsql
  • MySql?.Data

• ASP.NET Core系ライブラリ
  ※ ココが比較的、大変。

• その他ライブラリ
  • log4net
  • Json.NET

• 参考
  • .NET Core に移植する - Windows 互換機能パックの使用
    https://docs.microsoft.com/ja-jp/dotnet/core/porting/windows-compat-pack

必要に応じて、ポーティング移行する。 †

• 依存していた処理を削除するかポーティング移行する。

• Windows
• net11 - net47 - netXX
• Microsoft.VisualBasic?
• 上記以外のNuGetパッケージ

パッケージ・マネージャ †

NuGet †

引き続き使用できる。 †

• .NET Standard、.NET Coreでも、引き続きNuGetを使用できる。
• １つのNuGetパッケージには、.NET Framework以外に、
  .NET Standard、.NET Coreのライブラリを同梱してパッケージ化できる。

Dependencies †

.NET Standard、.NET Core開発に活用できるNuGetライブラリは、
.NET Standard、.NET Core 側にだけ、Dependencies を持つ。

※ しかし、実際には、Dependenciesが正確に書かれていないケースも多く、
　（「target="lib\netXXX」毎にDependenciesが異なるので当然と言えば当然）
　実際にインストールして.NET Standardに対応しているかどうかを判断する。

System系ライブラリ †

*.config †

System.Configuration.ConfigurationManager? †

• NuGetパッケージがあるが使えない（詳細不明）。
• なので、現時点では、Microsoft.Extensions.Configurationを使用する。

Microsoft.Extensions.Configuration †

以下の情報を元にマイグレーションする必要がある。

• 参考
  • microsoft.com
    • ASP.NET Core の構成 | Microsoft Docs
      https://docs.microsoft.com/ja-jp/aspnet/core/fundamentals/configuration/index
    • Essential .NET - .NET Core における構成
      https://msdn.microsoft.com/ja-jp/magazine/mt632279.aspx
  • stackoverflow.com
    • ASP.NET Core configuration for .NET Core console application - Stack Overflow
      https://stackoverflow.com/questions/38114761/asp-net-core-configuration-for-net-core-console-application
    • c# - How to SetBasePath? in ConfigurationBuilder? in Core 2.0 - Stack Overflow
      https://stackoverflow.com/questions/46843367/how-to-setbasepath-in-configurationbuilder-in-core-2-0

ASP.NET Core系ライブラリ †

• 対応するライブラリが「Microsoft.AspNetCore?.XXXX」にある可能性がある。
• これらのライブラリはASP.NET Coreではなく、.NET Standard前提になる。
  https://www.nuget.org/packages/Microsoft.AspNetCore.All

System.Web †

対応するライブラリが「Microsoft.AspNetCore?.XXXX」にある可能性がある。

HttpContext? †

• c# - How to get HttpContext?.Current in ASP.NET Core? - Stack Overflow
  https://stackoverflow.com/questions/38571032/how-to-get-httpcontext-current-in-asp-net-core
• Accessing HttpContext? outside of framework components in ASP.NET Core | StrathWeb?. A free flowing web tech monologue.
  https://www.strathweb.com/2016/12/accessing-httpcontext-outside-of-framework-components-in-asp-net-core/

※ 上記の「Mimicking HttpContext?.Current」で.NET Standardなライブラリ化も可能。

Session †

文字列しか格納できなくなったので、複雑なオブジェクトはJSONに変換する。

• Using Sessions and HttpContext? in ASP.NET 5 and MVC6
  https://benjii.me/2015/07/using-sessions-and-httpcontext-in-aspnet5-and-mvc6/
• ASP.NET Core MVCでSession管理 - 今日もちょいつか
  http://heinlein.hatenablog.com/entry/2017/11/21/141639

Cookie †

• ASP.NET Core Working With Cookie
  https://www.c-sharpcorner.com/article/asp-net-core-working-with-cookie/
• ASP.NET Core 2.0 MVC で Cookie を利用する - Qiita
  https://qiita.com/code0327/items/26c09c83103083ae57b7

RootPath? †

• HttpContext?.Current.Request.ApplicationPath?
• ・・・

• 参考
  • asp.net core - Access IApplicationEnvironment?.ApplicationBasePath? - Stack Overflow
    https://stackoverflow.com/questions/37298402/access-iapplicationenvironment-applicationbasepath

Microsoft.Owin †

対応するライブラリが「Microsoft.AspNetCore?.XXXX」にある可能性がある。

Base64Url †

• Microsoft.AspNetCore.WebUtilities

その他ライブラリ †

log4net †

• 一部、インターフェイスの変更があるもよう。
• 引数にRepositoryが必要になったようだが、
  Microsoft.Extensions.Logging.ILoggerProvider?の規則などには関係が無い模様。

• 参考
  • How to use Log4Net with ASP.NET Core for logging | dotnetthoughts
    https://dotnetthoughts.net/how-to-use-log4net-with-aspnetcore-for-logging/
  • Essential .NET - .NET Core によるログ記録
    https://msdn.microsoft.com/ja-jp/magazine/mt694089.aspx

参考 †

.NET Standardは、.NET Coreのサブセットなので、≒.NET Core。
なので、以下のリンクは、.NET Coreへの移行の情報を含む。

移行情報 †

• .NET Core 2.1のロードマップが公開されたようです - つばろぐ
  http://tsubalog.hatenablog.com/entry/net-core-2-1-roadmap

.NET Coreへの移行 †

ASP.NET Coreへの移行 †

Microsoft Docs †

• .NET Framework から .NET Core への移植
  https://docs.microsoft.com/ja-jp/dotnet/core/porting/
  • プロジェクトを整理し、.NET Framework と .NET Core をサポートする
    https://docs.microsoft.com/ja-jp/dotnet/core/porting/project-structure
  • .NET Core への移植 - サードパーティの依存関係を分析する
    https://docs.microsoft.com/ja-jp/dotnet/core/porting/third-party-deps
  • .NET Core への移植 - ライブラリ
    https://docs.microsoft.com/ja-jp/dotnet/core/porting/libraries
  • .NET Core に移植する - Windows 互換機能パックの使用
    https://docs.microsoft.com/ja-jp/dotnet/core/porting/windows-compat-pack

MSDN magazine > Essential .NET †

• .NET Core における構成
  https://msdn.microsoft.com/ja-jp/magazine/mt632279.aspx
• .NET Core によるログ記録
  https://msdn.microsoft.com/ja-jp/magazine/mt694089.aspx
• .NET Core による依存関係の挿入
  https://msdn.microsoft.com/ja-jp/magazine/mt707534.aspx
• Visual Studio 2015 と .NET Core ツール
  https://msdn.microsoft.com/magazine/mt736459
• .NET Core 1.0 によるコマンドライン処理
  https://msdn.microsoft.com/magazine/mt763239

.NET API Browser †

https://docs.microsoft.com/en-us/dotnet/api/index

.NET Standard API Reference †

https://docs.microsoft.com/en-us/dotnet/api/index?view=netstandard-2.0

---

Tags: :.NET開発, :.NET Core, :.NET Standard, :移行

     

Site admin: dotNetDevelopmentInfrastructure

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