Bodenberg.AppDimens.Dynamic 3.5.1.4

Bodenberg.AppDimens.Dynamic

.NET 10 binding for Android (net10.0-android) that wraps AppDimens Dynamic — responsive dp / sp / px sizing in code (no XML dimen grids), with 15 scaling strategies, conditional facilitators, aspect-ratio and multi-window variants, physical units, auto-resize helpers, and optional DataStore-backed caching.

Kotlin/Java sources, strategy semantics, and Android-focused guides live upstream:

→ bodenberg/appdimens-dynamic · DOCUMENTATION · KDoc search

Maven artifact embedded in this package: io.github.bodenberg:appdimens-dynamic 3.1.5.

Install

dotnet add package Bodenberg.AppDimens.Dynamic --version 3.5.1.4

Requirements

Use Android SDK platform 36+ (or MSBuild InstallAndroidDependencies) when building bindings locally on .NET 10.

What this library provides

C# namespaces (binding layout)

Public Kotlin @JvmStatic APIs appear under Com.Appdimens.Dynamic.* (Java package → C# namespace):

Foldable-aware overloads use AndroidX.Window.Layout.IFoldingFeature from Xamarin.AndroidX.Window.

Quick start (Activity / Views)

Warm the cache once (recommended), then read pixel sizes:

using Android.App;
using Android.OS;
using Com.Appdimens.Dynamic.Code;

[Activity(Label = "My App", MainLauncher = true)]
public class MainActivity : Activity
{
    protected override void OnCreate(Bundle? savedInstanceState)
    {
        base.OnCreate(savedInstanceState);

        DimenSdp.WarmupCache(this);

        float paddingPx = DimenSdp.Sdp(this, 16);
        float heightPx  = DimenSdp.Hdp(this, 32);
        float widthPx   = DimenSdp.Wdp(this, 100);
        float fontPx    = DimenSsp.Ssp(this, 16);
    }

    public override void OnConfigurationChanged(Android.Content.Res.Configuration newConfig)
    {
        base.OnConfigurationChanged(newConfig);
        Com.Appdimens.Dynamic.Core.DimenCache.InvalidateOnConfigChange(newConfig);
    }
}

Scaled API (DimenSdp / DimenSsp)

Primary entry points in Com.Appdimens.Dynamic.Code:

Inverter shortcuts (orientation-aware axis switch), examples:

• SdpPh / SdpPha — smallest width in portrait → height in landscape
• SdpLw / SdpLwa — smallest width → width in landscape
• HdpLw, WspLh, … — same idea for HDP / WSP

Facilitators (imperative), examples:

// Landscape uses 24 sdp, otherwise 16
float pad = DimenSdp.SdpRotate(this, 16, 24);

// TV UI mode override
float tvTitle = DimenSsp.SspMode(this, 16, 22, Com.Appdimens.Dynamic.Common.UiModeType.Television);

// sw ≥ 600 bucket
float tablet = DimenSdp.SdpQualifier(this, 16, 20,
    Com.Appdimens.Dynamic.Common.DpQualifier.SmallWidth, 600);

// Combined UI mode + qualifier (+ optional FoldingFeature overloads)
float fold = DimenSdp.SdpScreen(this, 16, 28,
    Com.Appdimens.Dynamic.Common.UiModeType.Television,
    Com.Appdimens.Dynamic.Common.DpQualifier.SmallWidth, 600);

Kotlin extension-style facilitators (sdpRotatePlain, nested chains) are exposed as DimenSdpExtensionsKt / DimenSspExtensionsKt when generated; prefer plain Dp/float overloads in C# when chaining to avoid double scaling (see upstream COMPOSE-API-CONVENTIONS).

DimenScaled builder

Build a rule list; resolution uses priority inside the builder, not lexical nesting:

using Com.Appdimens.Dynamic.Code;
using Com.Appdimens.Dynamic.Common;

var scaled = DimenSdp.Scaled(16)
    .Screen(UiModeType.Television, DpQualifier.SmallWidth, 600, 40f)
    .Screen(UiModeType.Television, 32f)
    .Screen(Orientation.Landscape, 20f);

float px = scaled.Sdp(this);

Use DimenSsp.Scaled / ScaledSp for typography with the same .Screen(...) pattern.

Other scaling strategies

Each strategy lives under Com.Appdimens.Dynamic.Code.<Strategy> with Dimen<Strategy>, Dimen<Strategy>Dp, Dimen<Strategy>Sp, extension/facilitator types, and optional *Scaled builders.

Recommendation: start with Scaled → then percent / auto when needed; adopt others for specialized layouts (strategy guide).

Method prefixes mirror Scaled (psdp, asdp, fsdp, …) — import the matching Dimen* type for that strategy.

Physical units

Com.Appdimens.Dynamic.Code.Units.DimenPhysicalUnits converts real-world units using display metrics:

using Com.Appdimens.Dynamic.Code.Units;

float dpFromMm = DimenPhysicalUnits.ToDpFromMm(10f, Resources);
float pxFromCm = DimenPhysicalUnits.ToPxFromCm(2f, Resources);
float spFromInch = DimenPhysicalUnits.ToSpFromInch(0.25f, Resources);

Also: MmToCm, RadiusFromDiameter, RadiusFromCircumference, etc.

Resize helpers

Com.Appdimens.Dynamic.Code.Resize.DimenResize / DimenResizeKt expose auto-resize utilities (text size, square size, bounds). Compose-oriented variants may reference Composer; for .NET, check generated members or follow upstream DOCUMENTATION/resize.md.

Cache and configuration

Com.Appdimens.Dynamic.Core.DimenCache:

Persistence uses AndroidX DataStore; this NuGet pulls Xamarin.AndroidX.DataStore.Preferences (required at runtime for DimenCache).

Jetpack Compose (com.appdimens.dynamic.compose)

The AAR ships Compose extensions (DimenSdpKt, DimenAutoKt, autoResizeTextSp, …) that take androidx.compose.runtime.Composer. With the current class-parse binding pipeline, many Compose helpers are not practical from C# (missing or incomplete Composer wrappers).

Use this package for:

• Com.Appdimens.Dynamic.Code — Activities, Fragments, custom View measurement, MAUI Android handlers
• Com.Appdimens.Dynamic.Core / Common — cache, qualifiers, shared types

Compose-first apps on .NET may need a future binding strategy or shared logic called from Kotlin.

Dependencies brought in by this package

Package version vs embedded AAR

When Maven publishes 3.5.1, run ./scripts/sync-aar-from-maven.sh 3.5.1 and align the fourth NuGet segment as needed.

Build this binding locally

cd appdimens-dynamic-net-binding
dotnet build AppDimens.Dynamic.sln -c Release

Optional smoke APK: AppDimens.Dynamic.SmokeTest. See NUGET-PUBLISH.md.

Sync the upstream AAR:

./scripts/sync-aar-from-maven.sh 3.1.5

Links

License

Apache 2.0, consistent with the upstream library.