ecoo

https://www.ecoo.ch/de/

Setup

Setup Flutter

• install flutter https://flutter.dev/docs/get-started/install (install android studio for android sdk and xcode for ios)

• Install the VS code flutter extension

• Run flutter doctor (View > Comand Palett.. Flutter: Run Flutter Doctor) and resolve all issues.

• To Connect a device run flutter emulators which will list all available emulators. Then choose flutter emulators --launch EMULATOR NAME the selected device is displayed in the VS Code status bar (blue at bottom) and can be changed there (download Android Studios / Xcode for emualtors/simulators)

• Go to debugger to run the app (create a launch config file an select dart & flutter)

see section Run the app for help: https://flutter.dev/docs/get-started/test-drive?tab=vscode

• install vscode-flutter-i18n-json: i18n generation https://github.com/esskar/vscode-flutter-i18n-json

Development

• (run flutter pub get to install the dependencies) is run automagically

• Go to debugger to run the app (hotreload)

• run make watch_generate_code to generate injectables

• use @Environment(Env.mock) to annotate mock classes. Use @Environment(Env.dev) to annotate dev classes. Use @Environment(Env.prod) to annotate prod classes.

add translation:

• add the translation to the translation files (i18n > [lang].json)
• update the generated translations by opening the VSC command palette and use Flutter I18n Json: Update

code organisation:

• most of the code is in ui. screens for ui specific logic (views and view models). core for shared logic (services).

• business contains entities.

• data contains repositories.

Branching Strategy

This repository uses the GitLab Flow branching strategy. All branches should be created from master. Create feature or release branches.