nalu-maui-core

name	nalu-maui-core
description	Nalu.Maui.Core utilities for soft keyboard handling and background iOS HTTP. Use when configuring soft keyboard (Resize/Pan), binding to keyboard state, or handling HTTP when the app is backgrounded on iOS.

Nalu.Maui.Core

Utilities for soft keyboard management and iOS background HTTP requests.

When to use

• Soft keyboard: consistent Resize/Pan behavior on Android and iOS; bind UI visibility to keyboard state.
• Background HTTP: avoid "The network connection was lost" when the app is backgrounded on iOS.

Setup

No explicit UseNalu* in MauiProgram for Core; use the types and attachables below. For background HTTP on iOS, configure AppDelegate (see Caveats).

Soft keyboard

• Enable default: builder.UseNaluSoftKeyboardManager(defaultAdjustMode: SoftKeyboardAdjustMode.Resize).
• Per-layout override in XAML: naluCore:SoftKeyboardManager.SoftKeyboardAdjustMode="Pan" (ancestors are searched for first specified mode).
• Bind to keyboard state: SoftKeyboardManager.State (e.g. IsHidden) to show/hide areas when keyboard is visible.

<VerticalStackLayout naluCore:SoftKeyboardManager.SoftKeyboardAdjustMode="Pan">
    <Entry />
</VerticalStackLayout>
<VerticalStackLayout.IsVisible>
    <Binding Path="IsHidden" Source="{x:Static nalu:SoftKeyboardManager.State}" x:DataType="nalu:SoftKeyboardState" />
</VerticalStackLayout.IsVisible>

Background iOS HTTP

Use NSUrlBackgroundSessionHttpMessageHandler so requests continue when the app is backgrounded:

#if IOS
    HttpClient client = DeviceInfo.DeviceType == DeviceType.Virtual
        ? new()
        : new(new NSUrlBackgroundSessionHttpMessageHandler());
#else
    HttpClient client = new();
#endif

In AppDelegate:

[Export("application:handleEventsForBackgroundURLSession:completionHandler:")]
public virtual void HandleEventsForBackgroundUrl(UIApplication application, string sessionIdentifier, Action completionHandler)
    => NSUrlBackgroundSessionHttpMessageHandler.HandleEventsForBackgroundUrl(application, sessionIdentifier, completionHandler);

For app crash/termination during a request: add header NSUrlBackgroundSessionHttpMessageHandler.RequestIdentifierHeaderName and implement INSUrlBackgroundSessionLostMessageHandler to handle the lost response.

Caveats

• Do not use soft keyboard manager with MAUI's CollectionView that contains input fields (resize causes jumps). Use the VirtualScroll component instead (Nalu.Maui.VirtualScroll).
• iOS Simulator does not support background sessions; use a physical device.
• Process response and close the using block within a few seconds in background or iOS may terminate the app.

Additional context

• Full docs: Core
• Code: Source/Nalu.Maui.Core/