XamarinBridge.Maui 0.1.0

XamarinBridge.Maui

Accelerate your Xamarin.Forms to .NET MAUI migration with Roslyn analyzers, code fixers, and drop-in runtime compatibility shims.

Packages

Quick Start

1. Install the analyzer (catches migration issues at build time)

dotnet add package XamarinBridge.Maui

2. Install the runtime compat shims (drop-in replacements)

dotnet add package XamarinBridge.Compat

3. Register in MauiProgram.cs

using XamarinBridge.Compat;

var builder = MauiApp.CreateBuilder();
builder.UseXamarinCompat();

Analyzers (XamarinBridge.Maui)

Runtime Shims (XamarinBridge.Compat)

DependencyService

Drop-in for Xamarin.Forms.DependencyService. Routes to MAUI DI when available.

using XamarinBridge.Compat;

// Register (same API as Xamarin.Forms)
DependencyService.Register<IMyService, MyServiceImpl>();

// Resolve — checks internal registry, then falls back to MAUI DI
var svc = DependencyService.Get<IMyService>();
var transient = DependencyService.Get<IMyService>(DependencyFetchTarget.NewInstance);

MessagingCenter

Drop-in for Xamarin.Forms.MessagingCenter. Backed by WeakReferenceMessenger.

using XamarinBridge.Compat;

// Subscribe
MessagingCenter.Subscribe<MainPage>(this, "Refresh", sender => { /* ... */ });

// Send
MessagingCenter.Send(this, "Refresh");

// With args
MessagingCenter.Subscribe<MainPage, string>(this, "Navigate", (sender, route) => { /* ... */ });
MessagingCenter.Send(this, "Navigate", "/details/42");

// Unsubscribe
MessagingCenter.Unsubscribe<MainPage>(this, "Refresh");

Device

Drop-in for Xamarin.Forms.Device. Routes to MAUI DeviceInfo/MainThread.

using XamarinBridge.Compat;

// Platform detection
if (Device.RuntimePlatform == Device.iOS) { /* ... */ }

// Idiom
if (Device.Idiom == TargetIdiom.Tablet) { /* ... */ }

// Main thread
Device.BeginInvokeOnMainThread(() => label.Text = "Updated");
await Device.InvokeOnMainThreadAsync(() => DoWork());

// Timer
Device.StartTimer(TimeSpan.FromSeconds(5), () => { Refresh(); return true; });

ApplicationProperties

Drop-in for Application.Current.Properties. Backed by MAUI Preferences.

using XamarinBridge.Compat;

var props = ApplicationProperties.Current;
props["username"] = "michael";
props["loginCount"] = 42;

var name = (string)props["username"];
await props.SaveAsync(); // No-op — auto-persists

OnPlatform

Concise platform branching in code-behind.

using XamarinBridge.Compat;

var fontSize = OnPlatform.Get(ios: 14.0, android: 16.0, defaultValue: 15.0);
var margin = OnPlatform.Get(ios: 20, android: 16, winui: 24, defaultValue: 16);

ColorConverter

Bridges Xamarin.Forms color patterns to MAUI Colors.

using XamarinBridge.Compat;

var red = ColorConverter.FromHex("#FF0000");
var blue = ColorConverter.FromRgb(0, 0, 255);
var semiTransparent = ColorConverter.FromRgba(1.0, 0.0, 0.0, 0.5);
var green = "#00FF00".ToMauiColor();

EffectCompat

Base class for migrating Xamarin.Forms Effects to MAUI PlatformBehaviors.

using XamarinBridge.Compat;

// Before (Xamarin.Forms):
// public class ShadowEffect : RoutingEffect { ... }

// After (MAUI with XamarinBridge):
public class ShadowEffect : EffectCompat<View>
{
    protected override void OnAttached(View element) { /* add shadow */ }
    protected override void OnDetached(View element) { /* remove shadow */ }
}

MigratedRendererAttribute

Documentation attribute to track renderer → handler migration progress.

using XamarinBridge.Compat;

[MigratedRenderer(typeof(CustomEntry), Notes = "Converted to handler pattern 2024-03")]
public class CustomEntryHandler : ViewHandler<CustomEntry, UITextField> { }

Roadmap

• XB004 - OnElementChanged → handler mapper pattern
• XB005 - DependencyService.Get<T>() → constructor injection
• XB007 - Effects → PlatformBehavior scaffold
• XB009 - MessagingCenter → WeakReferenceMessenger
• Navigation stack compatibility (INavigation → Shell bridge)
• CLI migration scanner (solution-wide analysis + report)

License

MIT