Aby pobrać aplikację na swój telefon, trzeba zeskanować kod QR i postępować według instrukcji prezentowanych przez system. UWAGA, pierwsze uruchomienie aplikacji może zająć nieco dłużej.
Ten projekt to aplikacja mobilna napisana w Flutterze, która pobiera i wyświetla dane dotyczące planu lekcji dla danej szkoły. Wykorzystuje technikę web scrapingu do ekstrakcji informacji z witryny internetowej szkoły i prezentuje je w czytelnej formie użytkownikowi.
Aplikacja oferuje interfejs użytkownika umożliwiający wprowadzenie danych dotyczących nazwy klasy, nauczyciela, czy sali i ustawienie danego planu jako głównego. Ponadto daje możliwość ręcznej aktualizacji danych i tworzenia własnej szaty graficznej, dzięki strukturze open-source.
Aby uruchomić i korzystać z aplikacji, wymagane są następujące zależności:
- Flutter SDK
- Dart SDK
- Inne niezbędne zależności specyficzne dla Flutter'a (patrz
pubspec.yaml
)
Aby zainstalować projekt na swoim urządzeniu, wykonaj następujące kroki:
-
Sklonuj repozytorium projektu na swoje urządzenie:
git clone https://github.com/AdamPodymniak/PlanLekcjiElektronik.git
-
Przejdź do katalogu projektu:
cd NazwaProjektu
-
Zainstaluj wymagane zależności przy użyciu narzędzia
flutter
:flutter pub get
-
Skonfiguruj swój emulator urządzenia mobilnego lub podłącz urządzenie fizyczne do komputera.
-
Uruchom aplikację na swoim emulatorze lub urządzeniu:
flutter run
Alternatywnie, aby zbudować pliki binarne aplikacji, wykonaj:
flutter build <platforma>
Gdzie
<platforma>
to system operacyjny, na którym chcesz uruchomić aplikację (np.apk
,ipa
,macos
,windows
, itp.). -
Zainstaluj ją przy użyciu mając podłączone urządzenie do komputera:
flutter install
Jesteśmy otwarci na kontrybucje do projektu. Jeśli masz pomysły na ulepszenie aplikacji, naprawę błędów lub dodanie nowych funkcji, z przyjemnością przyjmiemy Twoje zgłoszenia. Aby przyczynić się do projektu, postępuj zgodnie z poniższymi krokami:
-
Sklonuj repozytorium projektu na swoje urządzenie:
git clone https://github.com/NazwaUzytkownika/NazwaProjektu.git
-
Przejdź do katalogu projektu:
cd NazwaProjektu
-
Utwórz nowy branch dla swojej kontrybucji:
git checkout -b moj_nowy_branch
-
Wprowadź swoje zmiany i poprawki w kodzie.
-
Wykonaj commit swoich zmian:
git commit -m "Opis wprowadzonych zmian"
-
Wyślij swoje zmiany do repozytorium:
git push origin moj_nowy_branch
-
Otwórz pull request na GitHubie, opisując swoje zmiany i cel kontrybucji.
Po złożeniu pull requesta zaczekaj na przegląd i feedback od członków zespołu. Po zaakceptowaniu, Twoje zmiany zostaną scalone z głównym branchem projektu.
Zachęcamy również do zgłaszania problemów (issues) w przypadku wykrycia błędów lub sugestii dotyczących ulepszeń. Dziękujemy za Twoją kontrybucję!
Po zainstalowaniu i skonfigurowaniu aplikacji możesz uruchomić ją na swoim urządzeniu mobilnym lub emulatorze.