HotAvalonia.Fody

HotAvalonia.Fody is an optional Fody weaver designed to enhance the overall hot reload experience for HotAvalonia users.

Usage

Like any other Fody weaver, HotAvalonia.Fody can be configured either via FodyWeavers.xml, or directly in your project file using the WeaverConfiguration property, as can be seen below:

<PropertyGroup>
  <WeaverConfiguration>
    <Weavers>
      <HotAvalonia>
        <Solution Path="$(SolutionPath)">
          <Project Path="/home/user/projects/MyApp/src/MyApp/MyApp.csproj" AssemblyName="MyApp" />
          <Project Path="/home/user/projects/MyApp/src/MyApp.Desktop/MyApp.Desktop.csproj" AssemblyName="MyApp.Desktop" />
        </Solution>
        <PopulateOverride Enable="true" />
        <UseHotReload Enable="true" GeneratePathResolver="true" />
        <References Enable="false" Exclude="HotAvalonia.Core;Avalonia.Markup.Xaml.Loader" />
      </HotAvalonia>
    </Weavers>
  </WeaverConfiguration>
</PropertyGroup>

Here's a quick overview of the weaver-specific properties:

PopulateOverride

This feature weaver is responsible for injecting a small piece of logic into Avalonia resources (such as styles and resource dictionaries), allowing their original, precompiled Populate method to be overridden at runtime even in environments where method injection is unavailable.

Note that for this weaver to work properly, Fody needs to run after Avalonia has finished compiling the XAML files; otherwise, there will be nothing to inject into. This can be achieved by:

<FodyDependsOnTargets>$(FodyDependsOnTargets);CompileAvaloniaXaml</FodyDependsOnTargets>

UseHotReload

This feature weaver is responsible for automatically invoking HotAvalonia.AvaloniaHotReloadExtensions.UseHotReload(AppBuilder) on the AppBuilder instance created during app initialization, thereby kicking HotAvalonia into action. Thanks to this, users do not need to modify their source code to enable hot reload for their application.

References

This feature weaver is responsible for removing specified assembly references from the main module definition of your project and cleaning up related copy-local paths.

License

Licensed under the terms of the MIT License.