117 lines
2.9 KiB
Markdown
117 lines
2.9 KiB
Markdown
# Debug APK für Issue-Testing
|
||
|
||
Für Bug-Reports und Testing von Fixes brauchst du eine **Debug-APK**. Diese wird automatisch gebaut, wenn du auf speziellen Branches pushst.
|
||
|
||
## 🔧 Branch-Struktur für Debug-APKs
|
||
|
||
Debug-APKs werden **automatisch** gebaut für diese Branches:
|
||
|
||
| Branch-Typ | Zweck | Beispiel |
|
||
|-----------|-------|---------|
|
||
| `debug/*` | Allgemeines Testing | `debug/wifi-only-sync` |
|
||
| `fix/*` | Bug-Fixes testen | `fix/vpn-connection` |
|
||
| `feature/*` | Neue Features | `feature/grid-layout` |
|
||
|
||
**Andere Branches (main, develop, etc.) bauen KEINE Debug-APKs!**
|
||
|
||
## 📥 Debug-APK downloaden
|
||
|
||
### 1️⃣ Push zu einem Debug-Branch
|
||
|
||
```bash
|
||
# Neuen Fix-Branch erstellen
|
||
git checkout -b fix/my-bug
|
||
|
||
# Deine Änderungen machen
|
||
# ...
|
||
|
||
# Commit und Push
|
||
git add .
|
||
git commit -m "fix: beschreibung"
|
||
git push origin fix/my-bug
|
||
```
|
||
|
||
### 2️⃣ GitHub Actions Workflow starten
|
||
|
||
- GitHub → **Actions** Tab
|
||
- **Build Debug APK** Workflow sehen
|
||
- Warten bis Workflow grün ist ✅
|
||
|
||
### 3️⃣ APK herunterladen
|
||
|
||
1. Auf den grünen Workflow-Erfolg warten
|
||
2. **Artifacts** Section oben (oder unten im Workflow)
|
||
3. `simple-notes-sync-debug-*` herunterladen
|
||
4. ZIP-Datei entpacken
|
||
|
||
**Wichtig:** Artifacts sind nur **30 Tage** verfügbar!
|
||
|
||
## 📱 Installation auf Gerät
|
||
|
||
## 📱 Installation auf Gerät
|
||
|
||
### Mit ADB (Empfohlen - sauberes Testing)
|
||
```bash
|
||
# Gerät verbinden
|
||
adb devices
|
||
|
||
# Debug-APK installieren (alte Version wird nicht gelöscht)
|
||
adb install simple-notes-sync-debug.apk
|
||
|
||
# Aus dem Gerät entfernen später:
|
||
adb uninstall dev.dettmer.simplenotes
|
||
```
|
||
|
||
### Manuell auf Gerät
|
||
1. Datei auf Android-Gerät kopieren
|
||
2. **Einstellungen → Sicherheit → "Unbekannte Quellen" aktivieren**
|
||
3. Dateimanager öffnen und APK antippen
|
||
4. "Installieren" auswählen
|
||
|
||
## ⚠️ Debug-APK vs. Release-APK
|
||
|
||
| Feature | Debug | Release |
|
||
|---------|-------|---------|
|
||
| **Logging** | Voll | Minimal |
|
||
| **Signatur** | Debug-Key | Release-Key |
|
||
| **Performance** | Langsamer | Schneller |
|
||
| **Debugging** | ✅ Möglich | ❌ Nein |
|
||
| **Installation** | Mehrmals | Kann Probleme geben |
|
||
|
||
## 📊 Was zu testen ist
|
||
|
||
1. **Neue Features** - Funktionieren wie beschrieben?
|
||
2. **Bug Fixes** - Ist der Bug wirklich behoben?
|
||
3. **Kompatibilität** - Funktioniert auf deinem Gerät?
|
||
4. **Performance** - Läuft die App flüssig?
|
||
|
||
## 📝 Feedback geben
|
||
|
||
Bitte schreibe einen Kommentar im **Pull Request** oder **GitHub Issue**:
|
||
- ✅ Was funktioniert
|
||
- ❌ Was nicht funktioniert
|
||
- 📋 Fehler-Logs (adb logcat falls relevant)
|
||
- 📱 Gerät/Android-Version
|
||
|
||
## 🐛 Logs sammeln
|
||
|
||
Falls der App-Entwickler Debug-Logs braucht:
|
||
|
||
```bash
|
||
# Terminal öffnen mit adb
|
||
adb shell pm grant dev.dettmer.simplenotes android.permission.READ_LOGS
|
||
|
||
# Logs anschauen (live)
|
||
adb logcat | grep simplenotes
|
||
|
||
# Logs speichern (Datei)
|
||
adb logcat > debug-log.txt
|
||
|
||
# Nach Fehler filtern
|
||
adb logcat | grep -E "ERROR|Exception|CRASH"
|
||
```
|
||
|
||
---
|
||
|
||
**Danke fürs Testing! Dein Feedback hilft uns, die App zu verbessern.** 🙏
|