ShadowPluginLoader.WinUI

Tools.Config.props ​

这个文件用来告诉构建工具：项目是 SDK 还是插件，要不要自动打包，要不要生成多语言帮助类。

第一次构建时，工具会把默认文件复制到项目根目录。你也可以提前创建它：

Tools.Config.props
xml
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <IsPluginLoader>false</IsPluginLoader>
    <IsPlugin>false</IsPlugin>
    <AutoPluginPackage>true</AutoPluginPackage>
    <PluginMisxPackage>false</PluginMisxPackage>
    <AutoGenerateI18N>true</AutoGenerateI18N>
    <DebugSourceGenerator>false</DebugSourceGenerator>
  </PropertyGroup>
</Project>

先选好项目类型 ​

  • SDK 项目：IsPluginLoader=true，IsPlugin=false。
  • 插件项目：IsPluginLoader=false，IsPlugin=true。
  • 普通主程序：两项都设为 false。

IsPluginLoader 和 IsPlugin 选一个开启就好。

其他开关 ​

属性默认值用来做什么
AutoPluginPackagetrue构建插件时自动生成安装包
PluginMisxPackagefalse额外生成 MSIX 包，需要配置证书
AutoGenerateI18Ntrue从 Strings 中的资源文件生成多语言帮助类
DebugSourceGeneratorfalse把插件项目的生成代码保存到 GeneratedFiles，方便查看

plugin.json 模板仍需要自己填写，构建工具负责替换变量并生成最终文件。如果关闭自动打包，也要在自己的构建流程中安排元数据生成，具体见自定义打包。

想看工具生成了什么代码，可以打开 DebugSourceGenerator。这些文件仅用于查看，修改自己的源文件后重新构建即可。

多语言和构造函数的用法分别见国际化与快速依赖注入。