Kiosk - Device Owner einrichten

Device Owner einrichten (Techniker-Anleitung)

Was ist Device Owner und warum brauchen wir das?

Die Kiosk-App kann sich automatisch aktualisieren (APK-Updates werden von unserem Server heruntergeladen). Normalerweise zeigt Android bei jeder Installation ein Bestätigungsfenster an — der Nutzer muss auf "Installieren" tippen.

Das Problem: Unsere Kiosk-Geräte haben oft keine Tastatur und keine Maus. Niemand kann den Dialog bestätigen, und das Update bleibt hängen.

Die Lösung: Wenn die App als Device Owner eingerichtet ist, darf sie Updates ohne Bestätigungsdialog installieren ("silent install"). Das Gerät aktualisiert sich dann komplett automatisch.

Voraussetzungen

• Windows-PC (oder Laptop) mit Internetzugang

• USB-Kabel (USB-A auf USB-C oder Micro-USB, je nach Gerät)

• Kiosk-Gerät (Sunmi oder vergleichbar) mit installierter Kiosk-App

• Das Gerät muss eingeschaltet und entsperrt sein

Schritt 1: ADB installieren (Windows)

ADB (Android Debug Bridge) ist ein Werkzeug, mit dem man Android-Geräte vom PC aus steuern kann.

1.1 Download

Lade die Android Platform Tools herunter:

Download SDK Platform-Tools for Windows

Klicke auf "Download SDK Platform-Tools for Windows" und akzeptiere die Lizenzbedingungen.

1.2 Entpacken

1. Erstelle den Ordner C:\adb\

2. Entpacke die heruntergeladene ZIP-Datei dorthin

3. Nach dem Entpacken sollte die Datei C:\adb\platform-tools\adb.exe existieren

1.3 PATH setzen (optional, aber empfohlen)

Damit du adb von überall in der Kommandozeile aufrufen kannst:

1. Drücke Windows-Taste, tippe "Umgebungsvariablen" und öffne "Systemumgebungsvariablen bearbeiten"

2. Klicke auf "Umgebungsvariablen..."

3. Unter "Systemvariablen" wähle "Path" und klicke auf "Bearbeiten..."

4. Klicke auf "Neu" und füge ein: C:\adb\platform-tools

5. Bestätige alle Dialoge mit OK

1.4 Testen

Öffne eine neue Eingabeaufforderung (Windows-Taste > cmd > Enter) und tippe:

adb version

Erwartete Ausgabe (Versionsnummer kann abweichen):

Android Debug Bridge version 1.0.41

Falls der Befehl nicht gefunden wird: Prüfe den PATH oder navigiere direkt zum Ordner:

cd C:\adb\platform-tools
adb version

Schritt 2: USB-Debugging am Kiosk aktivieren

2.1 Entwickleroptionen freischalten

1. Öffne die Android-Einstellungen auf dem Kiosk-Gerät

2. Gehe zu "Über das Gerät" (oder "Über das Telefon")

3. Tippe 7 Mal schnell auf "Build-Nummer"

4. Es erscheint eine Meldung: "Du bist jetzt Entwickler"

Sunmi-Hinweis: Bei Sunmi-Geräten findest du die Build-Nummer unter Einstellungen > Über das Gerät > Build-Nummer. Falls dort ein Passwort verlangt wird, kontaktiere den Sunmi-Support.

2.2 USB-Debugging aktivieren

1. Gehe zurück zu den Android-Einstellungen

2. Öffne "Entwickleroptionen" (sollte jetzt sichtbar sein)

3. Aktiviere "USB-Debugging"

4. Bestätige die Sicherheitsabfrage mit OK

Schritt 3: Kiosk per USB verbinden

1. Verbinde das Kiosk-Gerät per USB-Kabel mit dem Windows-PC

2. Auf dem Kiosk-Gerät erscheint ein Dialog: "USB-Debugging erlauben?"

3. Setze den Haken bei "Von diesem Computer immer erlauben"

4. Tippe auf "OK" bzw. "Erlauben"

Verbindung prüfen

Öffne die Eingabeaufforderung auf dem PC und tippe:

adb devices

Erwartete Ausgabe:

List of devices attached
XXXXXXXX    device

Dabei steht XXXXXXXX für die Seriennummer des Geräts.

Fehlerfälle:

• Leere Liste: USB-Kabel prüfen, USB-Debugging erneut aktivieren, anderes Kabel versuchen

• unauthorized: Den Bestätigungsdialog auf dem Gerät annehmen

• offline: USB-Kabel ab- und wieder anstecken

Schritt 4: Bestehende Konten entfernen

