Mobile App

There is a mobile app available for Android and iOS. It’s a flutter application and the source code can be found at

https://github.com/wger-project/flutter

Building the app

Install flutter (the app currently uses the flutter version in .github/actions/flutter-common/action.yml)

https://docs.flutter.dev/get-started/install

2) Start a wger server. You can either run your own instance (see e.g. Development with docker) or use the test server:

URL: https://wger-master.rge.uber.space
username: user
password: flutteruser
API key: 31e2ea0322c07b9df583a9b6d1e794f7139e78d4

The db is reset every day, so feel free to edit or delete anything.

Start the application with flutter run or use your IDE

Please note that depending on how you run your emulator you will need to change the IP address of the server.

You can run the tests with the flutter test

Release process

The release process itself is automated with github actions and fastlane, however there are some manual steps involved to prepare the release:

Update flutter version

If we use a new version, update the version in .github/actions/flutter-common/action.yml

Dry-run release before uploading

We use fastlane to automate the release process. To test the that the update works, you can make a dry-run (needs the different

publishing keys available)

Increase build nr in pubspec.yaml (revert after the dry-run was successful): flutter pub run cider bump build
flutter build appbundle --release
bundle install
bundle update fastlane
bundle exec fastlane android test_configuration

It might be necessary to repeat these steps if upload_to_play_store returns any errors such as a missing title or similar.

Also note that if a language was added over the weblate UI, it might be necessary to set the correct language code:

https://support.google.com/googleplay/android-developer/answer/9844778?hl=en#zippy=%2Cview-list-of-available-languages

Trigger a release

The release process must be manually triggered on Github (clik on “run workflow”, use use x.y.z format for the version). This will set the given version in pubspec.yaml, create a tag, and bump the build number. The workflow will then build the app for the different platforms and upload the file to the Play Store as well as to a newly created release on Github.

https://github.com/wger-project/flutter/actions/workflows/make-release.yml

Merge pull requests

in the flathub repo: https://github.com/flathub/de.wger.flutter/compare/master…wger-project:de.wger.flutter:master
in the fork, sync master https://github.com/wger-project/de.wger.flutter

Update f-droid

It might be necessary to update the f-droid metadata. The metadata file for wger is located here:

https://gitlab.com/fdroid/fdroiddata/-/blob/master/metadata/de.wger.flutter.yml

Updating screenshots

There are different screenshots for the different platforms and languages. They are in fastlane/metadata/android/ and can be automatically generated. To do so, consult integration_test/README.md in the flutter repo.