The owner, 2026-10-31: an alpha build where new .NET versions are tried, .NET 11 RC3 / C# 15 first, with an experimental-build warning (owner decisions D73-D76, asked while planning). This is the plumbing on main; it changes nothing in a beta. - RELEASE_LINE (main | alpha), read like VERSION by Directory.Build.props, stamped as the FrameLedger.ReleaseLine assembly metadata; any other value is a build error. Shared.BuildLine reads it back for composition (BuildLineTests, AssemblyIdentityTests). - release.yml: the version gate reads RELEASE_LINE - the alpha line takes vX.Y.Z-alpha.N and nothing else, no other line may carry an -alpha. tag; an alpha's vpk download and pack take --channel alpha (feed releases.alpha.json, asset names from assets.<channel>.json); the main line's pack command is unchanged. An alpha's release is titled "(experimental alpha)". - ci.yml: also on pushes to alpha; no sonarcloud job and no Changelog step for pull requests into alpha. wiki.yml: no publish after an -alpha. tag. - tools/fps-impact-runbook.ps1: the Agent path no longer names a TFM. - Docs: 12_BUILD §The alpha line, 13_CI_CD §The alpha line (+ ci/release/wiki sections, branch policy), 11_UPDATER §Channels corrected in place (the alpha line uses Velopack channels; GithubSource reads the newest ten releases, hence one alpha per beta), 20_OPEN_QUESTIONS §G "The main line's .NET" with its decision table written first, CLAUDE.md, CHANGELOG. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
151 lines
8.8 KiB
XML
151 lines
8.8 KiB
XML
<Project>
|
|
|
|
<!--
|
|
Shared MSBuild properties for every managed project. See docs/12_BUILD.md.
|
|
|
|
TargetFramework vs SupportedOSPlatformVersion are two different knobs and
|
|
must not be conflated:
|
|
- TargetFramework's platform version selects which Windows API
|
|
projections are available to compile against.
|
|
- SupportedOSPlatformVersion is the floor CA1416 enforces.
|
|
NFR-8 requires Windows 10 22H2 = build 19045. Letting the supported version
|
|
default to the TFM's 19041 would silently accept installs three releases
|
|
below the stated floor.
|
|
|
|
A bare `net10.0-windows` is wrong for a different reason: it resolves to
|
|
net10.0-windows7.0, and CA1416 would then error on Mica, MiniDumpWriteDump
|
|
and IDXGIAdapter3::QueryVideoMemoryInfo — every Windows-10-era API this
|
|
application is built on.
|
|
|
|
Why the target is 22621 and not 19045: the SDK enforces
|
|
SupportedOSPlatformVersion <= TargetPlatformVersion (NETSDK1135), and 19045
|
|
is not a Windows targeting-pack version in any case — the packs are cut at
|
|
19041, 20348, 22000, 22621, 26100. docs/12_BUILD.md already requires the
|
|
Windows 11 SDK >= 10.0.22621 as a prerequisite, so targeting it costs
|
|
nothing and CA1416 still enforces the 19045 floor at the API level.
|
|
-->
|
|
<PropertyGroup>
|
|
<TargetFramework>net10.0-windows10.0.22621.0</TargetFramework>
|
|
<SupportedOSPlatformVersion>10.0.19045.0</SupportedOSPlatformVersion>
|
|
|
|
<!-- x64 only (CLAUDE.md pinned stack, NFR-8). Previously asserted in prose
|
|
and enforced nowhere except an ad-hoc -r win-x64 on the publish line.
|
|
RuntimeIdentifier is set per-executable rather than here: forcing a RID
|
|
onto class libraries pulls RID-specific assets into their restore for
|
|
no benefit. -->
|
|
<Platforms>x64</Platforms>
|
|
<PlatformTarget>x64</PlatformTarget>
|
|
|
|
<LangVersion>latest</LangVersion>
|
|
<Nullable>enable</Nullable>
|
|
<ImplicitUsings>enable</ImplicitUsings>
|
|
<InvariantGlobalization>false</InvariantGlobalization>
|
|
|
|
<TreatWarningsAsErrors>true</TreatWarningsAsErrors>
|
|
<AnalysisLevel>latest-all</AnalysisLevel>
|
|
<EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
|
|
<EnableNETAnalyzers>true</EnableNETAnalyzers>
|
|
|
|
<Deterministic>true</Deterministic>
|
|
<ContinuousIntegrationBuild Condition="'$(CI)' == 'true'">true</ContinuousIntegrationBuild>
|
|
<GenerateDocumentationFile>true</GenerateDocumentationFile>
|
|
|
|
<!-- i18n: keep publish size down (docs/09_I18N.md). -->
|
|
<SatelliteResourceLanguages>en;vi;ja</SatelliteResourceLanguages>
|
|
|
|
<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
|
|
|
|
<!-- ONE version source (P4 PR-5, docs/12_BUILD.md §Version): the VERSION file
|
|
at the repository root. src/native/CMakeLists.txt reads the same file for
|
|
the VERSIONINFO blocks, and tools/versioninfo-check.ps1 compares the built
|
|
binaries against it, so the managed and native halves cannot drift. The
|
|
condition lets release.yml pass -p:Version=<tag> for a pre-release
|
|
(0.1.0-beta.1 is not a number CMake's project() accepts, so the native
|
|
FileVersion stays the numeric core). SourceLink's "+sha" suffix is off so
|
|
About, Hello and the bug bundle print the version a user can find on the
|
|
releases page. -->
|
|
<FrameLedgerVersionFile>$(MSBuildThisFileDirectory)VERSION</FrameLedgerVersionFile>
|
|
<Version Condition="'$(Version)' == '' And Exists('$(FrameLedgerVersionFile)')">$([System.IO.File]::ReadAllText('$(FrameLedgerVersionFile)').Trim())</Version>
|
|
<IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
|
|
|
|
<!-- D73 (2026-10-31): the RELEASE LINE, from the RELEASE_LINE file beside VERSION - `main`, the betas and releases on
|
|
the .NET that global.json pins, or `alpha`, a beta's source built on a prerelease .NET from the long-lived `alpha`
|
|
branch, where this file and global.json are two of the few lines that differ (docs/12_BUILD.md §The alpha line).
|
|
Not a property a command line sets: the file is the one source, release.yml refuses a tag that disagrees with it,
|
|
and the target below refuses a value that is neither line. Every assembly carries it (the ItemGroup below), and
|
|
Shared.BuildLine reads it at run time. -->
|
|
<FrameLedgerReleaseLineFile>$(MSBuildThisFileDirectory)RELEASE_LINE</FrameLedgerReleaseLineFile>
|
|
<FlReleaseLine Condition="Exists('$(FrameLedgerReleaseLineFile)')">$([System.IO.File]::ReadAllText('$(FrameLedgerReleaseLineFile)').Trim())</FlReleaseLine>
|
|
</PropertyGroup>
|
|
|
|
<ItemGroup>
|
|
<AssemblyMetadata Include="FrameLedger.ReleaseLine" Value="$(FlReleaseLine)" />
|
|
</ItemGroup>
|
|
|
|
<Target Name="FrameLedgerReleaseLineCheck" BeforeTargets="BeforeBuild" Condition="'$(FlReleaseLine)' != 'main' And '$(FlReleaseLine)' != 'alpha'">
|
|
<Error Text="RELEASE_LINE at the repository root must say 'main' or 'alpha', and it says '$(FlReleaseLine)' (docs/12_BUILD.md §The alpha line)" />
|
|
</Target>
|
|
|
|
<!-- The NuGet audit (2026-10-25, docs/13_CI_CD.md §Dependabot and the NuGet audit): every restore checks the WHOLE
|
|
package graph, transitive packages included, against the advisory database, at every severity. These are the
|
|
SDK's defaults for net10.0, written down so that a later SDK's defaults cannot move them. With
|
|
TreatWarningsAsErrors, a vulnerable package is NU1901-NU1904 and the restore - and so the gate - is red, which
|
|
is what happened with SQLitePCLRaw 2.1.11 (Directory.Packages.props). -->
|
|
<PropertyGroup>
|
|
<NuGetAudit>true</NuGetAudit>
|
|
<NuGetAuditMode>all</NuGetAuditMode>
|
|
<NuGetAuditLevel>low</NuGetAuditLevel>
|
|
</PropertyGroup>
|
|
|
|
<!-- beta.14 (D50): every managed binary names the product and who wrote it, as the native ones always have
|
|
(19_SAFETY: a binary says plainly what it is). Explorer's Properties > Details and Task Manager read these. Until
|
|
beta.14 the SDK's defaults stood: the Agent's Company and Product read "FrameLedger.Agent", each library's its own
|
|
assembly name, and no managed binary carried a copyright. The copyright is the native FL_COPYRIGHT
|
|
(src/native/CMakeLists.txt) word for word: tools/versioninfo-check.ps1 reads both from the built binaries and is
|
|
red when they differ. The file description is the AssemblyTitle - an entry point sets its own, a library keeps its
|
|
assembly name - and the Description is the Comments field, the native blocks' sentence for a library. The SDK
|
|
stamps RepositoryUrl into every assembly as AssemblyMetadata; it is the App's IssueLink.Repository, and the App's
|
|
AssemblyIdentityTests holds the two equal (a fork changes both - FORKING.md). -->
|
|
<PropertyGroup>
|
|
<Company>FrameLedger</Company>
|
|
<Product>FrameLedger</Product>
|
|
<Authors>poli0981</Authors>
|
|
<Copyright>Copyright (C) 2026 poli0981. GPL-3.0-only with additional terms: see NOTICE</Copyright>
|
|
<Description>Performance measurement tool. Identifies itself deliberately; see https://github.com/poli0981/frameledger</Description>
|
|
<RepositoryUrl>https://github.com/poli0981/frameledger</RepositoryUrl>
|
|
</PropertyGroup>
|
|
|
|
<!-- beta.12: the source a build was made from - release.yml passes the tag (a rehearsal, its commit); a local build has
|
|
none. The App's links into the repository open THIS version's documents with it (Services/RepositoryLinks.cs).
|
|
Every assembly since beta.14 (D50), not the App's alone: the two publishes build the same libraries into one
|
|
out/app, and release.yml passes the same ref to both. -->
|
|
<ItemGroup Condition="'$(FrameLedgerSourceRef)' != ''">
|
|
<AssemblyMetadata Include="FrameLedgerSourceRef" Value="$(FrameLedgerSourceRef)" />
|
|
</ItemGroup>
|
|
|
|
<!-- Test projects: documentation comments are noise, and xUnit's own
|
|
analyzers already cover what matters there. -->
|
|
<PropertyGroup Condition="$(MSBuildProjectName.EndsWith('.Tests'))">
|
|
<GenerateDocumentationFile>false</GenerateDocumentationFile>
|
|
<IsPackable>false</IsPackable>
|
|
</PropertyGroup>
|
|
|
|
<!-- Analyzers everywhere (CLAUDE.md §Coding conventions). Build-time only,
|
|
so they do not violate Domain's "references nothing" rule. -->
|
|
<ItemGroup>
|
|
<PackageReference Include="Roslynator.Analyzers">
|
|
<PrivateAssets>all</PrivateAssets>
|
|
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
|
|
</PackageReference>
|
|
<PackageReference Include="Meziantou.Analyzer">
|
|
<PrivateAssets>all</PrivateAssets>
|
|
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
|
|
</PackageReference>
|
|
<PackageReference Include="Microsoft.VisualStudio.Threading.Analyzers">
|
|
<PrivateAssets>all</PrivateAssets>
|
|
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
|
|
</PackageReference>
|
|
</ItemGroup>
|
|
|
|
</Project>
|