DotNetCore 3.0 助力 WPF 開發


DotNetCore Is AnyWhere.

前言

Visual Studio 2019 已經正式發布了,DotNetCore 3.0 的正式版也指日可待。在之前的版本中,作為一名基於微軟生態的傳統 WPF 程序員看着隔壁同學在開發 DotNetCore 網站時用着各種特性好生羡慕,想着巨硬啥時候能讓客戶端開發者也能嘗嘗甜頭。

那么,現在是時候可以嘗試一下了。

需要說明的一點的是,DotNetCore 3.0 雖然跨平台,但是基於此的 WPF 卻是針對 Windows 特定平台的實現,並不能跨 Linux 和 MacOS 。

開發環境准備

要想開發 DotNetCore 版本的 WPF,首先需要確保我們的機器上已經安裝了如下

需要安裝的組件如下圖所示

直接默認安裝即可。

全新的開發體驗

在首次使用 VS2019 創建 DotNetCore 版本的 WPF 程序時,VS 可能會給你爆個如下圖所示的錯誤:

按照錯誤提示即可解決該問題,如下圖所示

接着選擇 TOOLS -> Options,配置如下圖所示

補充:VS2017 15.9.3 以上版本也是可以創建 DotNetCore 3.0 WPF 的項目模板,同樣需要先設置,設置方法和上面敘述的是一樣的。

在 16.1 版本之后的設置界面如下圖所示:

Hello World

首先,我們可以通過 VS 創建一個基於 DotNetCore 的 項目模板,然后我們看一下與傳統的 WPF 項目模板有什么區別。如下圖所示,創建一個 WPF 項目

創建完成后,嘗試編譯運行(注:第一次編譯可能需要較長時間),如下圖所示

如果我們仔細看一下這個新版的項目模板,會發現與傳統的項目模板相比,有好幾處發生了改變:

  • **.csproj 的組織方式發生了改變,與傳統的組織方式相比,內容精簡的快沒有了;
  • 項目默認會引用 Microsoft.NETCore.PlatformsMicrosoft.WindowsDesktop.App,這兩個 Package 都是針對 WinFormWPF 的特定包
  • 項目屬性中也有一些改動
  • 生成目錄中也有改動,會生成一些以 json 結尾的文件

上述這些改動都是最直觀的改動,但是這些改動貌似不痛不癢,並不能吸引傳統 WPF 開發者投入使用。接觸過 DotNetCore Web 方向的開發者已經對里面的 DI,HttpClientFactory,EFCore 等使用的爐火純青,那我們能不能在 WPF 中也使用這些東西呢?答案是必須要能啊,所有我們還需要探索一下它的一些硬核功能。下面列舉幾個我目前知道的幾個我覺得很炫酷的功能。

使用 DI 和 Service Provider

能夠使用 DIService Provider,這是我覺得最值得說一下的,因為它的使用方式簡直和在 DotNetCore Web 里面的一摸一樣,值得一說。

首先,我們創建一個 DotNetCore 版本的 WPF 項目,然后引用如下包:

  • Microsoft.Extensions.DependencyInjection
  • Microsoft.Extensions.Options.ConfigurationExtensions
  • Microsoft.Extensions.Configuration.FileExtensions
  • Microsoft.Extensions.Configuration.Json

注:上述包都需要安裝 預覽版本的 3.0.0 版本的才行

然后,在我們的項目根目錄下創建一個 appsettings.json 文件,文件內容如下所示:

{
  "AppSettings": {
    "StringSetting": "Value",
    "IntegerSetting": 42,
    "BooleanSetting": true
  }
}

然后將該文件的 Build Action 設置為 ContentCopy To Output Directiory 設置為 Copy if newer

接着,我們在項目根目錄下創建一個 AppSettings.cs 文件,用於隱射上面的 appsettings.json 文件,示例代碼如下所示:

public class AppSettings
{
    public string StringSetting { get; set; }

    public int IntegerSetting { get; set; }

    public bool BooleanSetting { get; set; }
}

然后,我們創建一個自定義的接口服務 ISampleService和對應實現 SampleService,示例代碼如下所示:

public interface ISampleService
{
    string GetCurrentDate();
}

public class SampleService : ISampleService
{
    public string GetCurrentDate() => DateTime.Now.ToLongDateString();
}

然后,修改我們的 App.xaml 文件,刪除掉默認添加的啟動視圖代碼 StartupUri="MainWindow.xaml"

接着,修改我們的 App.xaml.cs 文件,示例代碼如下所示:

