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](https://kivy.org/) 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](https://backwesen.de/actions/gh-buildozer-action.git) 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.

## App Status:
THis app does not work. I did not manage to get the right permissions for android 13 and canceled the process.