make the examples executable with the local project

Author: smdn

examples/Directory.Build.props

@@ -0,0 +1,13 @@
+<!--
+SPDX-FileCopyrightText: 2025 smdn <smdn@smdn.jp>
+SPDX-License-Identifier: MIT
+-->
+<Project>
+  <PropertyGroup>
+    <!--
+      Set this property to `true` if you want to build and run the examples using the local projects
+      instead of published NuGet packages.
+    -->
+    <UseLocalProjectInsteadOfPublishedPackage>false</UseLocalProjectInsteadOfPublishedPackage>
+  </PropertyGroup>
+</Project>

examples/Directory.Build.targets

@@ -0,0 +1,27 @@
+<!--
+SPDX-FileCopyrightText: 2025 smdn <smdn@smdn.jp>
+SPDX-License-Identifier: MIT
+-->
+<Project InitialTargets="ReplaceSmdnExtensionsMtpLiquidTestReportsPackageReferencesToProjectReferences">
+  <!-- Replace PackageReference to ProjectReference of the local project -->
+  <Target
+    Name="ReplaceSmdnExtensionsMtpLiquidTestReportsPackageReferencesToProjectReferences"
+    Condition=" '$(UseLocalProjectInsteadOfPublishedPackage)' == 'true' "
+  >
+    <ItemGroup>
+      <_SmdnExtensionsMtpLiquidTestReportsReference
+        Include="@(PackageReference)"
+        Condition="$([System.String]::new('%(Identity)').StartsWith('Smdn.Extensions.Mtp.LiquidTestReports'))"
+        ProjectPath="$(MSBuildThisFileDirectory)..\src\%(Identity)\%(Identity).csproj"
+      />
+    </ItemGroup>
+
+    <ItemGroup>
+      <!-- Remove package references to Smdn.Extensions.Mtp.LiquidTestReports.* -->
+      <PackageReference Remove="@(_SmdnExtensionsMtpLiquidTestReportsReference)" />
+
+      <!-- Include project reference to Smdn.Extensions.Mtp.LiquidTestReports.* -->
+      <ProjectReference Include="%(_SmdnExtensionsMtpLiquidTestReportsReference.ProjectPath)"/>
+    </ItemGroup>
+  </Target>
+</Project>

examples/README.md

@@ -2,3 +2,8 @@
 
 ## How to run examples
 Move to each example directory and execute the command `dotnet test`.
+
+## How to modify libraries
+Each example in this directory by default refers to published NuGet packages.
+
+You can change the property `UseLocalProjectInsteadOfPublishedPackage` in file [Directory.Build.props](./Directory.Build.props) to refer to a local project by changing it to `true`.

examples/Smdn.Extensions.Mtp.LiquidTestReports/Directory.Build.props

@@ -0,0 +1,13 @@
+<!--
+SPDX-FileCopyrightText: 2025 smdn <smdn@smdn.jp>
+SPDX-License-Identifier: MIT
+-->
+<Project>
+  <Import Project="$(MSBuildThisFileDirectory)..\Directory.Build.props"/>
+
+  <!-- When using an extension built from source, load the props file to enable the extension.-->
+  <Import
+    Project="$(MSBuildThisFileDirectory)..\..\src\Smdn.Extensions.Mtp.LiquidTestReports\buildMultiTargeting\Smdn.Extensions.Mtp.LiquidTestReports.props"
+    Condition="'$(UseLocalProjectInsteadOfPublishedPackage)' == 'true'"
+  />
+</Project>