Journeys für Android Studio

Mit Journeys for Android Studio lassen sich End-to-End-Tests einfach schreiben und verwalten. Sie können die Schritte und Zusicherungen für jeden Test, der als Journey bezeichnet wird, 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 ganz 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 Journeys erfolgreich sind oder nicht.

Da Gemini bestimmt, welche Aktionen ausgeführt werden müssen, um die Ziele zu erreichen, sind Journeys weniger anfällig für subtile Ä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 eine neue Editor-Oberfläche 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 einfacher erstellen und bearbeiten lassen. Journeys werden in der Extensible Markup Language (XML)-Syntax geschrieben, um die Beschreibung und die Schritte der Journey zu organisieren.

Der Journey-Editor in Android Studio mit einer XML-Datei mit Journey-Schritten.

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 eine Journey 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 ausgewä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 Journey in der Designansicht ansehen, können Sie im Textfeld jeden Schritt der 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 organisiert schreiben, ist es wahrscheinlicher, dass Gemini sie genau und deterministisch ausführt. Hier sind einige Tipps, wie Sie Ihre Prompts effektiver formulieren können:

  • Assertions von Aktionen trennen:Gemini bewertet ständig den Status Ihrer App, um festzustellen, ob sie sich in einem „korrekten“ Zustand befindet, um den Ablauf fortzusetzen. Möglicherweise müssen Sie jedoch komplexere Zusicherungen in einem separaten Schritt definieren. Beginnen Sie außerdem jeden Prompt mit Schlüsselformulierungen wie „Bestätige, dass“, „Behaupten, dass“ oder „Prüfe, ob“, um Gemini mitzuteilen, dass dieser Schritt eine Behauptung sein soll.
  • Gemini durch Wischen steuern:Neben grundlegenden Interaktionen wie Tippen oder Tastatureingaben unterstützt Gemini auch Aktionen, bei denen das Display in bestimmte Richtungen gewischt werden muss. Wenn Sie beispielsweise durch Inhalte scrollen oder ein UI-Element schließen möchten, beschreiben Sie die Richtung und den Zweck Ihrer Wischbewegung. Standardmäßig wird Gemini durch Wischen von der Mitte des Bildschirms aus aufgerufen. Sie können aber auch festlegen, dass das Wischen an einer anderen Stelle des Gerätebildschirms erfolgen soll.
  • Komplexe Interaktionen und Konfigurationsänderungen vermeiden:Gemini unterstützt nicht alle Interaktionen und Konfigurationsänderungen, z. B. Mehrfingergesten, Bildschirmdrehungen oder Faltvorgänge. Das Team arbeitet daran, die Funktionen von Gemini zu verbessern.

Route starten

Sie können Ihre Journey auf jedem verfügbaren lokalen oder Remote-Gerät ausführen, ähnlich wie bei anderen instrumentierten Tests. Android Studio generiert aussagekräftige Ergebnisse, die Ihnen helfen, die Ausführung Ihrer Journey nachzuvollziehen.

In Android Studio wird ein Ablauf ausgeführt. Der Geräte-Selector und ein Ausführungssymbol im Editor sind hervorgehoben.

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  test 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 die Aktionen für jeden Schritt des Ablaufs zu ermitteln.

Bewegen Sie den Mauszeiger im Editor auf das Thumbnail, um weitere Informationen zu sehen. Das kann hilfreich sein, wenn Sie die Prompts in Ihrem Workflow iterieren.

Der Bereich mit den Testergebnissen für den Ablauf in Android Studio mit Schrittdetails und der Begründung von Gemini.

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 ausführliche Informationen, die Ihnen helfen, die Interpretation und Argumentation von Gemini in Bezug auf Ihre Journey sowie die Ausführung durch Gemini nachzuvollziehen.
  • 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 mit dem Hinweis Unsichere App blockiert für AndroidX Crawler angezeigt. 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, sollten Sie darauf achten, 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 Journeys 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.