Allow packages to not go stable

[joperezr]

Fixes #2541

cc: @eerhardt

With these changes, now individual projects can decide to stay marked as preview even when the rest of the repo is producing stable packages. Once we branch for GA, We will update StabilizePackageVersion and set it to true meaning that the repo will start producing stable packages. That said, individual projects will be able to stay in prerelease by adding the following property in their .csproj:

    <PropertyGroup>
        <!-- This project will remain producing prerelease versions, even when the rest of the repo is producing stable packages -->
        <SuppressFinalPackageVersion>true</SuppressFinalPackageVersion>
    </PropertyGroup>

This model is the same as the one used by dotnet/runtime repo.

Microsoft Reviewers: Open in CodeFlow

[eerhardt]

https://github.com/dotnet/arcade/blob/cd27fcf3c2b5c238acd3e8d1e85bb6ef6c205686/Documentation/CorePackages/Versioning.md?plain=1#L119-L120

Some projects want to remain producing pre-release packages even if the repository is running a final stable build because
they don't ship or aren't ready to ship stable. Those projects can set SuppressFinalPackageVersion property to true.

Why wouldn't we use SuppressFinalPackageVersion? I think StabilizePackageVersion is meant to be set globally for the whole build (i.e. in a build/environment variable).

[joperezr]

Oh, I wasn't aware of the property's existence 😋.

I'm assuming this would just work if that is set with the changes I have here, but I'll double-check.

[eerhardt]

I'm assuming this would just work if that is set with the changes I have here

Agreed. I guess I was mostly commenting on the PR description above in the top post. For the libraries we don't want to go stable, we should just need to set <SuppressFinalPackageVersion>true</SuppressFinalPackageVersion> in their .csproj.

[eerhardt]

LGTM

[radical]

For the libraries we don't want to go stable, we should just need to set <SuppressFinalPackageVersion>true</SuppressFinalPackageVersion> in their .csproj.

The PR description should be updated to reference this property.

[joperezr]

Sorry this took a while, I have just validated that the property indeed works with these changes and packages would remain unstable.

[joperezr]

For the libraries we don't want to go stable, we should just need to set <SuppressFinalPackageVersion>true</SuppressFinalPackageVersion> in their .csproj.

The PR description should be updated to reference this property.

Updated.

[eerhardt]

@joperezr - was this supposed to be backported to release/8.0? I don't see the change in that branch

[joperezr]

You are correct, fixing that now.

[joperezr]

/backport to release/8.0

[github-actions]

Started backporting to release/8.0: https://github.com/dotnet/aspire/actions/runs/8695610684