Files
simple-notes-sync/docs/DEBUG_APK.md
inventory69 cf54f44377 docs(v1.8.1): comprehensive metadata & documentation update for F-Droid release
Complete overhaul of all metadata and documentation for v1.8.1:

F-Droid Critical:
- Fix broken umlauts in de-DE/10.txt changelog (für, hinzugefügt, aufgeräumt)
- Shorten de-DE/7.txt changelog for brevity
- Remove trailing newline from en-US/title.txt

Version & Accuracy:
- Update README badges (Android 7.0+) and footer (v1.8.1)
- Add widgets, sorting, parallel sync to highlights
- Fix APK names in workflows (removed "universal")
- Update cache action v3 → v4 in PR workflow
- Fix CONTRIBUTING.md filename references
- Update QUICKSTART guides (APK name, typo, Android version, docs links)

Feature Documentation:
- Update full_description.txt (both locales) - remove NEW/NEU labels, add v1.8.0+ features
- Major FEATURES.md update - add Views & Layout, Widgets sections, updated tech stack
- Add UPCOMING.md v1.7.0-1.8.1 as released sections
- Update DOCS.md roadmap references and dates to Feb 2026
- Create missing en-US changelogs 1.txt, 2.txt

Supplementary Fixes:
- Update BACKUP.md - add encryption docs, fix cross-references
- Add CHANGELOG.md reference links v1.2.1-v1.8.1 (15 missing)
- Fix DEBUG_APK.md duplicate header
- Rewrite fastlane/README.md with both locales and limits table
- Create SELF_SIGNED_SSL.de.md (full German translation)

Affects: 26 files across READMEs, docs/, fastlane/, workflows
2026-02-11 15:45:51 +01:00

2.9 KiB
Raw Permalink Blame History

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

# 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

Mit ADB (Empfohlen - sauberes Testing)

# 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:

# 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. 🙏