本文主要介绍了使用DotNet CLI创建自定义的WPF项目模板,分享给大家,具体如下:

详解使用DotNet CLI创建自定义的WPF项目模板

描述

当我们安装完 DotNetCore 3.0 版本的 SDK 后,我们就可以创建基于 DotNetCore 的 WPF 项目模板,通过如下 CLI 可以方便快捷的创建并运行我们的项目:

dotnet new wpf -n WpfApp
cd WpfApp
dotnet restore
dotnet run

做过 WPF 开发的朋友都知道,这个项目模板肯定不符合我们的预期,我们希望我们的项目模板能够加入 MVVM 的默认代码段,并且能够和 DotNetCore 紧密合作,这样岂不是更加方便了吗? 所以本文使用 MVVM 的一种实现 MvvmLightStd10 来教大家如何创建一个我们理想的项目模板。

操作

首先,我们基于 DotNetCore 3.0 创建一个原始的 WPF 项目模板,然后引用如下库:

  1. Microsoft.Extensions.DependencyInjection
  2. MvvmLightLibsStd10

可通过执行 cli 命令进行安装

dotnet add package Microsoft.Extensions.DependencyInjection
dotnet add package MvvmLightLibsStd10

注:因为我们使用了 DotNetCore,所以我们尽量让我们安装的第三方包是基于 .NET Standard 方式来实现。

然后,尝试修改我们的这个项目,把它改成我们以后期望创建的项目模板的样子。可以参考我的如下修改:

项目结构如下图所示:

详解使用DotNet CLI创建自定义的WPF项目模板

其中,src\Models\DataItem.cs 的示例代码如下所示:

using System;
using System.Collections.Generic;
using System.Text;

namespace WpfApp.Models
{
  public class DataItem
  {
    public string Title { get; private set; }

    public DataItem(string title)
    {
      Title = title;
    }
  }
}

src\Models\IDataService.cs 的示例代码如下所示:

using System;
using System.Collections.Generic;
using System.Text;

namespace WpfApp.Models
{
  public interface IDataService
  {
    void GetData(Action<DataItem, Exception> callback);
  }
}

src\Models\DataService.cs 的示例代码如下所示:

using System;
using System.Collections.Generic;
using System.Text;

namespace WpfApp.Models
{
  public class DataService : IDataService
  {
    public void GetData(Action<DataItem, Exception> callback)
    {
      var item = new DataItem("Hello .NET Core!");
      callback(item, null);
    }
  }
}

src\ViewModels\MainViewModel.cs 的示例代码如下所示:

using GalaSoft.MvvmLight;
using WpfApp.Models;

namespace WpfApp.ViewModels
{
  public class MainViewModel : ViewModelBase
  {
    private readonly IDataService _dataService;

    private string _welcomeTitle;
    public string WelcomeTitle
    {
      get { return _welcomeTitle; }
      set { Set(ref _welcomeTitle, value); }
    }

    public MainViewModel(IDataService dataService)
    {
      _dataService = dataService;
       _dataService.GetData(
        (item, error) =>
        {
          if (error != null)
          {
            return;
          }

          WelcomeTitle = item.Title;
        });
    }
  }
}

src\Views\MainView.xaml 的示例代码如下所示:

<Window
  x:Class="WpfApp.Views.MainView"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:local="clr-namespace:WpfApp"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  Title="MainWindow"
  Width="800"
  Height="450"
  mc:Ignorable="d">
  <Grid>
    <Label
      HorizontalAlignment="Center"
      VerticalAlignment="Center"
      Content="{Binding WelcomeTitle}"
      FontSize="40" />
  </Grid>
</Window>

src\Views\MainView.xaml.cs 的示例代码如下所示:

using System.Windows;
using WpfApp.ViewModels;

namespace WpfApp.Views
{
  public partial class MainView : Window
  {
    public MainView(MainViewModel vm)
    {
      InitializeComponent();
      this.DataContext = vm;
    }
  }
}

src\App.xaml 的示例代码如下所示:

<Application
  x:Class="WpfApp.App"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:local="clr-namespace:WpfApp" />

src\App.xaml.cs 的示例代码如下所示:

using Microsoft.Extensions.DependencyInjection;
using System.Windows;
using WpfApp.Models;
using WpfApp.ViewModels;
using WpfApp.Views;

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

    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);

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

      ServiceProvider = serviceCollection.BuildServiceProvider();

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

    private void ConfigureServices(ServiceCollection services)
    {
      services.AddTransient<MainView>();
      services.AddTransient<MainViewModel>();

      services.AddScoped<IDataService, DataService>();
    }
  }
}

修改完毕后尝试编译运行我们的项目,确保可以正常编译运行。

之后,在我们的项目根目录 src 下新建一个 .template.config 文件夹,然后在里面新建一个 template.json 文件,进行如下示例配置:

{
  "$schema": "http://json.schemastore.org/template",
  "author": "hippiezhou <hippiezhou@outlook.com>",
  "classifications": ["wpf", "mvvmlight", "Dependency Injection"],
  "name": "wpf mvvmlight: use dotnetcore to create wpf with mvvmlight.",
  "tags": {
    "language": "C#",
    "type": "project"
  },
  "identity": "wpf.mvvmlight",
  "shortName": "wpf-mvvmlight",
  "sourceName": "wpf.mvvmlight",
  "preferNameDirectory": true
}

最后,打开我们的终端,将目录切换至当前项目目录下(就是 .template.config 所在的目录),然后执行下述安装操作

