Skip to content

MODULES.md

Latest commit

 

History

History
73 lines (56 loc) · 4.26 KB

MODULES.md

File metadata and controls

73 lines (56 loc) · 4.26 KB
Raw

AppDimens Dynamic — Gradle / Maven modules (3.1.8)

Module graph

app (demo)
 ├── library                      → io.github.bodenberg:appdimens-dynamic
 ├── library-bom                  → …:appdimens-dynamic-bom
 ├── library-auto                 → …:appdimens-dynamic-auto
 ├── library-density              → …:appdimens-dynamic-density
 ├── library-diagonal             → …:appdimens-dynamic-diagonal
 ├── library-fill                 → …:appdimens-dynamic-fill
 ├── library-fit                  → …:appdimens-dynamic-fit
 ├── library-fluid                → …:appdimens-dynamic-fluid
 ├── library-interpolated         → …:appdimens-dynamic-interpolated
 ├── library-logarithmic          → …:appdimens-dynamic-logarithmic
 ├── library-percent              → …:appdimens-dynamic-percent
 ├── library-perimeter            → …:appdimens-dynamic-perimeter
 ├── library-power                → …:appdimens-dynamic-power
 ├── library-resize               → …:appdimens-dynamic-resize
 └── library-units                → …:appdimens-dynamic-units

Satellites depend only on :library (api(project(":library"))).

Android Gradle namespace values are unique per module (com.appdimens.dynamic for the principal, com.appdimens.dynamic.<strategy> for satellites). Kotlin packages remain com.appdimens.dynamic.* as before.

Artifacts

Artifact Contents
appdimens-dynamic common, core, scaled, plain
appdimens-dynamic-<strategy> code.<strategy> + compose.<strategy>
appdimens-dynamic-bom Version constraints for the set above (java-platform)

All published coordinates share appdimens.version in gradle.properties (3.1.8). Kotlin packages are unchanged since 3.1.6.

Installation

dependencies {
    implementation(platform("io.github.bodenberg:appdimens-dynamic-bom:3.1.8"))
    implementation("io.github.bodenberg:appdimens-dynamic")
    implementation("io.github.bodenberg:appdimens-dynamic-percent")
}

Without the BOM, pin the same version on each coordinate. See README — Installation.

Core layout

  • The source of truth is the immutable DimenMetrics window snapshot (size, density, font scale, orientation, ui mode, multi-window). Shared screen metrics (scale, aspect ratio, density) are derived from it once per snapshot.
  • Event-driven config watcher (ensureConfigWatcher): A ComponentCallbacks2 listener registered on the Application invalidates fast slots synchronously on any real configuration change — replaces the sampled validationTick (1-in-16).
  • Specialized kernels: resolveSdpPx, resolveSdpDp, resolveSdpaPx, resolveSdpaDp, resolveHdpPx, resolveHdpDp, resolveWdpPx, resolveWdpDp — one kernel per family/qualifier, zero branches, volatile load + identity compare + legacy multiply order.
  • fastMetricsForCode: Non-Compose fast-lane resolution — skips the ThreadLocal probe entirely.
  • DimenMetrics eager AR: normalizedAspectRatio and logNormalizedAspectRatio changed from lazy to plain val — removes the hidden synchronized probe from the SDPA fast lane.
  • Strategy-specific scales (diagonal, power, logarithmic, interpolated, perimeter) are derived lazily from DimenCache.currentMetrics at resolution time — no process-global pre-computation. StrategyFactorRegistry remains as a source-compatibility hook.
  • CalcType ordinals live in core so cache keys stay stable across modules.

Migration from 3.1.5 (modularization baseline)

3.1.5 3.1.6
Single appdimens-dynamic AAR with every strategy Principal = scaled + core; add one satellite per extra strategy
Version on each dependency Optional platform("…:appdimens-dynamic-bom:3.1.6")

3.1.6 → 3.1.8: no packaging or API changes — internal cache/correctness rework + specialized kernels (see README — What's New).

See also