public partial class App : Application
{
    public IServiceProvider ServiceProvider { get; private set; }

    public IConfiguration Configuration { get; private set; }

    protected override void OnStartup(StartupEventArgs e)
    {
        // 初始化配置建造器
        var builder = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);

        // 獲取配置建造器創建的對象
        Configuration = builder.Build();

        //配置全局服務容器
        var serviceCollection = new ServiceCollection();
        ConfigureServices(serviceCollection);

        ServiceProvider = serviceCollection.BuildServiceProvider();

        var mainWindow = ServiceProvider.GetRequiredService<MainWindow>();
        mainWindow.Show();
    }

    private void ConfigureServices(IServiceCollection services)
    {
        // 向全局容器中注冊一個視圖
        services.AddTransient(typeof(MainWindow));

        // 在全局容器中配置 AppSettings
        services.Configure<AppSettings>(Configuration.GetSection(nameof(AppSettings)));

        // 在全局容器中注冊自定義服務
        services.AddScoped<ISampleService, SampleService>();
    }
}

修改完畢后,我們可以嘗試編譯我們的項目,如果不出意外的啊,我們的程序會正常啟動起來。這里就不做截圖說明了。

看了上述代碼,是不是覺得很有意思啊,這種全新的開發模式頓時把我們的代碼水平提升了好幾個檔次。這種使用方式和在 AspDotNetCore 簡直一摸一樣。比如,我們在上面注冊了 AppSettings 和一個基於 ISampleService 接口的實現 SampleService,那么我們就可以在 MainWindow 的構造函數中使用,比如,我們可以參考下面的示例代碼:

    public partial class MainWindow : Window
    {
        private readonly ISampleService _sampleService;
        private readonly IOptions<AppSettings> _settings;
        public MainWindow(ISampleService sampleService, IOptions<AppSettings> settings)
        {
            InitializeComponent();

            _sampleService = sampleService;
            var val = _sampleService.GetCurrentDate();

            _settings = settings;
        }

        private void ButtonExit_Click(object sender, RoutedEventArgs e)
        {
            Application.Current.Shutdown();
        }
    }

然后,我們可以監視一下 _settings 的值,如下圖所示:

通過這個簡單的例子,我們可以看到這種全新方式的依賴注入已經得到微軟的大力支持,將基於 .NetCoreCS模式BS模式 開發方式進行了統一,學習曲線是不是又下降了很多啊。

使用 HttpClientFactory

眾所周知,HttpClient 在實際的使用場景中還是存在一些弊端,在 DotNetCore 的 Web 端中,很多同學用了 HttpClientFactory 如魚得水,減少了很多不必要的麻煩。現在,我們同樣可以將這一利器在 WPF 中使用。

我們新建一個基於 DotNetCore 3.0 的 WPF 項目,然后引入如下包:

  • Microsoft.Extensions.DependencyInjection
  • Microsoft.Extensions.Http

然后,修改我們的 App.xaml 文件,刪除掉默認添加的啟動視圖代碼 StartupUri="MainWindow.xaml",並修改 App.xaml.cs 文件,示例代碼如下所示:

public partial class App : Application
{
    public ServiceProvider ServiceProvider { get; private set; }

    protected override void OnStartup(StartupEventArgs e)
    {
        var serviceCollection = new ServiceCollection();
        ConfigureServices(serviceCollection);

        ServiceProvider = serviceCollection.BuildServiceProvider();

        var mainView = ServiceProvider.GetRequiredService<MainWindow>();
        mainView.Show();

        base.OnStartup(e);
    }

    private void ConfigureServices(ServiceCollection services)
    {
        services.AddHttpClient();
        services.AddTransient(typeof(MainWindow));
    }
}

最后,修改我們的 MainWindow.xaml.cs 文件,示例代碼如下所示:

public partial class MainWindow : Window
{
    private readonly IHttpClientFactory _httpClientFactory;
    public MainWindow(IHttpClientFactory httpClientFactory)
    {
        InitializeComponent();

        _httpClientFactory = httpClientFactory;
    }

    private async void ButtonExit_Click(object sender, RoutedEventArgs e)
    {
        var client = _httpClientFactory.CreateClient();
        var html = await client.GetStringAsync("http://www.baidu.com");
        //Application.Current.Shutdown();
    }
}

這就是關於 HttpClientFactory 的簡單使用。

使用 EFCore

最后介紹的一大利器就是巨硬的 EFCore,這個東西也很溜,值得我們嘗試使用。這里我使用 Sqlite 為例。