dotnet new -i C:\Users\hippieZhou\Desktop\helloworld\wpfapp

此时,我们的项目模板会被打包到 DotNetCore 的 CLI 中,如下图所示:

详解使用DotNet CLI创建自定义的WPF项目模板

同时,在 C:\Users\hippieZhou.templateengine\dotnetcli\v3.0.100-preview3-010431 目录下的以 templatecache.json 结尾的 JSON 文件内容也会发生修改,会在 TemplateInfo 结点下新增一个如下的节点内容:

 {
   "ConfigMountPointId": "f3861181-7a43-4fc5-ab1c-12d95e734c0a",
   "Author": "hippiezhou <hippiezhou@outlook.com>",
   "Classifications": [
    "wpf",
    "mvvmlight",
    "Dependency Injection"
   ],
   "DefaultName": null,
   "Description": "",
   "Identity": "wpf.mvvmlight",
   "GeneratorId": "0c434df7-e2cb-4dee-b216-d7c58c8eb4b3",
   "GroupIdentity": "",
   "Precedence": 0,
   "Name": "wpf mvvmlight: use dotnetcore to create wpf with mvvmlight.",
   "ShortNameList": [
    "wpf-mvvmlight"
   ],
   "Tags": {
    "language": {
     "Description": null,
     "ChoicesAndDescriptions": {
      "C#": ""
     },
     "DefaultValue": "C#"
    },
    "type": {
     "Description": null,
     "ChoicesAndDescriptions": {
      "project": ""
     },
     "DefaultValue": "project"
    }
   },
   "CacheParameters": {
    "name": {
     "DataType": "string",
     "DefaultValue": null,
     "Description": "The default name symbol"
    }
   },
   "ConfigPlace": "/.template.config/template.json",
   "LocaleConfigMountPointId": "00000000-0000-0000-0000-000000000000",
   "LocaleConfigPlace": null,
   "HostConfigMountPointId": "00000000-0000-0000-0000-000000000000",
   "HostConfigPlace": null,
   "ThirdPartyNotices": null,
   "BaselineInfo": {},
   "HasScriptRunningPostActions": false,
   "ConfigTimestampUtc": null
},

注:如果后期我们不慎将我们的模板删除了,我们通过删除掉这两个文件里面对应的模板节点就可以在 CLI 中取消应用了。

我们可以使用下述操作进行测试一下:

# 使用我们自定义的项目模板,创建 wpf 项目
dotnet new wpf-mvvmlight -n test

cd test

dotnet restore

dotnet run

如果不出意外的话,我们就可以看到这个项目的代码段和我们自定义的模板代码段是一样的。

如果卸载我们的项目模板可以使用如下命令:

dotnet new -u C:\Users\hippieZhou\Desktop\helloworld\wpfapp

注:我们需要确保我们的自定义模板不能丢失,要不然到时候就卸载就麻烦了(至少目前看来是这样的)。

关于如何将我们的自定义模板可以上传到 NuGet 供别人下载使用,这里就不做介绍了,具体操作可参考园里介绍如何在 DotNetCore MVC 中打造自己的项目模板方法是一样的。我在本文中的创建的代码模板也不会提交上去,还是等着 MVVMLight 的原作者 Laurent Bugnion 来操刀会好一些。

总结

本文介绍了如何通过 DotNet CLI 来创建自定义的 WPF 项目模板。在实际的使用过程中,CLI 的功能和支持的参数会更多,所以感兴趣的朋友可以自行研究。

相关参考

how-to-create-a-dot-net-new-project-template-in-dot-net-core

打造自己的.NET Core项目模板

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。

标签:
DotNet,CLI创建WPF项目模板,DotNet,CLI,WPF项目模板

免责声明:本站文章均来自网站采集或用户投稿,网站不提供任何软件下载或自行开发的软件! 如有用户或公司发现本站内容信息存在侵权行为,请邮件告知! 858582#qq.com
狼山资源网 Copyright www.pvsay.com

《魔兽世界》大逃杀!60人新游玩模式《强袭风暴》3月21日上线

暴雪近日发布了《魔兽世界》10.2.6 更新内容,新游玩模式《强袭风暴》即将于3月21 日在亚服上线,届时玩家将前往阿拉希高地展开一场 60 人大逃杀对战。

艾泽拉斯的冒险者已经征服了艾泽拉斯的大地及遥远的彼岸。他们在对抗世界上最致命的敌人时展现出过人的手腕,并且成功阻止终结宇宙等级的威胁。当他们在为即将于《魔兽世界》资料片《地心之战》中来袭的萨拉塔斯势力做战斗准备时,他们还需要在熟悉的阿拉希高地面对一个全新的敌人──那就是彼此。在《巨龙崛起》10.2.6 更新的《强袭风暴》中,玩家将会进入一个全新的海盗主题大逃杀式限时活动,其中包含极高的风险和史诗级的奖励。

《强袭风暴》不是普通的战场,作为一个独立于主游戏之外的活动,玩家可以用大逃杀的风格来体验《魔兽世界》,不分职业、不分装备(除了你在赛局中捡到的),光是技巧和战略的强弱之分就能决定出谁才是能坚持到最后的赢家。本次活动将会开放单人和双人模式,玩家在加入海盗主题的预赛大厅区域前,可以从强袭风暴角色画面新增好友。游玩游戏将可以累计名望轨迹,《巨龙崛起》和《魔兽世界:巫妖王之怒 经典版》的玩家都可以获得奖励。