MyFuel - Android App

Natywna aplikacja na system Android stworzona w języku Java. MyFuel to podręczne narzędzie ułatwiające kierowcom szybkie obliczanie kosztów podróży na podstawie średniego spalania, dystansu oraz aktualnej ceny paliwa.

🚀 Główne funkcjonalności

• Kalkulator Kosztów Przejazdu: Główny moduł aplikacji pozwalający na precyzyjne wyliczenie całkowitego kosztu trasy. Algorytm wykorzystuje wzór: (spalanie * dystans / 100) * cena_paliwa i prezentuje wynik z zaokrągleniem do dwóch miejsc po przecinku.
• Boczne Menu Nawigacyjne (Navigation Drawer): Wygodna i nowoczesna nawigacja pozwalająca na przełączanie się między widokami: Home, Calculator oraz Settings.
• ViewBinding: Aplikacja wykorzystuje mechanizm ViewBinding do bezpiecznej i wydajnej komunikacji między kodem Javy a layoutami XML.
• Architektura MVVM: Projekt zorganizowany z podziałem na warstwy widoku (Fragments) oraz logiki prezentacji (ViewModels).

🛠️ Stack technologiczny

• Język: Java 1.8
• Platforma: Android SDK (Compile: 34, Target: 33, Min: 33)
• UI & Nawigacja: - AndroidX AppCompat & ConstraintLayout
  • Material Design Components
  • AndroidX Navigation Component (Fragment & UI)
• Cykl życia aplikacji: LiveData & ViewModel KTX
• Zarządzanie budowaniem: Gradle (skrypty w języku Kotlin - build.gradle.kts)

⚙️ Wymagania wstępne

Aby skompilować i uruchomić ten projekt w środowisku deweloperskim, potrzebujesz:

• Android Studio (wersja Flamingo / Giraffe lub nowsza).
• Zainstalowanego Android SDK w wersji co najmniej 34.
• Urządzenia fizycznego lub emulatora z systemem Android 13 (API Level 33) lub nowszym.

💻 Uruchomienie lokalne

1. Sklonuj repozytorium:

   git clone <link-do-repozytorium>

2. Otwórz projekt: Uruchom Android Studio, wybierz opcję Open an existing project i wskaż folder z pobranym repozytorium.
3. Synchronizacja Gradle: Poczekaj, aż Android Studio pobierze niezbędne zależności i zsynchronizuje pliki build.gradle.kts.
4. Zbuduj i uruchom: Wybierz docelowe urządzenie (emulator lub podpięty telefon) z górnego paska narzędzi i kliknij zielony przycisk Run (lub użyj skrótu Shift + F10).

🏗️ Struktura projektu

Najważniejsze elementy kodu źródłowego:

• pl.darsonn.myfuel.MainActivity - Główny kontener aplikacji zarządzający paskiem nawigacyjnym.
• pl.darsonn.myfuel.ui.calculator.CalculatorFragment - Fragment odpowiadający za logikę wprowadzania danych i wyliczania kosztu podróży.
• res/layout/ - Pliki XML definiujące interfejs użytkownika.
• res/values/strings.xml - Główne zasoby tekstowe aplikacji.