diff --git a/README.md b/README.md index 234fa72..a0c58b4 100644 --- a/README.md +++ b/README.md @@ -38,11 +38,42 @@ Die App ist für die tägliche Baustellennutzung optimiert. Sie speichert Eingab Die APK wird über die Releases dieses Repositorys bereitgestellt. -1. Neuestes Release öffnen. -2. APK-Datei herunterladen. -3. APK auf dem Android-Gerät installieren. -4. Falls Android nachfragt, Installation aus dieser Quelle erlauben. -5. App öffnen und Serveradresse einrichten. +### APK herunterladen + +1. Auf dem Android-Gerät dieses Repository öffnen: + `https://git.bahmcloud.de/bahmcloud/bc-erp-android-releases` +2. Oben oder rechts den Bereich `Releases` öffnen. +3. Das neueste Release wählen, zum Beispiel `BC-ERP Android 1.0.11`. +4. Unter `Assets` die Datei `BC-ERP-Android-.apk` herunterladen. +5. Nach dem Download die APK über die Download-Meldung, die Dateien-App oder den Browser-Download öffnen. + +### Installation aus unbekannter Quelle erlauben + +Da die App nicht über den Play Store installiert wird, fragt Android beim ersten Installieren nach einer Freigabe. + +Je nach Gerät heißt die Einstellung zum Beispiel: + +- `Aus dieser Quelle zulassen` +- `Unbekannte Apps installieren` +- `Installation unbekannter Apps erlauben` + +Vorgehen: + +1. APK öffnen. +2. Wenn Android blockiert, `Einstellungen` antippen. +3. Für den verwendeten Browser oder Dateimanager `Aus dieser Quelle zulassen` aktivieren. +4. Zurück zur APK gehen. +5. `Installieren` antippen. + +Nach der Installation kann die Freigabe bei Bedarf wieder deaktiviert werden. Für spätere Updates muss sie eventuell erneut erlaubt werden. + +### Erster App-Start + +1. BC-ERP öffnen. +2. Serveradresse eintragen. +3. Mit Benutzerkonto anmelden. +4. Im Profil den Monteur prüfen oder auswählen. +5. Einmal `Sync` ausführen, damit Projekte und Monteure lokal verfügbar sind. Die App prüft neue Releases automatisch. Wenn eine neuere APK verfügbar ist, wird sie heruntergeladen und anschließend zur Installation angeboten. @@ -52,6 +83,18 @@ Wichtig: - Die App installiert Updates nicht heimlich. Android zeigt vor der Installation eine Bestätigung an. - Die Serveradresse wird beim ersten Start gesetzt und kann später über `Serveradresse ändern` neu gesetzt werden. +### Update installieren + +Wenn die App ein Update findet: + +1. Download abwarten. +2. Android-Benachrichtigung zum heruntergeladenen Update antippen. +3. Falls Android die Installation blockiert, Installation aus dieser Quelle erlauben. +4. Update installieren. +5. App wieder öffnen. + +Die bestehenden lokalen App-Daten bleiben bei einem normalen Update erhalten. Bei einer kompletten Neuinstallation müssen Serveradresse und Login neu gesetzt werden. + ## Erster Start: Serveradresse einrichten Beim ersten Start fragt die App nach der Backend-Adresse. Diese Adresse verbindet die Android-App mit dem BC-ERP Server. diff --git a/docs/android-app/01-server-setup.png b/docs/android-app/01-server-setup.png index a72671c..2a03e31 100644 Binary files a/docs/android-app/01-server-setup.png and b/docs/android-app/01-server-setup.png differ diff --git a/docs/android-app/02-login.png b/docs/android-app/02-login.png index b971145..f35f04e 100644 Binary files a/docs/android-app/02-login.png and b/docs/android-app/02-login.png differ