Verwenden von Azure DevOps für Benutzeroberflächentests
Wichtig
Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.
In diesem Leitfaden wird beschrieben, wie Sie Ihren vorhandenen Azure Pipelines-Build ändern, der eine Anwendungsbinärdatei (.apk
oder .ipa
-datei) erstellt, um eine App Center-Testaufgabe hinzuzufügen, die Ihre Testsammlung in App Center Test ausführt.
Azure Pipelines ist als Teil von Azure DevOps Services verfügbar. Azure Pipelines unterstützt Sie beim Implementieren einer Build-, Test- und Bereitstellungspipeline für jede App. Weitere Informationen zu Azure DevOps Services oder Azure Pipelines finden Sie in der Azure DevOps-Dokumentation bzw. in Azure Pipelines.
Mit dem App Center-Testtask für Azure Pipelines können Sie Ihre Testsammlungen in App Center Test ausführen. Sie können die Frameworks Appium, XCUItest, Espresso und Xamarin.UITest verwenden. Weitere Informationen zu den Frameworks finden Sie auf der Seite Unterstützte Frameworks für Den App Center-Test .
Jedes Framework verfügt über einen eigenen Abschnitt in diesem Leitfaden, in dem Sie sich über die grundlegenden Anforderungen zum Einrichten einer App Center-Testaufgabendefinition in Azure Pipelines informieren können.
Allgemeine Konfigurationsschritte
Vorbereitung
Sie benötigen Folgendes, bevor Sie mit dem Testen beginnen können:
- Ein Azure Pipelines-Build, der Ihre Anwendungsbinärdatei (
.apk
oder.ipa
-datei) erstellt. - Ein aktives App Center-Testkonto. Sie können eine Testversion für App Center-Test im App Center aktivieren. Wählen Sie zunächst Ihre App und dann im linken Menü Testen aus.
- Konfigurieren Sie die Pipeline für die Verwendung von Node 10.x.x. Lesen Sie in der Azure DevOps-Dokumentation, in der Dokumentation geht es um Javascript, aber das Prinzip gilt auch hier.
Allgemeine Konfiguration von Azure Pipelines
Suchen Sie Ihr Azure Pipelines-Projekt, und öffnen Sie es für Bearbeiten. Klicken Sie hier + , um eine neue Aufgabe hinzuzufügen, und suchen Sie dann nach App Center.
Klicken Sie neben dem App Center-Testtask auf Hinzufügen. Klicken Sie auf der linken Seite des Bildschirms auf die hinzugefügte App Center-Aufgabe Testen mit Visual Studio , um sie auszuwählen und zu ändern. Der App Center-Testtask ist in Abschnitte unterteilt.
Fügen Sie im oberen Abschnitt den Pfad zu Ihrer App-Binärdatei (.apk
oder .ipa
) in das Feld Dateipfad der Binären Anwendung ein .
Herstellen einer Verbindung mit App Center-Test
Melden Sie sich bei App Center an, bevor Sie den Dienst verwenden. Es stehen Ihnen zwei Authentifizierungsmethoden zur Verfügung.
Die erste Methode verwendet ein API-Token. , um das API-Token Ihres Kontos abzurufen:
- Melden Sie sich bei App Center an, und klicken Sie oben links im App Center-Portal auf das Symbol "Benutzereinstellungen".
- Wählen Sie im daraufhin angezeigten Menü Kontoeinstellungen aus.
- Wählen Sie im Bereich Einstellungen die Option API-Token aus.
- Klicken Sie in der oberen rechten Ecke des Bereichs auf die Schaltfläche Neues API-Token .
- Nennen Sie das neue API-Token: Für instance können Sie es Azure DevOps nennen. In Zukunft hilft Ihnen dieser Name dabei, zu ermitteln, welcher Dienst den Dienst verwendet.
- Klicken Sie auf die Schaltfläche Neues API-Token hinzufügen . Ein Popupfenster zeigt das neue API-Token an. Dieses Popupfenster ist das einzige Mal , dass dieses Token in App Center angezeigt wird. Klicken Sie auf die Schaltfläche zwischenablage, um das API-Token in die Zwischenablage des Browsers zu kopieren. Speichern Sie das API-Token an einem beliebigen Ort (z. B. Azure Key Vault), an dem Sie später bei Bedarf sicher darauf verweisen können.
Mit dem API-Token in der Zwischenablage:
- Wechseln Sie zu Ihrem Azure DevOps Services-Fenster. Klicken Sie im Feld App Center-Verbindung im Abschnitt Ausführen der App Center-Testaufgabe auf die Schaltfläche Hinzufügen .
- Füllen Sie das Feld Name des Formulars mit einem geeigneten Namen für die Verbindung auf (z. B. App Center).
- Fügen Sie das App Center-API-Token in das Feld API-Token ein.
- Schließen Sie die Einrichtung ab, indem Sie auf Schließen klicken.
Stellen Sie sicher, dass Ihre neu erstellte Verbindung im Feld App Center-Verbindung angezeigt wird.
Die zweite Methode verwendet Ihre App Center-Kontoanmeldeinformationen:
- Wählen Sie im Dropdownmenü Authentifizierungsmethode die Option Anmeldeinformationen aus.
- Füllen Sie die Felder App Center-Benutzername und App Center-Kennwort mit den Anmeldeinformationen aus Ihrem App Center-Konto auf.
Hinweis
Ihr App Center-Benutzername befindet sich in Ihrem App Center-Kontoprofil. Wenn Sie sich mit Ihren Microsoft-Anmeldeinformationen anmelden, richten Sie Ihr Konto mit einem Kennwort ein, oder die Aufgabe kann sich nicht anmelden. Sie können ein Kennwort in App Center einrichten.
Appium
- Führen Sie vor dem Erstellen eines Testlaufs die Schritte im Abschnitt Vor beginn dieses Handbuchs aus.
- Bereiten Sie Ihr Repository für App Center-Tests und Appium-Tests vor.
Azure Pipelines-Konfiguration für Appium
Fügen Sie zunächst den App Center-Testtask der Builddefinition hinzu, wie weiter oben unter Allgemeine Konfiguration von Azure Pipelines beschrieben.
Stellen Sie im Abschnitt Tests vorbereiten sicher, dass das Kontrollkästchen Tests vorbereiten aktiviert ist, und wählen Sie dann für TestFrameworkdie Option Appium Test Framework aus. Fügen Sie den Pfad zu appium test-classes, dependency-jars und der pom.xml
Datei in das Feld Buildverzeichnis ein. Diese drei Artefakte befinden sich in der Regel im upload
Ordner.
Jetzt können Sie den Testlauf konfigurieren. Alle benötigten Informationen finden Sie, indem Sie einen neuen Test unter Test in App Center erstellen. Befolgen Sie die Anweisungen unter Starten eines Testlaufs. Lassen Sie die Seite "Übermitteln" (letzte Seite beim Setup des Testlaufs) geöffnet, damit Sie diese Informationen beim Einrichten des App Center-Testtasks verwenden können.
appcenter test run appium --app "username/appname" --devices 209ed689
--app-path pathToFile.apk --test-series "main" --locale "en_US"
--build-dir target/upload
- Auf der Übermittlungsseite ist der App-Slug der
--app
Parameter. Fügen Sie diese in das Feld App-Slug ein . - Die Geräteauswahl ist der
--devices
Parameter. Fügen Sie diese in das Feld Geräte ein. - Die Testreihe ist ein Freitextfeld – es kann sich um ein beliebiges Feld handeln. Dies ist der
--test-series
Parameter. - Die Systemsprache ist ein Dropdownmenü. Wenn Andere ausgewählt ist, wird ein Feld Anderes Gebietsschema angezeigt, in dem Sie Sprache und Ländercode wie im folgenden Format eingeben können:
en_US
.
Speichern Sie die Konfiguration, und Sie können den Build- und App Center-Testlauf starten.
Espresso
- Führen Sie vor dem Erstellen eines Testlaufs die Schritte im Abschnitt Vor beginn dieses Handbuchs aus.
- Lesen Sie, wie Sie Ihr Repository für App Center-Tests und Espresso-Tests vorbereiten.
Azure Pipelines-Konfiguration für Espresso
Fügen Sie zunächst den App Center-Testtask der Builddefinition hinzu, wie weiter oben unter Allgemeine Konfiguration von Azure Pipelines beschrieben.
Stellen Sie im Abschnitt Tests vorbereiten sicher, dass das Kontrollkästchen Tests vorbereiten aktiviert ist, und wählen Sie für Testframeworkdie Option Espresso Test Framework aus.
Jetzt können Sie den Testlauf konfigurieren. Alle benötigten Informationen finden Sie, indem Sie einen neuen Test unter Test in App Center erstellen. Befolgen Sie die Anweisungen unter Starten eines Testlaufs. Lassen Sie die Seite "Übermitteln" (letzte Seite beim Setup des Testlaufs) geöffnet, damit Sie diese Informationen beim Einrichten des App Center-Testtasks verwenden können.
appcenter test run espresso --app "username/appname" --devices 209ed689
--app-path pathToFile.apk --test-series "main" --locale "en_US"
--build-dir pathToEspressoBuildFolder
- Auf der Übermittlungsseite ist der App-Slug der
--app
Parameter. Fügen Sie diese in das Feld App-Slug ein . - Die Geräteauswahl ist der
--devices
Parameter. Fügen Sie diese in das Feld Geräte ein. - Die Testreihe ist ein Freitextfeld – es kann sich um ein beliebiges Feld handeln. Dies ist der
--test-series
Parameter. - Die Systemsprache ist ein Dropdownmenü. Wenn Andere ausgewählt ist, wird ein Feld Anderes Gebietsschema angezeigt, in dem Sie Sprache und Ländercode wie im folgenden Format eingeben können:
en_US
.
Speichern Sie die Konfiguration, und Sie können den Build- und App Center-Testlauf starten.
Xamarin.UITest
- Führen Sie vor dem Erstellen eines Testlaufs die Schritte im Abschnitt Vor beginn dieses Handbuchs aus.
- Lesen Sie, wie Sie Ihr Xamarin.Android-Repository für App Center-Tests und Xamarin.UITest-Tests vorbereiten.
- Lesen Sie, wie Sie Ihr Xamarin.iOS-Repository für App Center-Tests und Xamarin.UITest-Tests vorbereiten.
Azure Pipelines-Konfiguration für Xamarin.UITest
Fügen Sie zunächst den App Center-Testtask der Builddefinition hinzu, wie weiter oben unter Allgemeine Konfiguration von Azure Pipelines beschrieben.
Stellen Sie im Abschnitt Tests vorbereiten sicher, dass das Kontrollkästchen Tests vorbereiten aktiviert ist und dass Xamarin UI Test unter Test Framework ausgewählt ist. Fügen Sie den Pfad zu Ihrem Buildverzeichnis ein. in den meisten Fällen lautet der Buildordner: <ProjectName>/bin/<configuration>
.
Jetzt können Sie den Testlauf konfigurieren. Alle benötigten Informationen finden Sie, indem Sie einen neuen Test unter Test in App Center erstellen. Befolgen Sie die Anweisungen unter Starten eines Testlaufs. Lassen Sie die Seite "Übermitteln" (letzte Seite beim Setup des Testlaufs) geöffnet, damit Sie diese Informationen beim Einrichten des App Center-Testtasks verwenden können.
appcenter test run uitest --app "username/appname" --devices 209ed689
--app-path pathToFile.apk --test-series "main" --locale "en_US"
--build-dir pathTUITestBuildDir
- Auf der Übermittlungsseite ist der App-Slug der
--app
Parameter. Fügen Sie diese in das Feld App-Slug ein . - Die Geräteauswahl ist der
--devices
Parameter. Fügen Sie diese in das Feld Geräte ein. - Die Testreihe ist ein Freitextfeld – es kann sich um ein beliebiges Feld handeln. Dies ist der
--test-series
Parameter. - Die Systemsprache ist ein Dropdownmenü. Wenn Andere ausgewählt ist, wird ein Feld Anderes Gebietsschema angezeigt, in dem Sie Sprache und Ländercode wie im folgenden Format eingeben können:
en_US
.
Speichern Sie die Konfiguration, und Sie können den Build- und App Center-Testlauf starten.
XCUITest
- Führen Sie vor dem Erstellen eines Testlaufs die Schritte im Abschnitt Vor beginn dieses Handbuchs aus.
- Lesen Sie, wie Sie Ihr Repository für App Center-Tests und XCUITest-Tests vorbereiten.
Hinweis
In Ihrer Pipeline benötigen Sie vor dem App Center-Testtask einen Xcode-Aufgabenschritt mit einer Aktion von build-for-testing
, um die für Tests erforderliche Test-Runner-App zu erstellen. Geben Sie in dieser Aufgabe unter Argumente im Abschnitt Erweitert einen abgeleiteten Datenpfad an, in der Regel mit -derivedDataPath DerivedData
. Sie benötigen auch eine .ipa file
für Ihre Anwendung. Sie können die .ipa file
in derselben Xcode-Aufgabebuild-for-testing
erstellen, indem Sie die Create app package
Option aktivieren, oder in einem separaten Xcode-Buildschritt oder in einem Bash-Skriptschritt .
Azure Pipelines-Konfiguration für XCUITest
Fügen Sie zunächst den App Center-Testtask der Builddefinition hinzu, wie weiter oben unter Allgemeine Konfiguration von Azure Pipelines beschrieben.
Stellen Sie im Abschnitt Tests vorbereiten sicher, dass das Kontrollkästchen Tests vorbereiten aktiviert ist und dass XCUITest unter Testframework ausgewählt ist. Fügen Sie den Pfad zu Ihrem Buildverzeichnis aus dem Xcode-Schritt build-for-testing
ein. In der Regel lautet der Buildordner: DerivedData/Build/Products/Debug-iphoneos/
.
Jetzt können Sie den Testlauf konfigurieren. Alle benötigten Informationen finden Sie, indem Sie einen neuen Test unter Test in App Center erstellen. Befolgen Sie die Anweisungen unter Starten eines Testlaufs. Lassen Sie die Seite "Übermitteln" (letzte Seite beim Setup des Testlaufs) geöffnet, damit Sie diese Informationen beim Einrichten des App Center-Testtasks verwenden können.
appcenter test run xcuitest --app "username/appname" --devices 209ed689 --test-series "main" --locale "en_US" --build-dir pathToXCUItestBuildFolder
- Auf der Übermittlungsseite ist der App-Slug der
--app
Parameter. Fügen Sie diese in das Feld App-Slug ein . - Die Geräteauswahl ist der
--devices
Parameter. Fügen Sie diese in das Feld Geräte ein. - Die Testreihe ist ein Freitextfeld – es kann sich um ein beliebiges Feld handeln. Dies ist der
--test-series
Parameter. - Die Systemsprache ist ein Dropdownmenü. Wenn Andere ausgewählt ist, wird ein Feld Anderes Gebietsschema angezeigt, in dem Sie Sprache und Ländercode wie im folgenden Format eingeben können:
en_US
.
Speichern Sie die Konfiguration, und Sie können den Build- und App Center-Testlauf starten.