Aquila.UpdateManager 1.0.0

Aquila.UpdateManager

Aquila.UpdateManager is a lightweight, production-ready cross-platform update checker for .NET MAUI applications. It supports Android (Google Play) and Windows (Microsoft Store) and is designed to integrate cleanly with your existing UI layer (Snackbars, Toasts, Dialogs, etc.).

⚡ Built for real MAUI apps 🧩 Clean separation of logic & UI 📦 NuGet-ready, multi-targeted library

✨ Features

• ✅ Cross-platform (Android + Windows)
• 🔄 Async update check (CheckAsync)
• 📣 Event-based notification (OnUpdateAvailable)
• 🏪 Store redirection (Play Store / Microsoft Store)
• 🧱 Platform-specific implementations using conditional compilation
• 🧩 UI-agnostic (works with Aquila.MsgBits, CommunityToolkit, custom UI)
• 🧪 Easy to extend with real server APIs

📦 Supported Platforms

📥 Installation

Via NuGet (Recommended)

dotnet add package Aquila.UpdateManager

or via Visual Studio → Manage NuGet Packages.

🚀 Quick Start

1️⃣ Subscribe to update events

using Aquila.UpdateManager;

UpdateManager.Current.OnUpdateAvailable += (_, version) =>
{
    Console.WriteLine($"New version available: {version}");
};

2️⃣ Trigger update check

await UpdateManager.Current.CheckAsync();

3️⃣ Open store manually (optional)

UpdateManager.Current.OpenStore();

🔔 Example: Integration with Aquila.MsgBits

Aquila.UpdateManager does NOT depend on UI libraries by design. You decide how to notify the user.

Example using Aquila.MsgBits.Snackbar

using Aquila.UpdateManager;
using Aquila.MsgBits;

UpdateManager.Current.OnUpdateAvailable += (_, version) =>
{
    Snackbar.Show(
        $"Update available (v{version})",
        actionText: "Update",
        action: UpdateManager.Current.OpenStore
    );
};

✔ Clean ✔ Decoupled ✔ Testable

🧠 How It Works

🔍 Version Check Flow

1. Reads installed app version from the platform
2. Fetches latest version (currently simulated)
3. Compares versions using System.Version
4. Fires OnUpdateAvailable if a newer version exists

🏗️ Architecture Overview

UpdateManager (Shared)
│
├── IUpdateService
│
├── Android UpdateService
│   └── Uses PackageManager + Play Store URI
│
└── Windows UpdateService
    └── Uses Package.Current + Microsoft Store URI

✔ Platform logic isolated ✔ Shared API stays clean

🧪 Simulated Version Check

By default, the latest version is hardcoded for demonstration:

return new Version("1.1.0");

🔄 Recommended Production Upgrade

Replace this with:

• REST API
• Firebase Remote Config
• App Center
• Custom backend

Example:

var latest = await httpClient.GetStringAsync("/api/app/version");
return new Version(latest);

🏪 Store Redirection

Android

• Opens Google Play via:

market://details?id=your.package.name

• Falls back to browser if Play Store app is unavailable

Windows

• Opens Microsoft Store via:

ms-windows-store://pdp/?productid=YOUR_PRODUCT_ID

⚠️ Important Notes

• The library does not force UI
• No dialogs, snackbars, or popups are shown automatically
• You have full control over UX
• Suitable for:
  • Enterprise apps
  • White-label apps
  • Store-distributed apps

🧩 Extending the Library

You can easily add:

• 🌐 HTTP-based version provider
• 🧩 Dependency Injection support
• ⏱️ Scheduled / background checks
• 📲 Android in-app updates (Play Core)
• 🧪 Unit-testable version sources

📄 License

MIT (Restricted) © Aquila Innovations

Unauthorized copying, modification, distribution, or reuse of this code or its logic is strictly prohibited without permission.

🏁 Summary

✔ Production-ready MAUI update checker ✔ Clean, extensible architecture ✔ Android + Windows support ✔ UI-framework agnostic ✔ Perfect for NuGet distribution