Journeys für Android Studio

Durch das Erstellen von Abläufen für Android Studio lassen sich End-to-End-Tests einfach schreiben und verwalten. Sie können die Schritte und Zusicherungen für jeden Test (als Ablauf bezeichnet) in natürlicher Sprache beschreiben. Durch die Nutzung der Vision- und Reasoning-Funktionen von Gemini werden in natürlicher Sprache geschriebene Schritte in Aktionen umgewandelt, die Gemini in Ihrer App ausführt. So lassen sich Journeys einfach schreiben und nachvollziehen. Außerdem können Sie komplexere Behauptungen formulieren und beschreiben, die Gemini anhand der Informationen auf dem Gerät auswertet, um festzustellen, ob Ihre Abläufe erfolgreich sind oder nicht.

Da Gemini überlegt, welche Aktionen ausgeführt werden müssen, um die Ziele zu erreichen, sind Abläufe weniger anfällig für geringfügige Änderungen am Layout oder Verhalten Ihrer App. Das führt zu weniger instabilen Tests, wenn sie für verschiedene Versionen Ihrer App und verschiedene Gerätekonfigurationen ausgeführt werden.

Sie können Journeys direkt in Android Studio schreiben und auf jedem lokalen oder Remote-Android-Gerät ausführen. Die IDE bietet einen neuen Editor zum Erstellen von Journeys sowie Rich-Suchergebnisse, mit denen Sie die Argumentation und Ausführung Ihrer Journey durch Gemini besser nachvollziehen können.

Reise schreiben

Android Studio bietet eine Dateivorlage und einen neuen Editor, mit denen sich Journeys ganz einfach erstellen und bearbeiten lassen. Journeys werden in XML-Syntax geschrieben, um die Beschreibung und die Schritte zu organisieren.

So erstellen Sie eine Journey und beginnen mit der Bearbeitung:

  1. Klicken Sie in Android Studio im Bereich Project mit der rechten Maustaste auf das App-Modul, für das Sie einen Ablauf schreiben möchten.
  2. Wählen Sie Neu > Test > Journey-Datei aus.
  3. Geben Sie im angezeigten Dialogfeld den Namen und die Beschreibung des Ablaufs ein.
  4. Klicken Sie auf OK. Android Studio erstellt eine XML-Datei für Ihre Reise mit dem von Ihnen gewählten Namen. Sie können entweder die Code-Ansicht verwenden, um das XML direkt zu bearbeiten, oder die Design-Ansicht, um die Bearbeitung zu vereinfachen.
  5. Wenn Sie sich Ihre User Journey in der Ansicht Design ansehen, können Sie im Textfeld jeden Schritt der User Journey beschreiben. Jeder Schritt kann beschreibende Aktionen enthalten, die Gemini ausführen soll, oder Behauptungen, die Gemini bewerten soll.
  6. Drücken Sie die Eingabetaste, um einen neuen Prompt im selben Ablauf zu starten. Sie können diesen Vorgang für jeden Schritt des Ablaufs, den Sie definieren möchten, wiederholen.

Tipps zum Verfassen von Reisen

Wenn Sie Ihre Journeys detailliert und strukturiert formulieren, ist es wahrscheinlicher, dass Gemini sie genau und deterministisch ausführt. Hier sind einige Tipps, die Ihnen helfen, Ihre Journeys effektiver zu schreiben: * Behauptungen von Aktionen trennen:Gemini bewertet ständig den Status Ihrer App, um festzustellen, ob sie sich in einem „korrekten“ Zustand befindet, um die Journey fortzusetzen. Möglicherweise müssen Sie jedoch komplexere Zusicherungen als separaten Schritt definieren. Beginnen Sie jede Eingabeaufforderung mit Schlüsselformulierungen wie „Bestätige, dass“, „Behaupten, dass“ oder „Prüfe, ob“, damit Gemini weiß, dass es sich bei diesem Schritt um eine Behauptung handelt. * Gemini durch Wischen steuern:Neben grundlegenden Interaktionen wie Tippen oder Tastatureingaben unterstützt Gemini auch Aktionen, bei denen auf dem Display in bestimmte Richtungen gewischt werden muss. Wenn Sie beispielsweise durch Inhalte scrollen oder eine Benutzeroberfläche schließen möchten, beschreiben Sie einfach die Richtung und den Zweck Ihrer Wischbewegung. Standardmäßig wird bei Gemini in der Mitte des Displays gewischt. Sie können aber festlegen, dass an einer anderen Stelle des Displays gewischt wird. * Komplexe Interaktionen und Konfigurationsänderungen vermeiden:Gemini unterstützt derzeit nicht alle Interaktionen und Konfigurationsänderungen, z. B. Mehrfingergesten, Bildschirmdrehungen oder Faltvorgänge. Das Team arbeitet daran, die Funktionen von Gemini zu verbessern.

Fahrt starten

Sie können den Ablauf auf jedem verfügbaren lokalen oder Remote-Gerät ausführen, ähnlich wie bei anderen instrumentierten Tests. Android Studio generiert umfassende Ergebnisse, die Ihnen helfen, die Ausführung des Ablaufs nachzuvollziehen.

