DE EN
Android & Play Store › Android-App-Projekt anlegen

Android-App-Projekt anlegen — von Repo bis APK

Diese Anleitung führt komplett durch: FlawDesk-Projekt anlegen → GitHub-Repo verknüpfen → Android-Modul konfigurieren → ersten APK-Build auslösen.

Voraussetzungen

1. FlawDesk-Projekt anlegen

1. Sidebar → + Neues Projekt 2. Name, Projekttyp: FlawDesk Code 3. Erstellen

2. GitHub-Repo verknüpfen

ℹ️ FlawDesk verknüpft sich mit einem GitHub-Repository — bestehend oder neu. Wie du die FlawDesk App bei GitHub installierst, steht ausführlich unter GitHub verbinden.

1. FlawDesk App installieren (einmalig): Zahnrad in der Sidebar → Einstellungen → Tab GitHub → FlawDesk App installieren, bei GitHub die Repositories freigeben 2. In FlawDesk verbinden: Projekt → ⚙️ → Tab FlawDesk Code → Sektion Quelle → FlawDesk App → Installation und Repository wählen oder + Neues Repo anlegen → Speichern

3. Android-Modul konfigurieren

1. Projekt → ⚙️ → Tab FlawDesk Code → Module → Modul hinzufügen 2. Felder:

  • Modul-Key: z.B. app
  • Typ: android-app
  • Pfad im Repo: meist . (Repo-Root)

3. Speichern

FlawDesk erkennt automatisch ob es eine Capacitor-App oder eine Native-Android-App ist.

4. Tab "Android" konfigurieren

  • App-ID (Package-Name): z.B. com.deinedomain.app
  • App-Name: Anzeige-Name auf dem Gerät
  • Keystore: hochladen oder von FlawDesk generieren lassen
⚠️ Der Keystore ist dein einziger Weg, App-Updates zu signieren. Backup machen — Verlust bedeutet neue App-ID.

5. Workflow-File ins Repo schreiben

1. Projekt → ⚙️ → Tab Workflow 2. FlawDesk zeigt den Diff zwischen Repo und Template 3. "Anlegen pushen" klicken → FlawDesk legt .github/workflows/android-build.yml an

6. Ersten Build auslösen

1. NavRail → Raketen-Icon (Deployment-Tab) 2. Android-Modul auswählen 3. Version-Name (z.B. 0.1.0), Version-Code (z.B. 1), Track (internal) 4. Build starten

Build läuft typischerweise 5–8 Minuten. Log ist in FlawDesk unter Deployment → Build-History einsehbar.

Häufige Probleme

"Keystore alias mismatch" — im Tab Android → Sektion Keystore → Alias korrigieren → Speichern.

"PLAY_SERVICE_ACCOUNT_JSON-Secret fehlt" — Service-Account-JSON neu hochladen in Tab Android.

Build hängt bei "queued" — GitHub Actions ausgelastet oder Minuten-Kontingent überschritten. GitHub → Settings → Billing prüfen.