Windows Community Toolkit - WPF和Windows Forms 控件使用指南

1. 项目目录结构及介绍

Microsoft.Toolkit.Win32 项目是一个开源项目，旨在简化在 WPF 和 Windows Forms 应用程序中使用 UWP 控件的流程。以下是项目的目录结构及其简要介绍：

• Microsoft.Toolkit.Win32.sln：项目的解决方案文件，用于在 Visual Studio 中打开整个项目。
• Microsoft.Toolkit.Win32.UI.Controls：包含 WPF 和 Windows Forms 控件的代码。
• Microsoft.Toolkit.Win32.UI.XamlHost：提供用于在 WPF 或 Windows Forms 应用程序中托管 UWP 控件的宿主代码。
• Tests：包含项目的单元测试代码。
• WebView.Shared：提供跨平台的 WebView 控件共享代码。
• build：包含构建项目所需的脚本和配置文件。
• .github：包含 GitHub 工作流程和模板文件。
• azure-pipelines.yml：定义 Azure DevOps 持续集成和持续部署的配置。
• contributing.md：提供贡献指南。
• global.json：定义项目全局设置，如 SDK 版本。
• license.md：项目的许可证信息。
• readme.md：项目的自述文件，提供项目概述和用法说明。
• 其他文件夹和文件：可能包含项目的其他资源和配置文件。

2. 项目的启动文件介绍

项目的启动文件通常是指项目中的主入口点，对于 WPF 项目通常是 .xaml 文件，而对于 Windows Forms 项目则是主窗体的 .cs 文件。以下是启动文件的简要介绍：

• 对于 WPF 项目，App.xaml 和 App.xaml.cs 文件定义了应用程序的入口点和基本配置。App.xaml 文件包含了应用程序的主窗口定义，而 App.xaml.cs 文件包含了应用程序的启动逻辑。
• 对于 Windows Forms 项目，MainForm.cs 或类似命名的文件通常包含了主窗体的实现，包括窗体的加载和初始化。

3. 项目的配置文件介绍

项目的配置文件用于定义项目的编译选项、依赖项和其他设置。以下是一些主要的配置文件介绍：

• .csproj 文件：这是项目的编译文件，它定义了项目的引用、编译器和构建配置。在 WPF 或 Windows Forms 项目中，通常会有一个 .csproj 文件对应于每个项目。
• Directory.Build.props 和 Directory.Build.targets：这些文件允许在项目级别或解决方案级别应用自定义的 MSBuild 属性和任务。
• app.config 或 web.config：这些配置文件用于定义应用程序的运行时设置，如应用程序设置、连接字符串和配置节。
• global.json：定义项目使用的全局设置，如 SDK 版本，这有助于确保所有开发人员使用相同的开发环境。

通过了解这些目录结构和配置文件，开发者可以更好地开始使用 Microsoft.Toolkit.Win32 项目，并在其应用程序中利用 WPF 和 Windows Forms 控件。