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

我来为你详细讲解使用DotNet CLI创建自定义的WPF项目模板的完整攻略。以下是具体步骤：

步骤一：创建WPF项目

首先，我们需要创建一个WPF项目。可以在Visual Studio中创建或者使用以下命令在终端中创建：

dotnet new wpf -n <项目名称>

这样我们就创建了一个名为<项目名称>的WPF项目。

步骤二：创建模板

接下来，我们需要在项目目录下创建模板。在终端中执行以下命令：

dotnet new template --type item --name <模板名称>

其中，--type item表示创建一个项目模板，--name <模板名称>表示为模板指定一个名称。执行成功后，会在项目目录下创建一个名为.template.config的文件夹，并在其中创建一个template.json文件。

步骤三：编辑模板文件

编辑template.json文件，该文件定义了模板的属性：

{
  "$schema": "http://json.schemastore.org/template",
  "author": "你的名字",
  "classifications": [ "WPF" ],
  "identity": "模板名称",
  "name": "模板名称",
  "shortName": "模板名称",
  "tags": {
    "language": "C#",
    "type": "item",
    "platform": "WPF"
  },
  "sourceName": "Class1.cs",
  "sources": [
    {
      "modifiers": [],
      "source": "Class1.cs",
      "target": "{{name}}.cs"
    }
  ]
}

需要说明的是，"classifications": [ "WPF" ]和"tags": {"platform": "WPF"}表示模板属于WPF类型，可以根据需要修改。

步骤四：添加模板内容

在template.json文件中的"sources"数组中，添加你想要作为模板的内容。例如，我们添加一个MainWindow.xaml.cs文件作为模板：

{
  "sources": [
    {
      "modifiers": [],
      "source": "MainWindow.xaml.cs",
      "target": "{{name}}.xaml.cs"
    }
  ]
}

在项目目录下创建一个MainWindow.xaml.cs文件，添加一些初始内容。我们也可以添加其他文件作为模板内容。

步骤五：打包模板

在项目目录下执行以下命令，将模板打包成nupkg文件：

dotnet pack <项目名称> -o <输出目录>

其中，-o表示指定输出目录，可以用绝对路径或者相对路径。打包成功后，会在输出目录下生成一个nupkg文件。

步骤六：安装模板

在终端中执行以下命令，安装模板：

dotnet new -i <nupkg文件路径>

其中，<nupkg文件路径>为上一步打包得到的nupkg文件路径。

至此，我们已经将自定义模板安装成功，可以使用以下命令创建新项目：

dotnet new <模板名称> -n <新项目名称>

例如，使用刚刚创建的MyWPFProject模板，创建一个名为MyNewWPFProject的新项目，可以使用以下命令：

dotnet new MyWPFProject -n MyNewWPFProject

这样就创建了一个名为MyNewWPFProject的项目，并且已经包含了我们添加的模板文件。

下面是两个示例说明：

示例一：添加自定义控件

假设我们要添加一个自定义控件，叫做MyCustomControl，我们可以使用以下命令在项目目录下创建MyCustomControl.xaml文件：

touch MyCustomControl.xaml

然后，在MyCustomControl.xaml文件中添加以下内容：

<UserControl x:Class="MyNewWPFProject.MyCustomControl"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    mc:Ignorable="d" 
    d:DesignHeight="450" d:DesignWidth="800">
    <Grid>
        <TextBlock Text="Hello, MyCustomControl!" />
    </Grid>
</UserControl>

接着，在模板文件template.json中添加以下内容：

{
  "sources": [
    {
      "modifiers": [ "globaljson" ],
      "source": "global.json",
      "target": "global.json"
    },
    {
      "modifiers": [ "globalasax" ],
      "source": "Global.asax",
      "target": "Global.asax"
    },
    {
      "modifiers": [ "app" ],
      "source": "App.xaml",
      "target": "App.xaml"
    },
    {
      "modifiers": [],
      "source": "MainWindow.xaml",
      "target": "{{name}}.xaml"
    },
    {
      "modifiers": [],
      "source": "MainWindow.xaml.cs",
      "target": "{{name}}.xaml.cs"
    },
    {
      "modifiers": [],
      "source": "MyCustomControl.xaml",
      "target": "MyCustomControl.xaml"
    }
  ]
}

修改完成后，重新打包模板，安装后即可在新项目中看到MyCustomControl.xaml文件。

示例二：添加自定义NuGet包引用

假设我们需要添加一个自定义NuGet包引用，我们可以使用以下命令在项目目录下添加NuGet包引用：

dotnet add package MyCustomPackage

然后，在模板文件template.json中添加以下内容：

{
  "sources": [
    {
      "modifiers": [ "globaljson" ],
      "source": "global.json",
      "target": "global.json"
    },
    {
      "modifiers": [ "globalasax" ],
      "source": "Global.asax",
      "target": "Global.asax"
    },
    {
      "modifiers": [ "app" ],
      "source": "App.xaml",
      "target": "App.xaml"
    },
    {
      "modifiers": [],
      "source": "MainWindow.xaml",
      "target": "{{name}}.xaml"
    },
    {
      "modifiers": [],
      "source": "MainWindow.xaml.cs",
      "target": "{{name}}.xaml.cs"
    }
  ],
  "nuget": [
    {
      "packageId": "MyCustomPackage",
      "version": "1.0.0"
    }
  ]
}

修改完成后，重新打包模板，安装后即可在新项目中看到MyCustomPackage的NuGet包引用。