So testen Sie einen Ablauf:

  1. Wählen Sie in der Hauptsymbolleiste ein Zielgerät aus, so wie Sie es auch bei der Ausführung eines instrumentierten Tests tun würden.
  2. Rufen Sie die XML-Datei des Ablaufs auf, die Sie testen möchten, und öffnen Sie sie im Editor.
  3. Führen Sie im Editor einen der folgenden Schritte aus:
    1. Wenn Sie sich in der Ansicht Design befinden, klicken Sie auf  Journey ausführen.
    2. Wenn Sie sich in der Ansicht Code befinden, klicken Sie in der Spalte neben der Stelle, an der der Name des Ablaufs im XML-Code definiert ist, auf   ausführen.

Android Studio erstellt für Sie eine Journeys Test-Konfiguration und führt sie auf dem Zielgerät aus. Während der Ausführung erstellt und stellt Android Studio Ihre App bereit und stellt eine Verbindung zu Gemini her, um zu ermitteln, welche Aktionen für die einzelnen Schritte Ihres Ablaufs ausgeführt werden sollen.

Während der Ausführung eines Ablaufs werden im Editor auch eingeschränkte Ergebnisse angezeigt, z. B. die Screenshots, die ergriffenen Maßnahmen und die Begründung für die Ausführung der einzelnen Schritte im Ablauf. Bewegen Sie einfach den Mauszeiger auf die Miniaturansicht im Editor, um weitere Informationen zu sehen. Das kann hilfreich sein, wenn Sie die Prompts in Ihrem Ablauf iterieren.

Ergebnisse ansehen

Wenn Android Studio den Test Ihres Ablaufs abgeschlossen hat, wird automatisch der Bereich mit den Testergebnissen angezeigt.

Im Vergleich zu anderen instrumentierten Tests, die Sie in Android Studio ausführen, gibt es einige Unterschiede bei der Darstellung der Ergebnisse für Journeys.

  • Im Bereich Tests wird der Ablauf in die einzelnen Schritte unterteilt. Sie können auf die einzelnen Schritte klicken, um weitere Informationen dazu zu erhalten, wie Gemini sie ausgeführt hat.
  • Im Bereich Ergebnisse finden Sie detaillierte Informationen dazu, wie Gemini Ihre Anfrage verstanden und bearbeitet hat und wie sie ausgeführt wurde.
  • Die Screenshots, die an Gemini gesendet wurden, werden zur visuellen Unterstützung bei jeder Aktion im Schritt angezeigt.
  • Neben jedem Screenshot wird die jeweilige Aktion und die Begründung von Gemini für diese Aktion beschrieben.
  • Jede Aktion im Schritt ist nummeriert.

Bekannte Probleme

  • Beim Testen eines Ablaufs werden standardmäßig alle Berechtigungen für Ihre App erteilt.
  • Wenn Sie einen Ablauf auf einem Gerät mit Android 15 (API-Level 35) testen, wird auf dem Gerät möglicherweise eine Warnung angezeigt, dass die unsichere App „AndroidX Crawler“ blockiert wurde. Sie können auf Trotzdem installieren klicken, um diese Prüfung zu umgehen. Alternativ können Sie Entwickleroptionen auf dem Gerät konfigurieren und die Option Apps über USB überprüfen deaktivieren.
  • Reise-Dateien werden derzeit nicht in der Android-Ansicht im Bereich Projekte angezeigt. Wenn Sie Journey-Dateien in Ihrem Projekt sehen möchten, verwenden Sie die Ansicht Projekt.
  • Wenn mehrere Aktionen in einem Ablauf denselben Prompt verwenden, sind die im Ablaufeditor angezeigten Testergebnisse möglicherweise falsch. Konkret werden bei allen Aktionen mit dem doppelten Prompt die Testergebnisse angezeigt, die mit der zuletzt aktualisierten Instanz dieses Prompts verknüpft sind. Um dieses Problem zu umgehen, müssen Sie dafür sorgen, dass jede Aktion einen eindeutigen Prompt hat, z. B. durch Hinzufügen eines eindeutigen Präfixes oder Suffixes.
  • Beim zweiten Laden der Tastatur auf einem neuen Emulator wird ein Stift-Pop-up angezeigt. Dieses Pop-up-Fenster führt in der Regel dazu, dass Tests, bei denen mit Textfeldern interagiert wird, fehlschlagen. Schließen Sie in diesem Fall das Pop-up und führen Sie den Ablauf noch einmal aus.
  • Artefakte des App-Crawlers können gelegentlich in der Begründung des Agents erscheinen.
  • Die Ausführung von Kampagnen schlägt gelegentlich mit einem IllegalStateException fehl. In diesem Fall können Sie auf Testergebnisse klicken, um den vollständigen Fehler zu sehen.

  • Wenn das Android-Gradle-Plug-in (com.android.application) nicht in der build.gradle-Datei der obersten Ebene definiert ist, wird beim Ausführen eines Ablaufs möglicherweise der folgende Fehler angezeigt:

    Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'

    Achten Sie darauf, dass das Plug-in in der build.gradle-Datei der obersten Ebene definiert ist, um dieses Problem zu beheben. Weitere Informationen finden Sie unter Android-Buildsystem konfigurieren.