meshtastic/Meshtastic-Android
1
0
Fork 0
mirror of https://github.com/meshtastic/Meshtastic-Android.git synced 2026-04-20 22:23:37 +00:00
Code Issues Projects Releases Packages Wiki Activity
Meshtastic-Android/app
History
Exact
James Rich 536b1eba1c feat(map): replace Google Maps + OSMDroid with unified Mapbox SDK in feature:map/androidMain 
Replace the dual flavor-specific map implementations (Google Maps in app/src/google,
OSMDroid in app/src/fdroid) with a single Mapbox Maps Compose SDK (v11.21.1)
implementation living in feature:map/androidMain.

- Add Mapbox Maven repo with MAPBOX_DOWNLOADS_TOKEN auth to settings.gradle.kts
- Add mapbox-maps-android, mapbox-maps-compose deps to feature/map/build.gradle.kts
- Remove Google Maps, osmdroid, osmbonuspack deps from app/build.gradle.kts and catalog
- Create unified MapScreen, MapViewModel, MapboxMapContent, GeoJsonConverters,
  EditWaypointDialog, InlineMap, NodeTrackMap, NodeMapScreen, TracerouteMap
- Wire all Local*Provider CompositionLocals in MainActivity to new implementations
- Delete ~8200 lines of flavor-specific map code across google/fdroid source sets
- Delete dead MapViewProvider interface from core:ui
- Keep LocalMapMainScreenProvider for KMP/Desktop compatibility boundary
- Fix FlavorModule.kt, KoinVerificationTest.kt for deleted modules
- Pass spotlessCheck + detekt with zero violations
2026-04-14 16:24:29 -05:00
..
src feat(map): replace Google Maps + OSMDroid with unified Mapbox SDK in feature:map/androidMain 2026-04-14 16:24:29 -05:00
build.gradle.kts feat(map): replace Google Maps + OSMDroid with unified Mapbox SDK in feature:map/androidMain 2026-04-14 16:24:29 -05:00
detekt-baseline.xml feat: Implement iOS support and unify Compose Multiplatform infrastructure (#4876) 2026-03-21 23:19:13 +00:00
google-services.json Enable parallel installation of debug and release builds (#3596) 2025-11-02 23:26:50 +00:00
proguard-rules.pro fix(proguard): disable shrinking for Compose animation classes (#5116) 2026-04-13 21:55:52 +00:00
README.md feat(wifi): introduce BLE-based WiFi provisioning for nymea-compatible devices (#4968) 2026-04-02 17:31:17 +00:00

README.md

:app

Overview

The :app module is the entry point for the Meshtastic Android application. It orchestrates the various feature modules, manages global state, and provides the main UI shell.

Key Components

1. MainActivity & Main.kt

The single Activity of the application. It hosts the shared MeshtasticNavDisplay navigation shell and manages the root UI structure (Navigation Bar, Rail, etc.).

2. MeshService

The core background service that manages long-running communication with the mesh radio. While it is declared in the :app manifest for system visibility, its implementation resides in the :core:service module. It runs as a Foreground Service to ensure reliable communication even when the app is in the background.

3. Koin Application

MeshUtilApplication is the Koin entry point, providing the global dependency injection container.

Architecture

The module primarily serves as a "glue" layer, connecting:

  • core:* modules for shared logic.
  • feature:* modules for specific user-facing screens.

Module dependency graph

graph TB
  :app[app]:::android-application
  :app -.-> :core:ble
  :app -.-> :core:common
  :app -.-> :core:data
  :app -.-> :core:database
  :app -.-> :core:datastore
  :app -.-> :core:di
  :app -.-> :core:domain
  :app -.-> :core:model
  :app -.-> :core:navigation
  :app -.-> :core:network
  :app -.-> :core:nfc
  :app -.-> :core:prefs
  :app -.-> :core:proto
  :app -.-> :core:service
  :app -.-> :core:resources
  :app -.-> :core:ui
  :app -.-> :core:barcode
  :app -.-> :core:takserver
  :app -.-> :feature:intro
  :app -.-> :feature:messaging
  :app -.-> :feature:connections
  :app -.-> :feature:map
  :app -.-> :feature:node
  :app -.-> :feature:settings
  :app -.-> :feature:firmware
  :app -.-> :feature:wifi-provision
  :app -.-> :feature:widget

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;