Fody.PropertyChanged 开源项目教程

1. 项目目录结构及介绍

Fody.PropertyChanged 是一个针对 .NET 项目的 NuGet 包，用于自动注入 INotifyPropertyChanged 的实现到属性设置器中，简化MVVM等场景下的属性变更通知处理。以下是其基本的项目目录结构概览：

├── src
│   ├── PropertyChanged.Fody             # 主要的代码生成库
│   ├── PropertyChanged.Analyzers        # 提供编译时分析的组件
│   └── ...                              # 可能还包含测试和其他辅助库
├── tools                                 # Fody的工具目录，包含了在NuGet包安装过程中执行的脚本
├── samples                               # 示例项目，展示如何使用PropertyChanged.Fody
├── tests                                 # 测试目录，包括单元测试和集成测试
├── .gitattributes                        # Git属性文件
├── README.md                             # 项目的主要说明文件
└── LICENSE.txt                           # 许可证文件

• src 目录包含了核心的逻辑实现。
• tools 包含了安装此NuGet包时运行的Fody插件逻辑。
• samples 提供给开发者参考的示例应用。
• tests 用于确保代码质量的测试套件。

2. 项目的启动文件介绍

在Fody.PropertyChanged这类库中，没有传统意义上的“启动文件”，因为它是作为编译过程中的一个增强工具使用的。关键在于项目添加对它的依赖后，通过.csproj中的配置使得Fody在构建过程中自动工作。修改或新增<Project>标签内的Fody相关配置是激活它的“启动”方式。例如，在项目文件中加入以下代码来启用PropertyChanged.Fody:

<ItemGroup>
    <PackageReference Include="Fody.PropertyChanged" Version="特定版本号" />
</ItemGroup>

以及可能的配置项：

<PropertyGroup>
    <FodyWeaversXml><Weavers><PropertyChanged/></Weavers></FodyWeaversXml>
</PropertyGroup>

3. 项目的配置文件介绍

.csproj 文件配置

主要的配置发生在项目的 .csproj 文件中，通过添加Fody的包引用和指定配置。例如，使用 <PackageReference> 标签添加 Fody.PropertyChanged，并通过上述提到的FodyWeaversXml配置指定启用哪个Fody Weaver。

FodyWeavers.xml

除了.csproj文件，Fody插件的详细配置通常放在解决方案目录下的FodyWeavers.xml文件中（如果不存在，则需要手动创建）。这个文件用来配置Fody插件的行为，比如可以在这里更改默认事件触发方法的名字：

<?xml version="1.0" encoding="utf-8"?>
<FodyWeavers>
  <PropertyChanged>
    <!-- 自定义配置选项 -->
    <EventInvokerName>OnMyPropertyChanged</EventInvokerName>
  </PropertyChanged>
</FodyWeavers>

请注意，实际的FodyWeavers.xml内容应参照最新版本的文档或库提供的指南，因为配置选项可能会随版本更新而变化。

以上就是Fody.PropertyChanged项目的基本结构、启动机制与配置文件简介。通过这样的配置，开发人员无需手动编码即可享受属性变更通知的自动化处理。