mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-05-12 08:42:01 -04:00
62e2c731b0
Brownfield gap remediation across multiple modules: Constitution violation fixes: - Replace hardcoded strings in Contacts.kt with stringResource() - Add KDoc to ConnectionActionButtonStyle enum values - Add missing string resources to strings.xml Build-logic fix: - Override javaLauncher for test tasks to JDK 21, fixing JVM class version mismatch when published modules target JVM 17 New test coverage: - core/model: NodeTest, DataPacketTest, MeshDataMapperTest - core/database: ConvertersTest, QuickChatActionDaoTest, DatabaseManagerWithDbRetryTest - core/service: ServiceRepositoryImplTest, DirectRadioControllerImplTest - core/network: HeartbeatSenderTest, MQTTRepositoryImplTest - core/data: MeshRouterImplTest - core/ble: KableBleConnectionTest - feature/node: MetricsViewModelTest (CSV), CompassViewModelTest, NodeDetailViewModelTest (remote admin) - feature/map: BaseMapViewModelTest (waypoint expiration) - feature/settings: SettingsViewModelTest (saveDataCsv), RadioConfigViewModelTest (MQTT probe) - feature/firmware: WifiOtaTransportTest Test seams: - NodeDetailViewModel: add NodeDetailUiTextResolver - KableBleScanner: add filter behavior test seam Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
: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 in this module use the CommonParcelable and CommonParcelize abstractions from :core:common. This allows them to maintain Android Parcelable compatibility (via @Parcelize) while residing in commonMain and remaining accessible to non-Android targets.
Key Models
DataPacket: Represents a mesh packet (text, telemetry, etc.).NodeInfo: Contains detailed information about a node (position, SNR, battery, etc.).DeviceHardware: Represents supported Meshtastic hardware devices and their capabilities.Channel: Represents a mesh channel configuration.
Usage
This module is a core dependency of core:api and 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).
Module dependency graph
graph TB
:core:model[model]:::kmp-library
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;