MunichWays App

Mobile App displaying the Radlvorangnetz in Flutter for iOS and Android. For more information see: munichways.de

Development Setup

Setup Git hooks for formatting

The build server checks if all files are formatted correctly with dart format. If not it will fail. To ensure that the formatter is run locally before a commit set the hooksPath property: git config --local core.hooksPath ./githooks

Release

• change version in code pubspec.yaml and commit to master as "Bump version to 2.0.2+26"
• commit and push

iOS

• flutter build ios
• in XCode Procuct -> Archive

Screenshots

• 6,5" - iPhone 12 Pro Max
• 5,5" - iPhone 8 Plus
• iPad - iPadPro (12.9-inch)

Android

Github Actions

• tag current state and push the tags
  • git tag -a 0.0.3+5 -m "0.0.3+5"
  • git push --tags
• this will trigger the workflow, see workflows/android-release

Local

1. Get release.keystore from Sven and place it in android/app/
2. Get Credentials for keystore from Sven and add them to android/release_keystore.properties:

# Do not add to version control!
# This contains the credentials to sign the android app and should only be on your local machine
# or the build server
storePassword=<Password>
alias=<Alias>
aliasPassword=<Password>

3. Run flutter build apk or see the other output options

How to test

• Handy per USB Kabel anschließen
• Voraussetzung Handy einrichten: Einstellungen > Entwickleroptionen > USB-Debugging aktivieren
• im Android Studion erscheint das USB Symbol bei physical device- z.B Samsung Sm F711B
• im Visual Studio code App starten: Button run (grüner Pfeil) oder flutter run -v C:\Users\Thomas\dev\flutter\munich-ways-app> flutter run -v

---

How to change code

Code Änderung mit Android Studio

• Android Studion starten
• Handy anschließen, siehe oben
• unten rechts auf den aktuellen Branch klicken
• ggf. auf Master klicken und mit "Update" die neueste Version holen
• im Scrumboard issue auswählen oder anlegen und die Nummer merken
• auf Master klicken und "New branch from selected" klicken
• Branchname _
• Stelle suchen und ändern
• oben rechts auf den grünen Run button klicken
• bei Fehlern ist ggf. ist ein flutter ubgrade nötig (Sven fragen)
• Änderung am Handy testen
• Links in "Change" geänderte Dateien auswählen, darunter eine kurze Commit Nachricht eingeben und unten auf "Commit and Push" klicken
• push mit Token wählen, ggf. Token erneuern wenn abgelaufen in github neuen Token generieren
• Wenn gepushed gehe im Browser zu github pulls: https://github.com/MunichWays/munich-ways-app/pulls
• Pull request für den Branch anstoßen, geht an Sven zum Review