CoreStone.SDK.Dotnet.Versioning
1.5.0
dotnet add package CoreStone.SDK.Dotnet.Versioning --version 1.5.0
NuGet\Install-Package CoreStone.SDK.Dotnet.Versioning -Version 1.5.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="CoreStone.SDK.Dotnet.Versioning" Version="1.5.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="CoreStone.SDK.Dotnet.Versioning" Version="1.5.0" />
<PackageReference Include="CoreStone.SDK.Dotnet.Versioning" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add CoreStone.SDK.Dotnet.Versioning --version 1.5.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: CoreStone.SDK.Dotnet.Versioning, 1.5.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package CoreStone.SDK.Dotnet.Versioning@1.5.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=CoreStone.SDK.Dotnet.Versioning&version=1.5.0
#tool nuget:?package=CoreStone.SDK.Dotnet.Versioning&version=1.5.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
CoreStone.SDK.Dotnet.Versioning
App version check-in with force update, recommended update, and maintenance mode support.
Installation
dotnet add package CoreStone.SDK.Dotnet.Versioning
Setup
builder.Services
.AddCoreStoneConfiguration(o =>
{
o.BaseUrl = "https://api.yourapp.com";
o.ProjectKey = "your-project-slug";
})
.AddCoreStoneAuth()
.AddCoreStoneVersioning(); // ← add this
Usage
Call CheckInAsync at every app startup (after the user logs in) to enforce update policies:
public class StartupService
{
private readonly IVersioningClient _versioning;
public StartupService(IVersioningClient versioning) => _versioning = versioning;
public async Task RunAsync()
{
var status = await _versioning.CheckInAsync(new AppVersionCheckInRequest
{
DeviceId = "device-uuid-here",
Platform = "android", // ios | android | windows | macos | web | other
AppVersion = "2.4.1",
BuildNumber = 241,
OsVersion = "14.0",
DeviceModel = "Pixel 9",
Locale = "tr-TR",
});
if (status.MaintenanceMode)
{
// Show maintenance screen — backend is down
ShowMaintenanceScreen(status.Message);
return;
}
if (status.UpdateRequired)
{
// Block the user — this version is no longer supported
ShowForceUpdateScreen(status.StoreUrl, status.Message);
return;
}
if (status.UpdateRecommended)
{
// Non-blocking banner encouraging the user to update
ShowSoftUpdateBanner(status.StoreUrl);
}
// All good — proceed normally
}
}
Response fields
| Field | Type | Description |
|---|---|---|
UpdateRequired |
bool |
Force update — block the app |
UpdateRecommended |
bool |
Soft update — show a banner |
MaintenanceMode |
bool |
Backend is down — show maintenance screen |
LatestVersion |
string? |
Newest available version |
LatestBuildNumber |
int? |
Newest build number |
MinimumSupportedVersion |
string? |
Oldest supported version |
MinimumSupportedBuildNumber |
int? |
Oldest supported build number |
Message |
string? |
Human-readable message for the dialog |
StoreUrl |
string? |
App Store / Play Store deep-link |
Links
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net8.0
- CoreStone.SDK.Dotnet.Auth (>= 1.5.0)
- CoreStone.SDK.Dotnet.Configuration (>= 1.5.0)
-
net9.0
- CoreStone.SDK.Dotnet.Auth (>= 1.5.0)
- CoreStone.SDK.Dotnet.Configuration (>= 1.5.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.