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, Key (z.B. meine-app), Typ: Code 3. Erstellen

2. GitHub-Repo verknüpfen

ℹ️ FlawDesk legt keine Repos auf GitHub für dich an. Du erstellst das Repo selbst und FlawDesk verknüpft sich damit.

1. GitHub-Token hinterlegen: Workspace-Settings → Tab GitHub → Personal Access Token mit repo-Scope eintragen 2. Repo auf GitHub anlegen: github.com/new → Owner, Name, public/private → "Create repository" 3. In FlawDesk verbinden: Projekt → ⚙️ → Tab Code → Sektion GitHub-Repo → Owner + Repo-Name → Speichern

3. Android-Modul konfigurieren

1. Projekt → ⚙️ → Tab Code → + 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.