Device Owner kann nur gesetzt werden, wenn keine Google-Konten auf dem Gerät eingerichtet sind. Falls Konten vorhanden sind, müssen diese vorher entfernt werden.

Konten prüfen und entfernen

1. Öffne die Android-Einstellungen auf dem Kiosk-Gerät

2. Gehe zu "Konten" (oder "Nutzer & Konten")

3. Falls Google-Konten aufgelistet sind:Tippe auf das KontoTippe auf **"Konto entfernen"**Bestätige mit "Konto entfernen"

4. Wiederhole für alle Google-Konten

Wichtig: Nur Google-Konten müssen entfernt werden. Andere Konten (z.B. Hersteller-Konten) können bleiben.

Schritt 5: Device Owner setzen

5.1 Package-Name herausfinden

Der Package-Name hängt von der installierten App-Variante ab. Du findest ihn in der App:

1. Öffne die Kiosk-App auf dem Gerät

2. Gehe zu Einstellungen (Zahnrad-Symbol)

3. Scrolle zum Abschnitt "APK Update"

4. Falls dort der Hinweis "Für automatische Updates..." steht, wird der ADB-Befehl mit dem korrekten Package-Name angezeigt

Der Package-Name hat das Format: at.meisterwork.kiosk.<variante>

5.2 ADB-Befehl ausführen

Führe in der Eingabeaufforderung folgenden Befehl aus (ersetze <package-name> durch den Package-Name aus der App):

adb shell dpm set-device-owner <package-name>/com.loyalty.apkupdate.KioskDeviceAdminReceiver

Beispiel (für die Variante treuepass):

adb shell dpm set-device-owner at.meisterwork.kiosk.treuepass/com.loyalty.apkupdate.KioskDeviceAdminReceiver

5.3 Erfolgsmeldung

Bei Erfolg erscheint:

Success: Device owner set to package at.meisterwork.kiosk.<variante>
Active admin set to component {at.meisterwork.kiosk.<variante>/com.loyalty.apkupdate.KioskDeviceAdminReceiver}

Schritt 6: Überprüfen

1. Öffne die Kiosk-App auf dem Gerät

2. Gehe zu Einstellungen (Zahnrad-Symbol)

3. Scrolle zum Abschnitt "APK Update"

4. Der Installationsmodus sollte nun anzeigen: "Automatisch (Device Owner)"

Wenn dort weiterhin "Manuell (kein Device Owner)" steht, starte die App einmal neu und prüfe erneut.

Fehlerbehebung

"Not allowed to set the device owner because there are already some accounts on the device"

Ursache: Es sind noch Google-Konten auf dem Gerät eingerichtet.

Lösung: Entferne alle Google-Konten (siehe Schritt 4) und führe den Befehl erneut aus.

Falls das Konto sich nicht über die Einstellungen entfernen lässt, versuche:

adb shell pm remove-user 0

Achtung: Falls auch das nicht funktioniert, muss das Gerät auf Werkseinstellungen zurückgesetzt werden. Dabei gehen alle Daten verloren!

"Device is already provisioned"

Ursache: Das Gerät wurde bereits eingerichtet (z.B. durch einen Setup-Wizard oder ein MDM-System).

Lösung: Setze das Gerät auf Werkseinstellungen zurück und führe die Einrichtung erneut durch:

1. Einstellungen > System > Optionen zum Zurücksetzen > Alle Daten löschen

2. Nach dem Neustart: Überspringe die Google-Konto-Einrichtung

3. Aktiviere USB-Debugging (Schritt 2)

4. Führe den Device-Owner-Befehl aus (Schritt 5)

ADB findet das Gerät nicht

Symptom: adb devices zeigt eine leere Liste.

Mögliche Ursachen und Lösungen:

1. USB-Debugging nicht aktiviert: Prüfe Schritt 2

2. Falsches USB-Kabel: Manche Kabel sind reine Ladekabel ohne Datenverbindung — verwende ein anderes Kabel

3. USB-Treiber fehlen: Installiere die USB-Treiber des Geräteherstellers (bei Sunmi: Sunmi-Treiber von der Sunmi-Website)

4. USB-Port defekt: Versuche einen anderen USB-Port am PC

5. ADB-Server hängt: Starte den ADB-Server neu:

adb kill-server
adb start-server
adb devices

Device Owner wieder entfernen

Falls der Device Owner entfernt werden soll:

adb shell dpm remove-active-admin <package-name>/com.loyalty.apkupdate.KioskDeviceAdminReceiver

Alternativ kann das Gerät auf Werkseinstellungen zurückgesetzt werden.