Windows Desktop Packsへの移行

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

• 戻る
  • .NETのクロスプラットフォーム対応
    • .NET Coreへの移行

目次 †

概要 †

.NET Core 3.0から、Windows Forms / WPFのサポートが追加された。

詳細 †

基本的にポーティング移行になるもよう（VS2019ではデザイナ使用不可）。

移行手順の概要 †

.NET Framework版プロジェクト †

• ...の準備（既存）
• ...の移行性評価

.NET Core版のプロジェクト †

• ...の準備（新規）
  • ...の生成
  • ...の設定
  • ...から、.NET Framework版プロジェクトのソース・ファイルをリンクする。

• ...のコンパイルを通す。
  • ...へ、NuGetパッケージを追加
  • ...へ、必要に応じて互換機能パックを追加
  • ...その他、非互換のAPIなどの置換などを行う。

• ...のビルドと実行とテストの実施

支援ツール †

デザイナ †

• VS2019では、
  • .NET Coreのデザイナは提供されない。
  • .NET Frameworkのデザイナを使用する。

アナライザー †

互換機能パック †

概要 †

• Windows 専用 API やプラットフォーム非依存 API など、約 20,000 の API を提供
• NuGet パッケージ Microsoft.Windows.Compatibility 経由で提供される。
• .NET Core または .NET Standard を対象とするプロジェクトから参照できる。

領域 †

• .NET Framework
  • CodeDom?
  • System.Runtime.Caching
  • Windows Workflow Foundation (WF)
  • Windows Communication Foundation (WCF)
  • Managed Extensibility Framework (MEF)
  • 互換性（Microsoft.Windows.Compatibility.Shims）

• Windows
  • Codepage
  • GDI+
  • ODBC
  • Registry
  • Service
  • 暗号化
  • EventLog?
  • アクセス制御リスト (ACL)
  • パフォーマンス カウンター
  • WMI (Windows Management Instrumentation)
  • Active Directory(X.500)

事例 †

Open棟梁Projectでの事例

• Support to Windows Forms/WPF
  by “Windows Desktop Packs” on NET Core 3.0.
  · Issue #328 · OpenTouryoProject?/OpenTouryo?
  https://github.com/OpenTouryoProject/OpenTouryo/issues/328

手順 †

プロジェクト・ファイルの雛形の取得 †

新規作成 → プロジェクトで取得できる。

• Windows Formsの場合
  ...のプロジェクト・ファイルの雛形

  <Project Sdk="Microsoft.NET.Sdk.WindowsDesktop">
  
    <PropertyGroup>
      <OutputType>WinExe</OutputType>
      <TargetFramework>netcoreapp3.0</TargetFramework>
      <UseWindowsForms>true</UseWindowsForms>
      <ApplicationIcon />
      <StartupObject />
    </PropertyGroup>
  
  </Project>

• WPFの場合
  ...のプロジェクト・ファイルの雛形

  <Project Sdk="Microsoft.NET.Sdk.WindowsDesktop">
  
    <PropertyGroup>
      <OutputType>WinExe</OutputType>
      <TargetFramework>netcoreapp3.0</TargetFramework>
      <UseWPF>true</UseWPF>
    </PropertyGroup>
  
  </Project>

ファイルのリンク †

• 上記のプロジェクト・ファイルにファイルをリンクする。

• .NET Frameworkのプロジェクト・ファイルと同じフォルダ階層に、
  .NET Coreのプロジェクト・ファイルを配置してしまっても行ける。

ポーティング移行 †

以下のポイントに注意しながらポーティング移行を行う。

ポイント †

共通 †

• AssemblyInfo?.csは除外（削除）する。

• プロジェクト・ファイルを修正する。
  • ルート名前空間
  • アセンブリ名
  • プロジェクト出力
  • 参照設定やNuGet参照

• ファイル
  • ビルド アクションの設定
  • Resourceファイルの再構成

• NuGet周り
  • 参照アセンブリ（DLL）吸わなくなったので、個別にNuGet参照。
  • 必要に応じて、NuGetパッケージの依存関係の設定を適正化する。

• #IF用にNETCOREAPPを追加
  • 既定で、NETCOREAPP_3_0があるのでこちらを利用してもイイ。
  • 必要に応じて、#IF - #ELSEの条件付きコンパイルディレクティブを実装する。

ライブラリの場合 †

• OutputType?をWinExe?からLibraryへ変更する。

  <OutputType>Library</OutputType>

• Windows Forms / WPFのサポートの両方に対応する場合、以下を併記

  <UseWindowsForms>true</UseWindowsForms>
  <UseWPF>true</UseWPF>

• Sgen.exe（XmlSerializer?専用コンパイラ）の問題で、
  GenerateSerializationAssemblies? : Off を追記した。

  <GenerateSerializationAssemblies>Off</GenerateSerializationAssemblies>

画面の場合 †

設定ファイル

