Barbu score is a Flutter app to fill scores during a Barbu card game (also known as Tafferan or King of heart).
This is a Flutter app so you need to install Flutter, like described in the doc.
You should also install fvm tool, as
described here
and get the Flutter version set in the .fvmrc file of the repo
with fvm use {barbu_score.version}
To get all dependencies and create generated files run these commands:
fvm flutter pub get
fvm dart run build_runner build
Translations are generated with this commands, or automatically if the app is running. However, if you just want to generate new strings, run this:
fvm flutter gen-l10n
If you don't want to contribute and just want to play, you can download the app in PlayStore.
If you notice something you would like to change, feel free to fill an issue or open a Pull request. Please explain why you want this changes so that I can understand your changes.
Every changes should be tested. Before pushing, please check fvm flutter test result is OK.
A Github action also runs on each PR to check tests status.
Code coverage can be monitored with lcov. This tool can be installed
with sudo apt-get install lcov -y. To generate code coverage files, use these commands :
fvm flutter test --coverage
genhtml coverage/lcov.info -o coverage/html
open coverage/html/index.html
Before releasing, the app needs to be tested on a real device with
fvm flutter build apk --release
fvm flutter install
App update can be tested with
fvm flutter build apk --release
adb install build/app/outputs/flutter-apk/app-release.apk
If everything is fine, the app bundle can be build
with fvm flutter build appbundle --obfuscate --split-debug-info="zigotote/barbu_score/debug"
and uploaded to PlayStore.
See Flutter deployment doc for more info.
/!\ If there is an alert "This appbundle has native code and you didn't imported debug symbols" in PlayStore
- Change the .aab extension to .zip
- extract it
- find debug symbols under the base/lib/ directory.
- Compress all of it to a zip file
- upload it in Play Store in Bundle Explorer -> Your version -> Downloads -> native debug symbols