App Store

Frameworks

.NET MAUI

IAppStore looks up the latest published version from the relevant platform store and deep-links into the store or review page.

Registration

using Shiny;

builder.AddAppStore(opts =>
{
    opts.AppleAppId = "1234567890";
    opts.WindowsProductId = "9NBLGGH4NNS1";
});

Usage

public class UpdateChecker(IAppStore store)
{
    public async Task CheckForUpdates(CancellationToken ct = default)
    {
        var result = await store.GetCurrent(ct);
        if (result?.NeedsUpdate == true)
        {
            // result.StoreVersion, result.CurrentVersion, result.ReleaseNotes, etc.
            await store.OpenStore();
        }
    }

    public Task PromptForReview() => store.OpenReviewPage();
}

AppStoreOptions

Configure via AddAppStore(...) or services.Configure<AppStoreOptions>(...).

builder.AddAppStore(opts =>
{
    opts.AppleAppId = "1234567890";       // numeric App Store ID (required for iOS deep links)
    opts.WindowsProductId = "9NBLGGH4NNS1"; // Microsoft Store Product ID (required on Windows)
    opts.CountryCode = "us";
});

Option	Notes
AppleAppId	Numeric App Store ID. If not set, populated automatically after the first successful GetCurrent call (read from the iTunes lookup’s trackId)
AppleBundleId	Defaults to AppInfo.PackageName (CFBundleIdentifier on Apple platforms)
AndroidPackageName	Defaults to AppInfo.PackageName (applicationId on Android)
WindowsProductId	Required on Windows — distinct from the package family name; configure explicitly
CountryCode	Two-letter region code for store lookups (default "us")

AppStoreResult

public record AppStoreResult(
    Version StoreVersion,
    Version CurrentVersion,
    bool NeedsUpdate,
    string StoreUrl,
    string? ReleaseNotes = null,
    DateTimeOffset? ReleasedAt = null,
    double? AverageRating = null,
    long? RatingCount = null,
    string? MinimumOsVersion = null
);

Platform	Lookup	Fields populated
iOS / macCatalyst	iTunes Search API	All fields including ratings, release date, release notes, minimum OS
Android	Google Play HTML scrape	Version + NeedsUpdate. Ratings/notes/dates aren’t reliably exposed in the page HTML
Windows	Microsoft Store DisplayCatalog	Version, release notes (from ProductDescription), and ReleasedAt where available
Other TFMs	Not supported	Returns null

Caution

Android version detection works by parsing the Play Store HTML. Google changes the page structure periodically — keep an eye out for GetCurrent returning null on Android and report it on the GitHub repo if it stops matching.