GamaLearn.Maui Documentation

Welcome to the official documentation for GamaLearn.Maui - a comprehensive collection of utilities and components for building robust .NET MAUI applications.

🚀 Getting Started

GamaLearn.Maui provides essential building blocks for .NET MAUI development, including:

Threading Utilities - Debouncing and throttling for efficient UI updates
Collections - High-performance observable collections with bulk operations
Guard Clauses - Robust argument validation utilities
Services - Cross-platform services (battery, device info, app ratings)
Extensions - Color manipulation, string utilities, and more
Platform Helpers - Safe area insets and keyboard management

📦 Installation

Install via NuGet Package Manager:

dotnet add package GamaLearn.Maui.Core

Or via Package Manager Console:

Install-Package GamaLearn.Maui.Core

⚙️ Setup

Register Services (Optional)

If you're using services like BatteryService or DeviceInfoService, register them in your MauiProgram.cs:

using GamaLearn;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });

        // Register individual services
        builder.Services.AddBatteryService();
        builder.Services.AddDeviceInfoService();

        // Or register all core services at once
        builder.Services.AddGamaLearnCoreServices();

        // Register app rating service with configuration
        builder.Services.AddAppRatingService(options =>
        {
            options.IOSAppId = "123456789";
            options.WindowsProductId = "9NBLGGH4NNS1";
            options.AndroidPackageName = "com.yourcompany.yourapp";
        });

        return builder.Build();
    }
}

Android Keyboard Monitoring (Optional)

If using KeyboardHelper on Android, add monitoring in your MainActivity.cs:

using GamaLearn.Helpers;

protected override void OnCreate(Bundle? savedInstanceState)
{
    base.OnCreate(savedInstanceState);

    // Start keyboard monitoring
    var rootView = Window?.DecorView?.FindViewById(Android.Resource.Id.Content);
    if (rootView != null)
    {
        KeyboardHelper.StartMonitoring(rootView);
    }
}

protected override void OnDestroy()
{
    KeyboardHelper.StopMonitoring();
    base.OnDestroy();
}

📚 Documentation Sections

API Reference

Comprehensive API documentation for all classes, methods, and properties.

🎯 Quick Example

using GamaLearn;

// Use Debouncer to delay search execution
var debouncer = new Debouncer();
await debouncer.DebounceAsync(async () =>
{
    await PerformSearchAsync(searchText);
}, TimeSpan.FromMilliseconds(500));

// Use ObservableRangeCollection for efficient bulk updates
var collection = new ObservableRangeCollection<Item>();
collection.AddRange(newItems); // Single notification for multiple items

🌐 Platform Support

✅ Windows (WinUI 3)
✅ Android
✅ iOS
✅ MacCatalyst

Requirements:

.NET 9.0 or later
.NET MAUI workload installed

🔗 Links

📄 License

GamaLearn.Maui is licensed under the MIT License.