From 60d994bca7002494b6a9c8fc8ae91c53bde2804b Mon Sep 17 00:00:00 2001 From: plush2408 Date: Tue, 18 Jun 2024 02:15:30 +0200 Subject: [PATCH] Readme++ --- README.md | 71 ++++++++++++++++++- .../app_test.dart | 0 lib/screens/flippingcards.dart | 22 +++--- test_driver/integration_test.dart | 3 + 4 files changed, 81 insertions(+), 15 deletions(-) rename {test/integration_test => integration_test}/app_test.dart (100%) create mode 100644 test_driver/integration_test.dart diff --git a/README.md b/README.md index b12f599..88abf70 100644 --- a/README.md +++ b/README.md @@ -5,11 +5,78 @@ Die "Werwolf" Flutter App ist ein Projekt, das im Rahmen eines Gruppenprojekts v ## Funktionalitäten - **Anmeldungsfreier Zugang**: Spieler müssen sich nicht anmelden, sondern können direkt über ein Formular mit mehreren Feldern teilnehmen. -- **Spielerregistrierung**: Das Formular ermöglicht es Spielern, sich einzutragen, wobei eine beliebige Anzahl von Spielern möglich ist. (Ab 6 Spieler) +- **Spielerregistrierung**: Das Formular ermöglicht es Spielern, sich einzutragen, wobei eine beliebige Anzahl von Spielern möglich ist (ab 6 Spieler). - **Konfiguration der Spielrunde**: Vor Beginn des Spiels können Konfigurationen vorgenommen werden, wie die Anzahl und Art der speziellen Rollen im Spiel. - **Enthüllung der Rollen**: Nachdem alle Spieler eingetragen sind und die Konfigurationen abgeschlossen sind, wird der Name der ersten Person angezeigt. Durch Anklicken der Karte wird dann die Rolle dieser Person aufgedeckt. Dieser Vorgang wird für jede Person wiederholt, bis alle Spieler und ihre Rollen angezeigt wurden. - **Spielaktionen**: Die App bietet Funktionen, um den Tod von Spielern festzulegen und andere Spielaktionen durchzuführen. +## Plattformunterstützung und Tests +Die Applikation benutzt keine plattformspezifischen Funktionen oder Bibliotheken, sollte daher überall laufen. Wir haben die App unter folgenden Plattformen getestet: +- **Android** +- **iOS** +- **Web** + +### Besondere Hinweise zum Testen +- **Integrationstests**: Um die Integrationstests auszuführen, folge den untenstehenden Anweisungen zur Installation der Abhängigkeiten und zum Ausführen der Tests. +- **Zusätzliche Parameter für Build/Test**: Keine besonderen Parameter erforderlich. + +## Installation und Ausführung + +### Voraussetzungen +- Flutter SDK (Version >= 3.4.3) +- Abhängigkeiten in `pubspec.yaml` + +### Installation +1. Klone das Repository: + git clone https://gitty.informatik.hs-mannheim.de/2011708/cpd_David_und_Yusuf + +2. Wechsle in das Projektverzeichnis: + cd cpd_David_und_Yusuf + +3. Installiere die Abhängigkeiten: + flutter pub get + +### Ausführen der App +- **Android/iOS**: + flutter run + +- **Web**: + flutter run -d chrome + +## Tests + +### Unit- und Widget-Tests ausführen +flutter test + +### Integrationstests ausführen +1. Erstelle eine Datei `test_driver/integration_test.dart` mit folgendem Inhalt: + import 'package:integration_test/integration_test_driver.dart'; + + Future main() => integrationDriver(); + +2. Erstelle eine Datei `integration_test/app_test.dart` mit deinen Integrationstests (siehe vorherige Anweisungen). + +3. Führe den Integrationstest aus: + flutter drive --driver=test_driver/integration_test.dart --target=integration_test/app_test.dart + +### Shell-Skript zur Installation und Ausführung + +Füge folgendes Skript `run_app.sh` hinzu, um die App zu installieren und auszuführen: + +#!/bin/sh + +Klone das Repository +git clone https://gitty.informatik.hs-mannheim.de/2011708/cpd_David_und_Yusuf + +Wechsle in das Projektverzeichnis +cd cpd_David_und_Yusuf + +Installiere die Abhängigkeiten +flutter pub get + +Starte die App +flutter run + ## Gitty Repository Das Projekt wird auf Gitty von der Hochschule gehostet. Hier ist der Link zum Repository: [Gitty Repository](https://gitty.informatik.hs-mannheim.de/2011708/cpd_David_und_Yusuf) @@ -17,4 +84,4 @@ Das Projekt wird auf Gitty von der Hochschule gehostet. Hier ist der Link zum Re ## Kontakt Für Fragen, Feedback oder Unterstützung kontaktieren Sie bitte: - Yusuf Can Özdemirkan, 1813055: yusufcan.oezdemirkan@stud.hs-mannheim.de -- David Miller, 2011708: 2011708@stud.hs-mannheim.de \ No newline at end of file +- David Miller, 2011708: 2011708@stud.hs-mannheim.de diff --git a/test/integration_test/app_test.dart b/integration_test/app_test.dart similarity index 100% rename from test/integration_test/app_test.dart rename to integration_test/app_test.dart diff --git a/lib/screens/flippingcards.dart b/lib/screens/flippingcards.dart index 4631baa..eff8940 100644 --- a/lib/screens/flippingcards.dart +++ b/lib/screens/flippingcards.dart @@ -7,7 +7,6 @@ import 'package:werwolf/screens/gameboard.dart'; import '../models/player.dart'; import '../models/role.dart'; -// FlipingCard is a StatefulWidget that takes a list of players as input class FlipingCard extends StatefulWidget { final List players; const FlipingCard({required this.players, super.key}); @@ -16,19 +15,17 @@ class FlipingCard extends StatefulWidget { State createState() => _FlipingCardState(); } -// State class for FlipingCard class _FlipingCardState extends State { - int index = 0; // Index to keep track of the current player + int index = 0; - late FlipCardController _controller; // Controller for the flip card + late FlipCardController _controller; @override void initState() { super.initState(); - _controller = FlipCardController(); // Initialize the flip card controller + _controller = FlipCardController(); } - // Method to render the content of the flip card _renderContent(context) { return Card( elevation: 0.0, @@ -59,7 +56,7 @@ class _FlipingCardState extends State { ), ), const Text( - 'Click to see your role!', + 'Klick um deine Rolle zu sehen!', textAlign: TextAlign.center, ), ], @@ -127,14 +124,14 @@ class _FlipingCardState extends State { onPressed: () { setState(() { if (index > 0 && index <= widget.players.length) { - index--; // Go to the previous player + index--; if (!_controller.state!.isFront) { _controller.toggleCardWithoutAnimation(); } } }); }, - child: const Text("Back"), + child: const Text("Zurück"), ), ), Flexible( @@ -142,12 +139,11 @@ class _FlipingCardState extends State { onPressed: () { setState(() { if (index >= 0 && index < widget.players.length - 1) { - index++; // Go to the next player + index++; if (!_controller.state!.isFront) { _controller.toggleCardWithoutAnimation(); } } else if (index == widget.players.length - 1) { - // Navigate to the game board if it's the last player Navigator.push( context, MaterialPageRoute( @@ -159,8 +155,8 @@ class _FlipingCardState extends State { }); }, child: Text(index != widget.players.length - 1 - ? "Next Player" - : "Start Game!"), + ? "Nächster Spieler" + : "Spiel anfangen!"), ), ), ], diff --git a/test_driver/integration_test.dart b/test_driver/integration_test.dart new file mode 100644 index 0000000..b38629c --- /dev/null +++ b/test_driver/integration_test.dart @@ -0,0 +1,3 @@ +import 'package:integration_test/integration_test_driver.dart'; + +Future main() => integrationDriver();