How labexp/osmtracker-android works
Project type and purpose
• This is a native Android mobile application (“OSMTracker for Android™”) whose primary purpose is to record GPS tracks, allow users to drop POIs (via buttons, voice, photos, text), persist them in a local GPX-compatible SQLite database, and optionally upload to the OpenStreetMap™ server.
File structure
• app/src/main/java/net/osmtracker/activity – Presentation layer: Android Activities and Adapters for UI screens (track list, map, track logger, preferences, etc.).
• app/src/main/java/net.osmtracker/db – Persistence layer: DataHelper, SQLiteOpenHelper (DatabaseHelper), ContentProvider (TrackContentProvider), model classes (Track, WayPoint, TrackPoint).
• app/src/main/java/net.osmtracker/gpx – Domain logic for exporting GPX tracks to storage, zipping, temporary files.
• app/src/main/java/net.osmtracker/osm – Integration with OSM server: HTTP upload tasks, REST constants.
• app/src/main/java/net.osmtracker/layout – Custom‐buttons and layout download code, XML parsers, network tasks for layout files.
• app/src/main/java/net.osmtracker/util – Utility classes (file system, projections, URL creation, theme validation).
• app/src/main/java/net.osmtracker/view – Custom Views and dialogs.
• Configuration & CI: fastlane, GitHub Actions, Travis, Transifex config appear but are orthogonal to runtime architecture.
README
• Confirms it is a GPS-tracking app for mappers/hikers.
• Mentions GPX, custom button layouts, voice/picture/note POIs, OSM upload.
Be very detailed—capture every essential architectural element
• Sensors / media capture as separate subcomponents.
• If desired, annotate lifecycle triggers (e.g., “onCreate → bindService”).