我們新建一個基於 DotNetCore 3.0 的 WPF 項目,然后引入如下包:

  • Microsoft.Extensions.DependencyInjection
  • Microsoft.Extensions.Configuration.FileExtensions
  • Microsoft.Extensions.Configuration.Json
  • Microsoft.EntityFrameworkCore.Sqlite

首先,我們參考上面提到的使用方式,在項目根目錄下創建一個 appsettings.json,文件,修改內容如下所示:

{
  "ConnectionStrings": {
    "SqlConnection": "datasource = default.sqlite"
  }
}

然后將該文件的 Build Action 設置為 ContentCopy To Output Directiory 設置為 Copy if newer

接着,我們創建一個 DataContext 類,示例代碼如下所示:

public class DataContext : DbContext
{
    public DataContext(DbContextOptions options) : base(options)
    {
        this.Database.Migrate();
    }
}

然后刪除掉 App.xaml 中的 StartupUri="MainWindow.xaml",並修改 App.xaml.cs,示例代碼如下所示:

public partial class App : Application
{
    public ServiceProvider ServiceProvider { get; private set; }
    public IConfigurationRoot Configuration { get; private set; }

    protected override void OnStartup(StartupEventArgs e)
    {
        var builder = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);

        Configuration = builder.Build();

        var serviceCollection = new ServiceCollection();
        ConfigurationServices(serviceCollection);

        ServiceProvider = serviceCollection.BuildServiceProvider();
        var mainView =  ServiceProvider.GetRequiredService<MainWindow>();
        mainView.Show();

        base.OnStartup(e);
    }

    private void ConfigurationServices(ServiceCollection services)
    {
        services.AddTransient(typeof(MainWindow));

        services.AddDbContext<DataContext>(options=>options.UseSqlite(Configuration.GetConnectionString("SqlConnection")));
    }
}

然后我們修改 MainWindow.xaml.cs,示例代碼如下所示:

public partial class MainWindow : Window
{
    private readonly DataContext _dataContext;

    public MainWindow(DataContext  dataContext)
    {
        InitializeComponent();

        _dataContext = dataContext;
    }

    private void ButtonExit_Click(object sender, RoutedEventArgs e)
    {
        Application.Current.Shutdown();
    }
}

使用方法依然很簡單。

支持 UWP 相關控件 和 Windows10 API

傳統的 WPF 客戶端,如果使用基於 UWP 的相關控件,則可以通過使用 WindowsCommunityToolkit 控件庫來使用 UWP 的相關控件,該控件庫目前可能還不是很完善,但是微軟已經在不斷添加新功能了。

UWP 是未來發展的趨勢,但是對於傳統的 WPF,如果想像 UWP 那樣也能使用功能更加強大的 API,只需要通過簡單添加一些引用就可以實現。微軟之前有發布過具體使用的文章,文末有給出鏈接。

發布方式

基於 DotNetCore 3.0 的 WPF 項目發布方式還是和傳統的 WPF 項目發布方式有所差異。全新的發布方式是基於 DotNetCore 的風格來進行設計的。在 Publish 的選項卡中,我們可以看到如下配置

我們可以依據具體情況,來選擇合適的發布方式進行發布。當然,我們也可以借助 Desktop App Converter 工具,將我們的應用分發到 Windows Store 上。

總結

通過上述幾個簡單的示例,我們可以看到傳統的 WPF 已經被微軟注入了新鮮的血液,並且在微軟生態下的 C/S端B/S端 開發模式漸趨相同。大大減輕了學習曲線。能夠讓技術在最短的時間里變現,這也是我最看重的地方。

無論是過去還是現在,我都時不時地聽身邊的人說不應該過度依賴工具,但是我想說的是 技術服務於現實,而工具只是為了加速變現,如果一項技術再好再優秀,它卻不能創造現實價值,服務生活,那么我寧願放棄使用它。微軟為開發者提供了 DotNetCore 的好技術,而 VisualStudio 系列工具作為生產力工具,只是為了提高生產效率。在效率為王的今天,誰贏得了時間,就贏得了一切。

最后,我不打算吹捧 DotNetCoreWPFVisualStudio,以免有人說我會誤導萌新。還是那句話,實踐出真知,感興趣的話可以自己動手嘗試一下。此外,目前 DotNetCore 3.0 還是處於預覽階段,所以可能會有一些坑。但是誰能保證自己第一次就能把事情做的完美呢?時間會證明一切。

補充

評論中很多朋友問到跨平台的問題,所以我補充了一張圖。


相關參考


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM