app_deutschlandticket_kivy_test/README.md

Universal Deutschlandticket App

This app should display AZTEC Codes asknow by train tickets and show some "security stuff" like animated artwork like a deutschlandticket logo.

Viele Zugbegleiter und Busfahrer akzeptieen zum Beispiel das Deutschlandticket nicht als Screenshot eines Aztec Code, sondern nur, wenn es sich scrollen lässt. Idealerweise noch im zusammenspiel einer animierten Grafik. Dabei wird oft der Code nicht einmal gescannt.

Ziel dieser App ist es, eine trackingfreie Alternative zu den ganzen Deutschlandticket Apps zu schaffen, die jeden beliebigen Aztec Code Akzeptiert.

Du hst dein Deutschlandticket nur als PDF und nicht als App? Kein Problem, mit dieser Deutschlandticket App digitalisieren wir ein Foto des Aztec Codes und du hast nun ein digitales Handyticket, das sich scrollen lässt. Du hast zwar ein ICE Ticket, willst aber Deutschlandticket fahren? Kein Problem. Lade dein ICE Ticket in diese Deutschlandticket App und genieße die verwunderten Blicke beim kontrollieren deines Tickets.

We use kivy as App Development Framework.

Since a fe weeks forgejo/gitea have implemented github actions. And we use them to build the app.

Setup local Development

For local app development, be inspired by this setup:

Venv and Requirements

python3 -m venv  app
source app/bin/activate
pip install -r requirements.txt

Install kivy

git clone https://github.com/kivy/kivy.git
cd kivy
sudo apt install mesa-common-dev
sudo apt install libglu1-mesa-dev freeglut3-dev
python3.11 -m pip install cython
python3.11 setup.py build_ext --inplace
make install

Build Pipeline

Bulldozer building

There is a Github Action for building kivy apps for android using bulldozer. We mirrored the app to https://backwesen.de/actions/gh-buildozer-action and use it successfully for building our app.

Releasing

Sadly gitea/forgejo does not support artifacts jet. So we have multiple different options for releasing our build binarys. Publishing them to other servers, put them in a new git repo or maybe there is a fancy way to attatch them to a release. For now we skipped this option and waiting for artifacts to become available. In the meantime we use https://transfer.sh/ for uploading our files quick and dirty.