mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-09-15 14:48:34 -04:00
James Rich
0a78a2755c
core:di has no expect declarations, just the target. core:resources' getString() (blocking, runBlocking-based) can't exist on wasmJs -- split to expect/actual: a real nonWebMain actual (android/jvm/iOS, same hierarchy-split pattern as core:ble) and a wasmJsMain actual that fails loudly (there is no way to synchronously block on wasmJs; callers on web must use the already-suspend getStringSuspend() instead). Renamed the nonWebMain actual file to GetStringActuals.kt to avoid a JVM facade-class name collision with commonMain's GetString.kt (both would otherwise generate an identical GetStringKt class). core:model's two expect declarations (getShortDateTime, platformRandomBytes) get wasmJs actuals backed by Intl.DateTimeFormat and the Web Crypto API's getRandomValues() -- platformRandomBytes backs channel PSK/private-key generation, so it must be cryptographically secure, never Math.random(). Third-party dependencies (takpacket-sdk 0.9.1, compose components-resources 1.12.0) confirmed to publish a wasmJs variant via their real Gradle Module Metadata before enabling the target. Verified via gradle-runner: compileKotlinWasmJs passes for all three, full regression (android/jvm/iOS compiles, allTests, detekt, spotlessCheck) passes across every touched module.
:core:model (Meshtastic Domain Models)
Overview
The :core:model module is a Kotlin Multiplatform (KMP) library containing the domain models and data classes used throughout the application and its API. These models are platform-agnostic and designed to be shared across Android, JVM, and future supported platforms.
Multiplatform Support
Models are plain commonMain Kotlin types — @Serializable (kotlinx.serialization) data classes and
@JvmInline value classes — with no Android Parcelable dependency, so they are shared verbatim
across Android, JVM, and iOS.
Key Models
DataPacket: Represents a mesh packet (text, telemetry, etc.).Node: Contains detailed information about a node (position, SNR, battery, etc.).NodeAddress/ContactKey: Type-safe node addressing (Broadcast/Local/ByNum/ById) and contact-key parsing, replacing stringly-typed"^all"/"!hex"handling.DeviceHardware: Represents supported Meshtastic hardware devices and their capabilities.Channel: Represents a mesh channel configuration.
Usage
This module is a core dependency of most feature modules.
// In commonMain
implementation(projects.core.model)
Structure
commonMain: Contains the majority of domain models and logic.androidMain: Contains Android-specific utilities and implementations forexpectdeclarations.androidUnitTest: Contains unit tests that require Android-specific features (likeParceltesting via Robolectric).
Dependency Graph
graph TB
:core:model[model]:::kmp-library
:core:model --> :core:common
:core:model --> :core:resources
:core:model -.-> :core:testing
classDef android-application fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;
classDef android-application-compose fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;
classDef compose-desktop-application fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;
classDef android-feature fill:#FFD6A5,stroke:#000,stroke-width:2px,color:#000;
classDef android-library fill:#9BF6FF,stroke:#000,stroke-width:2px,color:#000;
classDef android-library-compose fill:#9BF6FF,stroke:#000,stroke-width:2px,color:#000;
classDef android-test fill:#A0C4FF,stroke:#000,stroke-width:2px,color:#000;
classDef jvm-library fill:#BDB2FF,stroke:#000,stroke-width:2px,color:#000;
classDef kmp-feature fill:#FFD6A5,stroke:#000,stroke-width:2px,color:#000;
classDef kmp-library-compose fill:#FFC1CC,stroke:#000,stroke-width:2px,color:#000;
classDef kmp-library fill:#FFC1CC,stroke:#000,stroke-width:2px,color:#000;
classDef unknown fill:#FFADAD,stroke:#000,stroke-width:2px,color:#000;