• app.configを除外（削除）し、appsettings.jsonを追加。
• Microsoft.Extensions.Configuration.XXX周辺の参照を追加
• 冒頭で、appsettings.jsonの初期化コードを実行

サポート対象外 †

ClickOnce †

• .NET Coreでのサポートは予定されていない模様。
• → .NET 5でサポートされる模様。

• 参考
  • Will ClickOnce be ported to .NET Core 3 as well as WinForms? - Stack Overflow
    https://stackoverflow.com/questions/56390876/will-clickonce-be-ported-to-net-core-3-as-well-as-winforms
  • 「ClickOnce」インストールが「.NET Core」に対応 ～「.NET 5.0」リリース候補2版 - 窓の杜
    https://forest.watch.impress.co.jp/docs/news/1283252.html

VB版 †

現状では、VB版テンプレートが存在しない。

参考 †

• MicrosoftがWPF、WinForms?、WinUIをオープンソース化
  https://www.infoq.com/jp/news/2018/12/msft-open-source-wpf-winforms

• .NET Core 3 で Windows デスクトップアプリケーションをサポートするみたい
  (.NET Core 3 and Support for Windows Desktop Applications) - いろいろ備忘録日記
  https://devlights.hatenablog.com/entry/2018/05/08/120953

• Windows Compatibility Pack for .NET Core：Dev Basics／Keyword - ＠IT
  https://www.atmarkit.co.jp/ait/articles/1711/21/news024.html

.NET Blog †

• .NET Core 3 and Support for Windows Desktop Applications
  https://devblogs.microsoft.com/dotnet/net-core-3-and-support-for-windows-desktop-applications/
• Announcing .NET Core 3 Preview 1 and Open Sourcing Windows Desktop Frameworks
  https://devblogs.microsoft.com/dotnet/announcing-net-core-3-preview-1-and-open-sourcing-windows-desktop-frameworks/

やってみた系 †

• WPF on .NET Coreをやってみる（プレビュー版） - Qiita
  https://qiita.com/soi/items/e1cf2abf9845164bf439

• .NET Core 3.0 でのデスクトップ開発 - かずきのBlog@hatena
  https://blog.okazuki.jp/entry/2018/12/05/160649

• .NET Core3.0でWindows Forms/WPFが
  サポートされたので早速試してみた - あるSEのつぶやき・改
  https://www.aruse.net/entry/2018/12/05/100935

• Visual Studio 2019で始める「WPF on .NET Core 3.0」開発
  というタイトルで登壇してきました - nuits.jp blog
  http://www.nuits.jp/entry/wpf-on-dot-net-core-3_0
  • https://www.slideshare.net/AtsushiNakamura4/visual-studio-2019wpf-on-net-core-30

しばやん雑記 †

• 既存の WPF アプリケーションを .NET Core 3.0 に移行した
  https://blog.shibayan.jp/entry/20190302/1551518606

• .NET Core 3.0 Preview 7 で Go Live が付いたので
  WPF アプリケーションを更に対応させた
  https://blog.shibayan.jp/entry/20190725/1564045069

• .NET Core 3.0 で WinForms? / WPFを
  使う場合は実行ファイルのパスに注意
  https://blog.shibayan.jp/entry/20190909/1568007641

rksoftware †

• .NET Core 3.0 でデスクトップアプリを作る (目次)
  https://rksoftware.hatenablog.com/entry/2019/01/10/203234
  • .NET Core 3.0 でデスクトップアプリを作る（VS プレビュー版を使わない）
  • .NET Core 3.0 プロジェクトの発行でエラーになる

• .NET Core 3.0 デスクトップアプリプロジェクトが
  • Visual Studio 2019 で開けない
  • ビルドできない

• デザイナがなくても問題なし
  • .NET Core 3.0 で Windows フォームアプリケーションを作る
  • Windows フォーム手書き時の注意 AutoScaleDimensions? 設定

• 帳票出力
  • .NET Core デスクトップアプリケーションから DioDocs? を使って帳票を PDF 出力する
  • .NET Core デスクトップアプリケーションで PDF 帳票を画面表示する
  • .NET Core デスクトップアプリケーションで DioDocs? で作った PDF 帳票を印刷する

Microsoft Docs †

移植 †

• Windows Forms アプリを .NET Core 3.0 に移植する
  https://docs.microsoft.com/ja-jp/dotnet/core/porting/winforms
• WPF アプリを .NET Core 3.0 に移植する
  https://docs.microsoft.com/ja-jp/dotnet/core/porting/wpf

互換機能パック †

• Windows 互換機能パックを使用してコードを .NET Core に移植する - .NET Core
  https://docs.microsoft.com/ja-jp/dotnet/core/porting/windows-compat-pack

• designs/compat-pack.md at master · dotnet/designs
  https://docs.microsoft.com/ja-jp/dotnet/core/porting/windows-compat-pack

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