Seminar Mobly Snippet Lib Grundlagen

Seminarprofil

Eigene Snippets stellen projektspezifische Android-Funktionen als hostseitig nutzbare APIs bereit. Die Inhalte verbinden Android-Implementierung, RPC-Vertrag, Paketierung, Mobly-Client und Lebenszyklus zu einem vollständigen Entwicklungsprozess.

Didaktische Einordnung: Drei Tage sind erforderlich, um Android-Projektaufbau und RPC-Grundlagen, anschließend Ereignisse und Fehlerbehandlung sowie abschließend Paketierung, Clientintegration und einen vollständigen Praxistest fundiert umzusetzen.

Lernziele

• Ein Snippet-Projekt mit Mobly Snippet Lib korrekt aufsetzen
• Stabile RPC-Methoden mit klaren Datentypen und Fehlern entwickeln
• Asynchrone Ereignisse vom Gerät an den Host übertragen
• APK, Paketname und Clientregistrierung konsistent konfigurieren
• Ein eigenes Snippet in einem vollständigen Mobly-Test einsetzen

Zielgruppe

Android-Entwickler, Testautomatisierer und Framework-Entwickler, die geräteinterne Funktionen sicher für Mobly-Tests bereitstellen.

Voraussetzungen

Gute Python-Grundkenntnisse, grundlegende Mobly-Erfahrung sowie Android-Entwicklungskenntnisse in Java oder Kotlin und Umgang mit Gradle.

Inhaltsübersicht

1. Tag 1 – Architektur und API-Vertrag entwerfen
2. Tag 1 – Android-Projekt vorbereiten
3. Tag 1 – Erste RPC-Methoden implementieren
4. Tag 2 – Komplexe Daten und Fehler behandeln
5. Tag 2 – Ereignisse vom Gerät veröffentlichen
6. Tag 2 – Berechtigungen und Lebenszyklus steuern
7. Tag 3 – Paketierung und Versionierung aufbauen
8. Tag 3 – Python-Client und Testintegration entwickeln
9. Tag 3 – Qualität und Diagnose absichern

1. Tag 1 – Architektur und API-Vertrag entwerfen

Die Arbeitsschritte bauen aufeinander auf und werden unmittelbar am Testsystem nachvollzogen.

1. Schritt 1: Host, Mobly-Client, Android-Dienst und Ziel-API voneinander abgrenzen.
2. Schritt 2: Geeignete Funktionen für synchrone RPC-Aufrufe und Ereignisse auswählen.
3. Schritt 3: Methodennamen, Parameter, Rückgabewerte und Fehlerfälle dokumentieren.

2. Tag 1 – Android-Projekt vorbereiten

Die Arbeitsschritte bauen aufeinander auf und werden unmittelbar am Testsystem nachvollzogen.

1. Schritt 1: Ein Android-Bibliotheks- oder Anwendungsmodul mit benötigten Abhängigkeiten anlegen.
2. Schritt 2: Manifest, Paketname und Buildvarianten für das Testartefakt konfigurieren.
3. Schritt 3: Das minimale Snippet auf einem Testgerät installieren und starten.

3. Tag 1 – Erste RPC-Methoden implementieren

Die Arbeitsschritte bauen aufeinander auf und werden unmittelbar am Testsystem nachvollzogen.

1. Schritt 1: Einfache Methoden registrieren und primitive Datentypen übertragen.
2. Schritt 2: Eingaben validieren und reproduzierbare Rückgabewerte erzeugen.
3. Schritt 3: Aufrufe über den Python-Client auslösen und protokollieren.

4. Tag 2 – Komplexe Daten und Fehler behandeln

Die Arbeitsschritte bauen aufeinander auf und werden unmittelbar am Testsystem nachvollzogen.

1. Schritt 1: Listen, Abbildungen und strukturierte Ergebnisse serialisierbar gestalten.
2. Schritt 2: Android-Ausnahmen in verständliche RPC-Fehler übersetzen.
3. Schritt 3: Zeitlimits und potenziell blockierende Geräteaktionen absichern.

5. Tag 2 – Ereignisse vom Gerät veröffentlichen

Die Arbeitsschritte bauen aufeinander auf und werden unmittelbar am Testsystem nachvollzogen.

1. Schritt 1: Ereignistypen und erforderliche Nutzdaten definieren.
2. Schritt 2: Asynchrone Android-Callbacks in Snippet-Ereignisse überführen.
3. Schritt 3: Ereignisse auf Hostseite filtern, abwarten und zeitlich zuordnen.

6. Tag 2 – Berechtigungen und Lebenszyklus steuern

Die Arbeitsschritte bauen aufeinander auf und werden unmittelbar am Testsystem nachvollzogen.

1. Schritt 1: Laufzeitberechtigungen und Geräteanforderungen vor Aufrufen prüfen.
2. Schritt 2: Initialisierung, Sitzungsstart und Ressourcenfreigabe implementieren.
3. Schritt 3: Neustarts, Prozessabbruch und erneute Verbindung kontrolliert behandeln.

7. Tag 3 – Paketierung und Versionierung aufbauen

Die Arbeitsschritte bauen aufeinander auf und werden unmittelbar am Testsystem nachvollzogen.

1. Schritt 1: APK-Namen, Paketkennung und Snippet-Kennung konsistent festlegen.
2. Schritt 2: API-Version und Funktionsumfang für Clientprüfungen bereitstellen.
3. Schritt 3: Build und Artefakterzeugung reproduzierbar automatisieren.

8. Tag 3 – Python-Client und Testintegration entwickeln

Die Arbeitsschritte bauen aufeinander auf und werden unmittelbar am Testsystem nachvollzogen.

1. Schritt 1: Das Snippet am AndroidDevice-Controller laden und starten.
2. Schritt 2: RPC-Aufrufe in domänenspezifische Python-Helfer kapseln.
3. Schritt 3: Setup, Assertions, Ereignisprüfung und Teardown in einem Test verbinden.

9. Tag 3 – Qualität und Diagnose absichern

Die Arbeitsschritte bauen aufeinander auf und werden unmittelbar am Testsystem nachvollzogen.

1. Schritt 1: Unit-nahe Prüfungen für API-Vertrag und Serialisierung festlegen.
2. Schritt 2: Geräte- und Hostlogs bei Fehlern gemeinsam erfassen.
3. Schritt 3: Einen vollständigen positiven und negativen End-to-End-Test ausführen.

Praxisprojekt

1. Schritt 1: Ein minimales Android-Snippet-Projekt aufsetzen und auf einem Gerät starten.
2. Schritt 2: Synchrone RPC-Methoden mit Eingabeprüfung und strukturiertem Ergebnis implementieren.
3. Schritt 3: Ein Android-Callback als Hostereignis veröffentlichen und im Test abwarten.
4. Schritt 4: Ein installierbares Snippet samt Python-Helfer und End-to-End-Test fertigstellen.