Appium Plugin Reference - Versionsgeschichte

Mawalch: Drop old (pre 2.10) Android/Mobile references

2018-02-12T16:00:27Z

Drop old (pre 2.10) Android/Mobile references

Mawalch am 15. Juli 2017 um 09:11 Uhr

2017-07-15T09:11:24Z

Mawalch: Spelling fixes.

2017-05-28T20:15:12Z

Spelling fixes.

Cg am 24. Januar 2017 um 17:55 Uhr

2017-01-24T17:55:09Z

← Nächstältere Version		Version vom 24. Januar 2017, 17:55 Uhr
Zeile 1:		Zeile 1:
			Achtung: dieses Plugin ist obsolet und wurde durch das [[Mobile Testing Plugin]] ersetzt.

	= Einleitung =		= Einleitung =

	Mit dem ~~Mobile~~ Plugin können Anwendungen auf Android- und iOS-Geräten getestet werden. Dabei ist es egal, ob reale mobile Endgeräte oder emulierten Geräte verwendet werden. Das Plugin kann zusammen mit dem [[Expecco_GUI_Tests_Extension_Reference\|GUI-Browser]] verwendet werden, der das Erstellen von Tests unterstützt. Zudem ist damit das Aufzeichnen von Testabläufen möglich.		Mit dem Appium Plugin können Anwendungen auf Android- und iOS-Geräten getestet werden. Dabei ist es egal, ob reale mobile Endgeräte oder emulierten Geräte verwendet werden. Das Plugin kann zusammen mit dem [[Expecco_GUI_Tests_Extension_Reference\|GUI-Browser]] verwendet werden, der das Erstellen von Tests unterstützt. Zudem ist damit das Aufzeichnen von Testabläufen möglich.

	Zur Verbindung mit den Geräten wird [http://appium.io/ Appium] verwendet. Appium ist ein freies Open-Source-Framework zum Testen und Automatisieren von mobilen Anwendungen.		Zur Verbindung mit den Geräten wird [http://appium.io/ Appium] verwendet. Appium ist ein freies Open-Source-Framework zum Testen und Automatisieren von mobilen Anwendungen.

Cg: /* Architektur und Technologien */

2016-12-08T14:58:35Z

Architektur und Technologien

← Nächstältere Version		Version vom 8. Dezember 2016, 14:58 Uhr
Zeile 186:		Zeile 186:

	Die Anbindung an das Appium Testframework wurde über den 'Appium Driver', einer Weiterentwicklung des Selenium WebDrivers, umgesetzt. Das auf HTML und JavaScript basierende Interface wurde funktional so erweitert, dass es als Schnittstelle zum Appium Server verwendet werden kann und dadurch dessen Dienste zum Testen von mobilen Anwendungen genutzt werden können. Diese beiden Komponenten kommunizieren über das JSON Wire Protokoll miteinander.		Die Anbindung an das Appium Testframework wurde über den 'Appium Driver', einer Weiterentwicklung des Selenium WebDrivers, umgesetzt. Das auf HTML und JavaScript basierende Interface wurde funktional so erweitert, dass es als Schnittstelle zum Appium Server verwendet werden kann und dadurch dessen Dienste zum Testen von mobilen Anwendungen genutzt werden können. Diese beiden Komponenten kommunizieren über das JSON Wire Protokoll miteinander.
	Zur Zeit unterstützt Appium das Testen auf iOS und Android Systemen. Grundsätzlich können die ~~Test~~ in diversen Programmiersprachen geschrieben werden. Jedoch muss beim Erstellen der Tests definiert werden, auf welchem System sich die zu testende Anwendung befindet. An dieser Definition orientiert sich der Server, sucht sich die auszuführenden Aktionen heraus und sendet diese Befehle in einer dem Zielsystem verständlichen Form an die Endgeräte. Als Middleware für Android-Systeme wird die Android Debug Bridge genutzt. Für iOS-Systeme hingegen wird Instruments verwendet.		Zur Zeit unterstützt Appium das Testen auf iOS und Android Systemen. Grundsätzlich können die Tests in diversen Programmiersprachen geschrieben werden. Jedoch muss beim Erstellen der Tests definiert werden, auf welchem System sich die zu testende Anwendung befindet. An dieser Definition orientiert sich der Server, sucht sich die auszuführenden Aktionen heraus und sendet diese Befehle in einer dem Zielsystem verständlichen Form an die Endgeräte. Als Middleware für Android-Systeme wird die Android Debug Bridge genutzt. Für iOS-Systeme hingegen wird Instruments verwendet.

	[[Datei:appium_architekturskizze_mit_konsolenfenster.png \| 650px\|]]		[[Datei:appium_architekturskizze_mit_konsolenfenster.png \| 650px\|]]

Cg: /* Architektur und Technologien */

2016-12-08T14:58:06Z

Architektur und Technologien

← Nächstältere Version		Version vom 8. Dezember 2016, 14:58 Uhr
Zeile 185:		Zeile 185:
	== Architektur und Technologien ==		== Architektur und Technologien ==

	Die Anbindung an das Appium Testframework wurde über den 'Appium Driver', einer Weiterentwicklung des Selenium ~~WebDriver~~, umgesetzt. Das auf HTML und JavaScript basierende Interface wurde funktional so erweitert, dass es als Schnittstelle zum Appium Server verwendet werden kann und dadurch dessen Dienste zum Testen von mobilen Anwendungen genutzt werden können. Diese beiden Komponenten kommunizieren über das JSON Wire Protokoll miteinander.		Die Anbindung an das Appium Testframework wurde über den 'Appium Driver', einer Weiterentwicklung des Selenium WebDrivers, umgesetzt. Das auf HTML und JavaScript basierende Interface wurde funktional so erweitert, dass es als Schnittstelle zum Appium Server verwendet werden kann und dadurch dessen Dienste zum Testen von mobilen Anwendungen genutzt werden können. Diese beiden Komponenten kommunizieren über das JSON Wire Protokoll miteinander.
	Zur Zeit unterstützt Appium das Testen auf iOS und Android Systemen. Grundsätzlich können die Test in diversen Programmiersprachen geschrieben werden. Jedoch muss beim Erstellen der Tests definiert werden, auf welchem System sich die zu testende Anwendung befindet. An dieser Definition orientiert sich der Server, sucht sich die auszuführenden Aktionen heraus und sendet diese Befehle in einer dem Zielsystem verständlichen Form an die Endgeräte. Als Middleware für Android-Systeme wird die Android Debug Bridge genutzt. Für iOS-Systeme hingegen wird Instruments verwendet.		Zur Zeit unterstützt Appium das Testen auf iOS und Android Systemen. Grundsätzlich können die Test in diversen Programmiersprachen geschrieben werden. Jedoch muss beim Erstellen der Tests definiert werden, auf welchem System sich die zu testende Anwendung befindet. An dieser Definition orientiert sich der Server, sucht sich die auszuführenden Aktionen heraus und sendet diese Befehle in einer dem Zielsystem verständlichen Form an die Endgeräte. Als Middleware für Android-Systeme wird die Android Debug Bridge genutzt. Für iOS-Systeme hingegen wird Instruments verwendet.

Matilk: /* Einleitung */

2016-10-21T07:36:00Z

Einleitung

← Nächstältere Version		Version vom 21. Oktober 2016, 07:36 Uhr
Zeile 3:		Zeile 3:
	Mit dem Mobile Plugin können Anwendungen auf Android- und iOS-Geräten getestet werden. Dabei ist es egal, ob reale mobile Endgeräte oder emulierten Geräte verwendet werden. Das Plugin kann zusammen mit dem [[Expecco_GUI_Tests_Extension_Reference\|GUI-Browser]] verwendet werden, der das Erstellen von Tests unterstützt. Zudem ist damit das Aufzeichnen von Testabläufen möglich.		Mit dem Mobile Plugin können Anwendungen auf Android- und iOS-Geräten getestet werden. Dabei ist es egal, ob reale mobile Endgeräte oder emulierten Geräte verwendet werden. Das Plugin kann zusammen mit dem [[Expecco_GUI_Tests_Extension_Reference\|GUI-Browser]] verwendet werden, der das Erstellen von Tests unterstützt. Zudem ist damit das Aufzeichnen von Testabläufen möglich.

	Zur Verbindung mit den Geräten wird [http://appium.io/ Appium] verwendet. Appium ist ein freies Open-Source-Framework zum Testen und Automatisieren von mobilen Anwendungen.		Zur Verbindung mit den Geräten wird [http://appium.io/ Appium] verwendet. Appium ist ein freies Open-Source-Framework zum Testen und Automatisieren von mobilen Anwendungen.

			Dieses Dokument bezieht sich auf die expecco-Version 2.9. Die Dokumentation ab Version 2.10 finden Sie unter [[Mobile Testing Plugin]].

	Das zweite Kapitel dieser Dokumentation beschreibt das Einrichten und die Verwendung des Mobile Plugins.		Das zweite Kapitel dieser Dokumentation beschreibt das Einrichten und die Verwendung des Mobile Plugins.

Matilk: /* Tests mit dem Appium-Recorder erstellen */

2016-10-11T10:01:48Z

Tests mit dem Appium-Recorder erstellen

← Nächstältere Version		Version vom 11. Oktober 2016, 10:01 Uhr
Zeile 119:		Zeile 119:

	Um später Tests mit diesen Bausteinen ausführen zu können, müssen Sie am Anfang des Tests den ''Connect''-Baustein aus der Appium-Library einbauen und am Ende entsprechend ein ''Disconnect''. Zur Erzeugung der Capabilities für den ''Connect''-Baustein können Sie den Baustein ''Read Capabilities from File'' verwenden, der eine im Verbindungsdialog erstellte Datei einlesen kann.		Um später Tests mit diesen Bausteinen ausführen zu können, müssen Sie am Anfang des Tests den ''Connect''-Baustein aus der Appium-Library einbauen und am Ende entsprechend ein ''Disconnect''. Zur Erzeugung der Capabilities für den ''Connect''-Baustein können Sie den Baustein ''Read Capabilities from File'' verwenden, der eine im Verbindungsdialog erstellte Datei einlesen kann.

			Die Bausteine für bestimmte Aktionen warten nicht, bis diese auf dem Gerät fertig bearbeitet sind; die Testausführung wird bereits nach dem Anstoßen der Aktion fortgesetzt. Die nächste Aktion sollte aber erst gestartet werden, wenn die vorherige abgeschlossen ist. Wenn das Ende der Aktion durch die Änderung eines Elements gekennzeichnet ist, können Sie den Baustein ''Wait For Element'' benutzen, um darauf zu warten. Formulieren Sie dafür den XPath zu diesem Element so, dass er erst nach der Änderung gültig wird. Falls Sie das Element ohnehin in der nächsten Aktion verwenden wollen, können Sie den XPath direkt für den entsprechenden Baustein verwenden, da dieser grundsätzlich wartet bis das Element auftaucht.

	== Verbindungsabbau ==		== Verbindungsabbau ==

Matilk: /* Tests mit dem Appium-Recorder erstellen */

2016-09-20T17:28:53Z

Tests mit dem Appium-Recorder erstellen

← Nächstältere Version		Version vom 20. September 2016, 17:28 Uhr
Zeile 105:		Zeile 105:
	Sie können aus folgenden Aktionen wählen:		Sie können aus folgenden Aktionen wählen:
	* Aktionen		* Aktionen
	** ''Wischen'': Wischen über den Bildschirm von der Position, an der Sie die ~~Maus~~ drücken, bis zu der Position, an der Sie sie wieder loslassen. Die Dauer wird ebenfalls berücksichtigt		** ''Wischen'': Wischen über den Bildschirm von der Position, an der Sie die Maustaste drücken, bis zu der Position, an der Sie sie wieder loslassen. Die Dauer wird ebenfalls berücksichtigt
	** ''Antippen'': Antippen des Bildschirms an der Cursorposition mit der selben Dauer wie Sie Ihre ~~Maus~~ gedrückt halten (hilfreich für Long-Clicks)		** ''Antippen'': Antippen des Bildschirms an der Cursorposition mit der selben Dauer wie Sie Ihre Maustaste gedrückt halten (hilfreich für Long-Clicks)
	** ''Element antippen'': wie Antippen, aber für das Element an der Cursorposition		** ''Element antippen'': wie Antippen, aber für das Element an der Cursorposition
	** ''Berühren'': kurzes Berühren des Elements an der Cursorposition (Click)		** ''Berühren'': kurzes Berühren des Elements an der Cursorposition (Click)

Mawalch: Capabilities nicht mehr zu Capabilitys eindeutschen

2016-08-31T13:26:27Z

Capabilities nicht mehr zu Capabilitys eindeutschen

← Nächstältere Version		Version vom 15. Juli 2017, 09:11 Uhr
Zeile 10:		Zeile 10:

	Das zweite Kapitel dieser Dokumentation beschreibt das Einrichten und die Verwendung des Mobile Plugins.		Das zweite Kapitel dieser Dokumentation beschreibt das Einrichten und die Verwendung des Mobile Plugins.
	Der erste Abschnitt des Kapitels erläutert die Installation des Appium-Bundles auf Ihrem Betriebssystem, einer von eXept erstellten Zusammenstellung von Appium, dem Android SDK und dem JDK. Sollten Sie das Bundle bereits installiert haben, so können Sie diesen Abschnitt überspringen.		Der erste Abschnitt des Kapitels erläutert die Installation des Appium-Bundles auf Ihrem Betriebssystem, einer von eXept erstellten Zusammenstellung von Appium, dem Android SDK und dem JDK. Sollten Sie das Bundle bereits installiert haben, so können Sie diesen Abschnitt überspringen.
	In den folgenden Abschnitten wird beschrieben, wie Sie sich mit einem Gerät verbinden können und welche Möglichkeiten sich bieten, um eine Anwendung zu steuern und Tests zu erstellen.		In den folgenden Abschnitten wird beschrieben, wie Sie sich mit einem Gerät verbinden können und welche Möglichkeiten sich bieten, um eine Anwendung zu steuern und Tests zu erstellen.

Zeile 18:		Zeile 18:

	== Installation des Bundles==		== Installation des Bundles==


	Um schnell Ihre ersten Schritte mit dem mobilen Testen in expecco durchzuführen, laden Sie das [http://download.exept.de/transfer/h-expecco-2.9.0/AppiumBundleSetup.exe Appium Bundle Setup] von unserer Homepage herunter. Dieses vereint Inhalte von Drittanbietern, die zum Auslesen und Steuern von Mobilgeräten benötigt werden. Zum einen installiert es Appium, auf dem das Plugin größtenteils aufbaut. Außerdem können Sie damit auch wahlweise einen universellen adb-Treiber ([http://download.clockworkmod.com/test/UniversalAdbDriverSetup.msi ClockworkMod]) installieren, mit dem Sie unter Windows eine Vielzahl von Geräten verwenden können. Natürlich können Sie auch selbst Appium oder Treiber für jedes Ihrer Geräte installieren.		Um schnell Ihre ersten Schritte mit dem mobilen Testen in expecco durchzuführen, laden Sie das [http://download.exept.de/transfer/h-expecco-2.9.0/AppiumBundleSetup.exe Appium Bundle Setup] von unserer Homepage herunter. Dieses vereint Inhalte von Drittanbietern, die zum Auslesen und Steuern von Mobilgeräten benötigt werden. Zum einen installiert es Appium, auf dem das Plugin größtenteils aufbaut. Außerdem können Sie damit auch wahlweise einen universellen adb-Treiber ([http://download.clockworkmod.com/test/UniversalAdbDriverSetup.msi ClockworkMod]) installieren, mit dem Sie unter Windows eine Vielzahl von Geräten verwenden können. Natürlich können Sie auch selbst Appium oder Treiber für jedes Ihrer Geräte installieren.

Zeile 26:		Zeile 26:

	== Appium-Server starten ==		== Appium-Server starten ==


	Das Appium Bundle beinhaltet einen Appium-Server, der die Kommunikation zwischen expecco und dem Testgerät ermöglicht. Sie können diesen direkt über den Menüpunkt ''Erweiterungen'' > ''Appium'' > ''Appium starten'' starten. Alternativ können Sie auch die Verknüpfung auf dem Desktop benutzen, die während der Installation angelegt wurde, oder die Batchdatei "start_appium.bat" im Installationsverzeichnis des Bundles. Es öffnet sich ein Fenster mit einer Konsole über die der Server läuft und in der seine Lognachrichten ausgegeben werden. Der Server ist bereit, sobald die ersten Lognachrichten erscheinen.		Das Appium Bundle beinhaltet einen Appium-Server, der die Kommunikation zwischen expecco und dem Testgerät ermöglicht. Sie können diesen direkt über den Menüpunkt ''Erweiterungen'' > ''Appium'' > ''Appium starten'' starten. Alternativ können Sie auch die Verknüpfung auf dem Desktop benutzen, die während der Installation angelegt wurde, oder die Batchdatei "start_appium.bat" im Installationsverzeichnis des Bundles. Es öffnet sich ein Fenster mit einer Konsole über die der Server läuft und in der seine Lognachrichten ausgegeben werden. Der Server ist bereit, sobald die ersten Lognachrichten erscheinen.

Zeile 33:		Zeile 33:
	Das Plugin unterstützt Android-Geräte ab der Version 2.3.3. Wenn Sie ein Android-Gerät unter Windows anschließen benötigen Sie möglicherweise noch einen adb-Treiber für das Gerät. Einen passenden Treiber finden Sie üblicherweise auf der jeweiligen Webseite des Herstellers. Haben Sie den Universal-Treiber aus dem Bundle installiert, sollte bereits alles funktionieren und das Gerät korrekt erkannt werden.		Das Plugin unterstützt Android-Geräte ab der Version 2.3.3. Wenn Sie ein Android-Gerät unter Windows anschließen benötigen Sie möglicherweise noch einen adb-Treiber für das Gerät. Einen passenden Treiber finden Sie üblicherweise auf der jeweiligen Webseite des Herstellers. Haben Sie den Universal-Treiber aus dem Bundle installiert, sollte bereits alles funktionieren und das Gerät korrekt erkannt werden.

	Bevor Sie ein Mobilgerät mit dem Appium-Plugin ansteuern können, müssen Sie für dieses Debugging erlauben. Für Android-Geräte finden Sie diese Option in den Einstellungen unter ''Entwickleroptionen'' mit dem Namen ''USB-Debugging'' (siehe https://www.droidwiki.de/USB-Debugging). Für iOS-Geräte ab iOS 8 finden Sie diese Option in den Einstellungen unter ''Entwickler'' mit dem Namen ''Enable UI Automation''. Beim Verbinden des Geräts mit dem PC über USB müssen Sie ggf. am Gerät noch der Verbindung zustimmen.		Bevor Sie ein Mobilgerät mit dem Appium-Plugin ansteuern können, müssen Sie für dieses Debugging erlauben. Für Android-Geräte finden Sie diese Option in den Einstellungen unter ''Entwickleroptionen'' mit dem Namen ''USB-Debugging'' (siehe https://www.droidwiki.org/USB-Debugging). Für iOS-Geräte ab iOS 8 finden Sie diese Option in den Einstellungen unter ''Entwickler'' mit dem Namen ''Enable UI Automation''. Beim Verbinden des Geräts mit dem PC über USB müssen Sie ggf. am Gerät noch der Verbindung zustimmen.

	== Verbindungsaufbau über den Appium-Verbindungsdialog ==		== Verbindungsaufbau über den Appium-Verbindungsdialog ==
Zeile 88:		Zeile 88:
	:* ''app'' Geben Sie hier den Pfad zu einer .app oder .ipa Datei an		:* ''app'' Geben Sie hier den Pfad zu einer .app oder .ipa Datei an

	Für eine Verbindung zu Android-Geräten mit einer Version vor 4.3 ist zudem die Capability ''automationName'' wichtig. Sie gibt an, welche Automation-Engine benutzt wird. Möglich sind Selenium und Appium. Für Android-Geräte mit einer Version vor 4.1 muss hier Selendroid ausgewählt werden, da eine Verbindung mit Appium nicht möglich ist. Die Verwendung von Selendroid ist langsamer als Appium, außerdem sind die Eigenschaften der Elemente anders benannt. Erst ab Android Version 4.3 kann Appium umfangreiche Informationen zu Eigenschaften der Elemente erhalten. Für Versionen vor 4.3 kann es somit nützlich sein Selendroid zu verwendet, weil hiermit mehr Eigenschaften zur Verfügung stehen. Wird die Capability nicht angegeben, ist als Voreinstellung Appium gesetzt.		Für eine Verbindung zu Android-Geräten mit einer Version vor 4.3 ist zudem die Capability ''automationName'' wichtig. Sie gibt an, welche Automation-Engine benutzt wird. Möglich sind Selenium und Appium. Für Android-Geräte mit einer Version vor 4.1 muss hier Selendroid ausgewählt werden, da eine Verbindung mit Appium nicht möglich ist. Die Verwendung von Selendroid ist langsamer als Appium, außerdem sind die Eigenschaften der Elemente anders benannt. Erst ab Android Version 4.3 kann Appium umfangreiche Informationen zu Eigenschaften der Elemente erhalten. Für Versionen vor 4.3 kann es somit nützlich sein Selendroid zu verwendet, weil hiermit mehr Eigenschaften zur Verfügung stehen. Wird die Capability nicht angegeben, ist als Voreinstellung Appium gesetzt.

	Weitere Informationen zu verfügbaren Capabilities finden Sie unter:		Weitere Informationen zu verfügbaren Capabilities finden Sie unter:
Zeile 100:		Zeile 100:

	== Tests mit dem Appium-Recorder erstellen ==		== Tests mit dem Appium-Recorder erstellen ==


	Nachdem Sie die Verbindung zu einem Gerät hergestellt haben, können Sie im GUI-Browser den Appium-Recorder über das Aufnahme-Symbol starten.		Nachdem Sie die Verbindung zu einem Gerät hergestellt haben, können Sie im GUI-Browser den Appium-Recorder über das Aufnahme-Symbol starten.

Zeile 132:		Zeile 132:
	== Hinweise zur Verwendung mit iOS ==		== Hinweise zur Verwendung mit iOS ==
	Ein iOS-Gerät kann nur getestet werden, wenn es an einen Mac angeschlossen ist, auf dem [https://itunes.apple.com/en/app/xcode/id497799835?mt=12 Xcode] installiert ist. Um iOS-Geräte mit expecco zu testen ist es daher notwendig, dass ein Appium-Server auf einem solchen Mac gestartet wird und dessen Adresse dann in den Verbindungseinstellungen angegeben wird.		Ein iOS-Gerät kann nur getestet werden, wenn es an einen Mac angeschlossen ist, auf dem [https://itunes.apple.com/en/app/xcode/id497799835?mt=12 Xcode] installiert ist. Um iOS-Geräte mit expecco zu testen ist es daher notwendig, dass ein Appium-Server auf einem solchen Mac gestartet wird und dessen Adresse dann in den Verbindungseinstellungen angegeben wird.
	Für Tests auf realen iOS-Geräten ist zu beachten, dass nur Apps verwendet werden können, die als Development Distribution signiert sind und für die das Gerät zum entsprechenden Provisioning Profile gehört. Insbesondere kann dadurch die App während des Testens nicht verlassen werden, da außerhalb keine Steuerung über Appium zugelassen wird.		Für Tests auf realen iOS-Geräten ist zu beachten, dass nur Apps verwendet werden können, die als Development Distribution signiert sind und für die das Gerät zum entsprechenden Provisioning Profile gehört. Insbesondere kann dadurch die App während des Testens nicht verlassen werden, da außerhalb keine Steuerung über Appium zugelassen wird.

	http://appium.io/slate/en/master/?java#appium-on-real-ios-devices		http://appium.io/slate/en/master/?java#appium-on-real-ios-devices

← Nächstältere Version		Version vom 28. Mai 2017, 20:15 Uhr
Zeile 11:		Zeile 11:
	Das zweite Kapitel dieser Dokumentation beschreibt das Einrichten und die Verwendung des Mobile Plugins.		Das zweite Kapitel dieser Dokumentation beschreibt das Einrichten und die Verwendung des Mobile Plugins.
	Der erste Abschnitt des Kapitels erläutert die Installation des Appium-Bundles auf Ihrem Betriebssystem, einer von eXept erstellten Zusammenstellung von Appium, dem Android SDK und dem JDK. Sollten Sie das Bundle bereits installiert haben, so können Sie diesen Abschnitt überspringen.		Der erste Abschnitt des Kapitels erläutert die Installation des Appium-Bundles auf Ihrem Betriebssystem, einer von eXept erstellten Zusammenstellung von Appium, dem Android SDK und dem JDK. Sollten Sie das Bundle bereits installiert haben, so können Sie diesen Abschnitt überspringen.
	In den ~~flogenden~~ Abschnitten wird beschrieben, wie Sie sich mit einem Gerät verbinden können und welche Möglichkeiten sich bieten, um eine Anwendung zu steuern und Tests zu erstellen.		In den folgenden Abschnitten wird beschrieben, wie Sie sich mit einem Gerät verbinden können und welche Möglichkeiten sich bieten, um eine Anwendung zu steuern und Tests zu erstellen.

	Um einen praktischen Eindruck von unserer Appium-Implementierung zu bekommen, wird im dritten Kapitels ein kurzes Tutorial beschrieben, wie Sie einen Test ausführen und erstellen können. Im vierten Kapitel finden Sie ein weiteres Beispiel.		Um einen praktischen Eindruck von unserer Appium-Implementierung zu bekommen, wird im dritten Kapitels ein kurzes Tutorial beschrieben, wie Sie einen Test ausführen und erstellen können. Im vierten Kapitel finden Sie ein weiteres Beispiel.
Zeile 71:		Zeile 71:
	* ''plattformName'' Wählen Sie hier aus, ob Sie eine Android-App oder eine iOS-App automatisieren wollen.		* ''plattformName'' Wählen Sie hier aus, ob Sie eine Android-App oder eine iOS-App automatisieren wollen.
	* ''deviceName'' Geben Sie die Art des Geräts an, das verwendet werden soll. Für iOS erfahren Sie gültige Einträge mit ''instruments -s devices''. Für Android wird die Angabe zwar ignoriert, muss aber gemacht werden.		* ''deviceName'' Geben Sie die Art des Geräts an, das verwendet werden soll. Für iOS erfahren Sie gültige Einträge mit ''instruments -s devices''. Für Android wird die Angabe zwar ignoriert, muss aber gemacht werden.
	* ''udid'' Geben Sie hier den Identifier des Mobilgeräts an, auf welchem Sie die App automatisieren wollen. Eine Liste der verfügbaren Android-Geräte erhalten Sie mit ''adb devices -l'', z.B. ''emulator-5554''. Für iOS-Geräte finden Sie den Identifier im Eintrag des Geräts in ~~XCode~~.		* ''udid'' Geben Sie hier den Identifier des Mobilgeräts an, auf welchem Sie die App automatisieren wollen. Eine Liste der verfügbaren Android-Geräte erhalten Sie mit ''adb devices -l'', z.B. ''emulator-5554''. Für iOS-Geräte finden Sie den Identifier im Eintrag des Geräts in Xcode.

	Für Android-Apps sind folgende Capabilities zusätzlich notwendig:		Für Android-Apps sind folgende Capabilities zusätzlich notwendig:
Zeile 88:		Zeile 88:
	:* ''app'' Geben Sie hier den Pfad zu einer .app oder .ipa Datei an		:* ''app'' Geben Sie hier den Pfad zu einer .app oder .ipa Datei an

	Für eine Verbindung zu Android-Geräten mit einer Version vor 4.3 ist zudem die Capability ''automationName'' wichtig. Sie gibt an, welche Automation-Engine benutzt wird. Möglich sind Selenium und Appium. Für Android-Geräte mit einer Version vor 4.1 muss hier Selendroid ausgewählt werden, da eine Verbindung mit Appium nicht möglich ist. Die Verwendung von Selendroid ist langsamer als Appium, außerdem sind die Eigenschaften der Elemente anders benannt. Erst ab Android Version 4.3 kann Appium umfangreiche Informationen zu Eigenschaften der Elemente erhalten. Für Versionen vor 4.3 kann es somit nützlich sein Selendroid zu verwendet, weil hiermit mehr Eigenschaften zur Verfügung stehen. Wird die Capability nicht angegeben, ist als ~~Voreintstellung~~ Appium gesetzt.		Für eine Verbindung zu Android-Geräten mit einer Version vor 4.3 ist zudem die Capability ''automationName'' wichtig. Sie gibt an, welche Automation-Engine benutzt wird. Möglich sind Selenium und Appium. Für Android-Geräte mit einer Version vor 4.1 muss hier Selendroid ausgewählt werden, da eine Verbindung mit Appium nicht möglich ist. Die Verwendung von Selendroid ist langsamer als Appium, außerdem sind die Eigenschaften der Elemente anders benannt. Erst ab Android Version 4.3 kann Appium umfangreiche Informationen zu Eigenschaften der Elemente erhalten. Für Versionen vor 4.3 kann es somit nützlich sein Selendroid zu verwendet, weil hiermit mehr Eigenschaften zur Verfügung stehen. Wird die Capability nicht angegeben, ist als Voreinstellung Appium gesetzt.

	Weitere Informationen zu verfügbaren Capabilities finden Sie unter:		Weitere Informationen zu verfügbaren Capabilities finden Sie unter:

← Nächstältere Version		Version vom 31. August 2016, 13:26 Uhr
Zeile 46:		Zeile 46:
	Falls Sie sich mit einem Server auf einem anderen Rechner oder Port verbinden wollen, passen Sie die IP-Adresse und die Portnummer entsprechend an.		Falls Sie sich mit einem Server auf einem anderen Rechner oder Port verbinden wollen, passen Sie die IP-Adresse und die Portnummer entsprechend an.

	Als nächstes müssen Sie die Konfiguration für die Verbindung angeben. Der Appium-Server verlangt hierfür die Angabe sogenannter ~~Capabilitys~~.		Als nächstes müssen Sie die Konfiguration für die Verbindung angeben. Der Appium-Server verlangt hierfür die Angabe sogenannter Capabilities.

	Für Tests unter Android empfiehlt es sich, hierfür den Android-Assistenten zu verwenden. Der Android-Assistent ermöglicht es Ihnen, die ~~Capabilitys~~ für beliebige über USB angeschlossene Geräte automatisch auszufüllen.		Für Tests unter Android empfiehlt es sich, hierfür den Android-Assistenten zu verwenden. Der Android-Assistent ermöglicht es Ihnen, die Capabilities für beliebige über USB angeschlossene Geräte automatisch auszufüllen.

	[[Datei:Appium GUI AndroidWizard.png\|border\|600px\|]]		[[Datei:Appium GUI AndroidWizard.png\|border\|600px\|]]
Zeile 57:		Zeile 57:
	[[Datei:Appium Settings showSystemPackages.png\|border\|400px\|]]		[[Datei:Appium Settings showSystemPackages.png\|border\|400px\|]]

	Wählen Sie im obersten Feld das Gerät aus, mit dem Sie sich verbinden wollen. In der Liste des Dropdown-Menüs finden Sie alle erreichbaren Geräte. Daraufhin werden die auf dem Gerät vorhandenen Pakete abgerufen, dies kann einen Moment dauern. Ein Paket entspricht in der Regel einer installierten App. Die Pakete werden in Fremdpakete und Systempakete unterteilt. Von Ihnen installierte Anwendungen befinden sich unter den Fremdpaketen. Haben Sie noch keine Anwendung installiert, können Sie beispielsweise auch den Taschenrechner auswählen, der sich bereits auf dem Gerät befindet. Wählen Sie dazu die Systempakete aus. Im Eingabefeld darunter können Sie einen Filter eingeben, um die Liste der Pakete zu verkleinern. Geben Sie ''Calc'' als Filter ein und Sie finden Ihren Taschenrechner einfacher. (Das Paket heißt je nach Gerät verschieden, hat aber ''calculator'' im Namen.) Wählen Sie im Dropdown-Menü das gewünschte Paket aus und anschließend im untersten Dropdown-Menü eine Activity aus diesem Paket (z. B. ''.Calculator''). Durch Klicken auf OK werden die ~~Capabilitys~~ entsprechend Ihrer Auswahl gesetzt.		Wählen Sie im obersten Feld das Gerät aus, mit dem Sie sich verbinden wollen. In der Liste des Dropdown-Menüs finden Sie alle erreichbaren Geräte. Daraufhin werden die auf dem Gerät vorhandenen Pakete abgerufen, dies kann einen Moment dauern. Ein Paket entspricht in der Regel einer installierten App. Die Pakete werden in Fremdpakete und Systempakete unterteilt. Von Ihnen installierte Anwendungen befinden sich unter den Fremdpaketen. Haben Sie noch keine Anwendung installiert, können Sie beispielsweise auch den Taschenrechner auswählen, der sich bereits auf dem Gerät befindet. Wählen Sie dazu die Systempakete aus. Im Eingabefeld darunter können Sie einen Filter eingeben, um die Liste der Pakete zu verkleinern. Geben Sie ''Calc'' als Filter ein und Sie finden Ihren Taschenrechner einfacher. (Das Paket heißt je nach Gerät verschieden, hat aber ''calculator'' im Namen.) Wählen Sie im Dropdown-Menü das gewünschte Paket aus und anschließend im untersten Dropdown-Menü eine Activity aus diesem Paket (z. B. ''.Calculator''). Durch Klicken auf OK werden die Capabilities entsprechend Ihrer Auswahl gesetzt.

	[[Datei:AppiumSettingsWizard.png\| 600px\|]]		[[Datei:AppiumSettingsWizard.png\| 600px\|]]

	Für weitergehende Einstellungen können Sie die ~~Capabilitys~~ auch manuell einzutragen. Wählen Sie dazu links unten aus der Dropdownbox die gewünschten ~~Capabilitys~~ aus. Um sie der Konfiguration hinzuzufügen, klicken Sie auf ''Hinzufügen''. Danach können Sie in der Liste im Dialog die entsprechenden Werte für die einzelnen ~~Capabilitys~~ eingeben. Mit ''Entfernen'' können Sie eingetragene ~~Capabilitys~~ wieder aus der Liste löschen.		Für weitergehende Einstellungen können Sie die Capabilities auch manuell einzutragen. Wählen Sie dazu links unten aus der Dropdownbox die gewünschten Capabilities aus. Um sie der Konfiguration hinzuzufügen, klicken Sie auf ''Hinzufügen''. Danach können Sie in der Liste im Dialog die entsprechenden Werte für die einzelnen Capabilities eingeben. Mit ''Entfernen'' können Sie eingetragene Capabilities wieder aus der Liste löschen.

	Die folgenden ~~Capabilitys~~ sind für einen Verbindungsaufbau notwendig:		Die folgenden Capabilities sind für einen Verbindungsaufbau notwendig:

	* ''plattformName'' Wählen Sie hier aus, ob Sie eine Android-App oder eine iOS-App automatisieren wollen.		* ''plattformName'' Wählen Sie hier aus, ob Sie eine Android-App oder eine iOS-App automatisieren wollen.
Zeile 69:		Zeile 69:
	* ''udid'' Geben Sie hier den Identifier des Mobilgeräts an, auf welchem Sie die App automatisieren wollen. Eine Liste der verfügbaren Android-Geräte erhalten Sie mit ''adb devices -l'', z.B. ''emulator-5554''. Für iOS-Geräte finden Sie den Identifier im Eintrag des Geräts in XCode.		* ''udid'' Geben Sie hier den Identifier des Mobilgeräts an, auf welchem Sie die App automatisieren wollen. Eine Liste der verfügbaren Android-Geräte erhalten Sie mit ''adb devices -l'', z.B. ''emulator-5554''. Für iOS-Geräte finden Sie den Identifier im Eintrag des Geräts in XCode.

	Für Android-Apps sind folgende ~~Capabilitys~~ zusätzlich notwendig:		Für Android-Apps sind folgende Capabilities zusätzlich notwendig:

	: installierte App benutzen		: installierte App benutzen
Zeile 77:		Zeile 77:
	:* ''app'' Geben Sie hier den Pfad zu einer .apk Datei an		:* ''app'' Geben Sie hier den Pfad zu einer .apk Datei an

	Für iOS-Apps sind folgende ~~Capabilitys~~ zusätzlich notwendig:		Für iOS-Apps sind folgende Capabilities zusätzlich notwendig:

	: installierte App benutzen		: installierte App benutzen
Zeile 86:		Zeile 86:
	Für eine Verbindung zu Android-Geräten mit einer Version vor 4.3 ist zudem die Capability ''automationName'' wichtig. Sie gibt an, welche Automation-Engine benutzt wird. Möglich sind Selenium und Appium. Für Android-Geräte mit einer Version vor 4.1 muss hier Selendroid ausgewählt werden, da eine Verbindung mit Appium nicht möglich ist. Die Verwendung von Selendroid ist langsamer als Appium, außerdem sind die Eigenschaften der Elemente anders benannt. Erst ab Android Version 4.3 kann Appium umfangreiche Informationen zu Eigenschaften der Elemente erhalten. Für Versionen vor 4.3 kann es somit nützlich sein Selendroid zu verwendet, weil hiermit mehr Eigenschaften zur Verfügung stehen. Wird die Capability nicht angegeben, ist als Voreintstellung Appium gesetzt.		Für eine Verbindung zu Android-Geräten mit einer Version vor 4.3 ist zudem die Capability ''automationName'' wichtig. Sie gibt an, welche Automation-Engine benutzt wird. Möglich sind Selenium und Appium. Für Android-Geräte mit einer Version vor 4.1 muss hier Selendroid ausgewählt werden, da eine Verbindung mit Appium nicht möglich ist. Die Verwendung von Selendroid ist langsamer als Appium, außerdem sind die Eigenschaften der Elemente anders benannt. Erst ab Android Version 4.3 kann Appium umfangreiche Informationen zu Eigenschaften der Elemente erhalten. Für Versionen vor 4.3 kann es somit nützlich sein Selendroid zu verwendet, weil hiermit mehr Eigenschaften zur Verfügung stehen. Wird die Capability nicht angegeben, ist als Voreintstellung Appium gesetzt.

	Weitere Informationen zu verfügbaren ~~Capabilitys~~ finden Sie unter:		Weitere Informationen zu verfügbaren Capabilities finden Sie unter:

	http://appium.io/slate/en/master/?java#appium-server-capabilities		http://appium.io/slate/en/master/?java#appium-server-capabilities


	Nachdem Sie alle gewünschten ~~Capabilitys~~ hinzugefügt haben, können Sie mit ''Sichern in Anhang'' beziehungsweise ''Sichern in Datei'' Ihre Einstellungen als Anhang der Testsuite oder in einer Datei speichern. Diese können Sie dann beim nächsten Mal über ''Laden aus Anhang'' und ''Laden aus Datei'' einlesen oder auch in den Tests verwenden.		Nachdem Sie alle gewünschten Capabilities hinzugefügt haben, können Sie mit ''Sichern in Anhang'' beziehungsweise ''Sichern in Datei'' Ihre Einstellungen als Anhang der Testsuite oder in einer Datei speichern. Diese können Sie dann beim nächsten Mal über ''Laden aus Anhang'' und ''Laden aus Datei'' einlesen oder auch in den Tests verwenden.

	Mit einem Klick auf ''Verbinden'' starten Sie den Verbindungsaufbau mit den angegebenen Einstellungen.		Mit einem Klick auf ''Verbinden'' starten Sie den Verbindungsaufbau mit den angegebenen Einstellungen.
Zeile 118:		Zeile 118:
	Beim Aufnehmen der Aktionen werden die Bausteine im Arbeitsbereich lediglich linear angelegt. Sie können den Ablauf dort aber auch einfach ändern, zum Beispiel wenn Sie Verzweigungsbausteine verwenden oder zusätzliche Bausteine einfügen wollen. Über das Icon in der rechten oberen Ecke können Sie den Arbeitsbereich als neuen Baustein in Ihrer Testsuite anlegen.		Beim Aufnehmen der Aktionen werden die Bausteine im Arbeitsbereich lediglich linear angelegt. Sie können den Ablauf dort aber auch einfach ändern, zum Beispiel wenn Sie Verzweigungsbausteine verwenden oder zusätzliche Bausteine einfügen wollen. Über das Icon in der rechten oberen Ecke können Sie den Arbeitsbereich als neuen Baustein in Ihrer Testsuite anlegen.

	Um später Tests mit diesen Bausteinen ausführen zu können, müssen Sie am Anfang des Tests den ''Connect''-Baustein aus der Appium-Library einbauen und am Ende entsprechend ein ''Disconnect''. Zur Erzeugung der ~~Capabilitys~~ für den ''Connect''-Baustein können Sie den Baustein ''Read Capabilities from File'' verwenden, der eine im Verbindungsdialog erstellte Datei einlesen kann.		Um später Tests mit diesen Bausteinen ausführen zu können, müssen Sie am Anfang des Tests den ''Connect''-Baustein aus der Appium-Library einbauen und am Ende entsprechend ein ''Disconnect''. Zur Erzeugung der Capabilities für den ''Connect''-Baustein können Sie den Baustein ''Read Capabilities from File'' verwenden, der eine im Verbindungsdialog erstellte Datei einlesen kann.

	== Verbindungsabbau ==		== Verbindungsabbau ==
Zeile 133:		Zeile 133:

	== Schritt 1: Demo ausführen ==		== Schritt 1: Demo ausführen ==
	Eine Demo zum Testen mit Android finden Sie unter den Demo-Testsuiten für expecco mit dem Namen m02_expeccoMobileDemo.ets. Öffnen Sie diese in expecco. Darin befindet sich ein einfacher Testplan ''Demo-Test''. Dieser installiert die App expeccoMobileDemo, führt einige Tests aus und löscht die App am Ende wieder. Unter dem Baustein ''Connect to Demo App'' befindet sich die Installationsdatei der App (''expeccoMobileDemo-debug.apk'') sowie die Datei ''expeccoMobileDemo Capabilities''. Diese enthält die ~~Capabilitys~~, also die Einstellungen zur Verbindung. Hier müssen Sie das Gerät eintragen, das Sie verwenden. Standardmäßig ist ''emulator-5554'' als ''deviceName'' und ''uuid'' eingetragen. Falls Sie einen Emulator gestartet haben, können Sie die Einstellungen bereits so verwenden. Ansonsten können Sie die benötigte ID mit Hilfe des Android-Assistenten erfahren. Öffnen Sie dazu den GUI-Browser [[Datei:GuiBrowser-Icon.png\|Icon des GUI-Browsers]] und wählen Sie unter ''Verbinden'' den Eintrag ''Appium''. Es wird der Verbindungsdialog geöffnet, in dem Sie oben auf ''Android-Assistent'' klicken. Dort können Sie nun das gewünschte Gerät auswählen, das der Assistent dann in den ~~Capabilitys~~ im Verbindungsdialog setzt. Diesen Wert für ''deviceName'' und ''uuid'' übernehmen Sie in die Datei ''expeccoMobileDemo Capabilities''. Den Verbindungsdialog können Sie schließen, da der Testplan selbst eine Verbindung erstellen wird.		Eine Demo zum Testen mit Android finden Sie unter den Demo-Testsuiten für expecco mit dem Namen m02_expeccoMobileDemo.ets. Öffnen Sie diese in expecco. Darin befindet sich ein einfacher Testplan ''Demo-Test''. Dieser installiert die App expeccoMobileDemo, führt einige Tests aus und löscht die App am Ende wieder. Unter dem Baustein ''Connect to Demo App'' befindet sich die Installationsdatei der App (''expeccoMobileDemo-debug.apk'') sowie die Datei ''expeccoMobileDemo Capabilities''. Diese enthält die Capabilities, also die Einstellungen zur Verbindung. Hier müssen Sie das Gerät eintragen, das Sie verwenden. Standardmäßig ist ''emulator-5554'' als ''deviceName'' und ''uuid'' eingetragen. Falls Sie einen Emulator gestartet haben, können Sie die Einstellungen bereits so verwenden. Ansonsten können Sie die benötigte ID mit Hilfe des Android-Assistenten erfahren. Öffnen Sie dazu den GUI-Browser [[Datei:GuiBrowser-Icon.png\|Icon des GUI-Browsers]] und wählen Sie unter ''Verbinden'' den Eintrag ''Appium''. Es wird der Verbindungsdialog geöffnet, in dem Sie oben auf ''Android-Assistent'' klicken. Dort können Sie nun das gewünschte Gerät auswählen, das der Assistent dann in den Capabilities im Verbindungsdialog setzt. Diesen Wert für ''deviceName'' und ''uuid'' übernehmen Sie in die Datei ''expeccoMobileDemo Capabilities''. Den Verbindungsdialog können Sie schließen, da der Testplan selbst eine Verbindung erstellen wird.

	Starten Sie nun den Appium-Server (siehe [[#Appium-Server starten\|Appium-Server starten]]). Nun können Sie den Testplan starten. Dieser sollte ohne Fehler durchlaufen. Der Testplan besteht aus mehreren Testcases, die hintereinander ausgeführt werden. Zudem wird je ein Baustein vor und nach der Ausführung ausgeführt, der den Verbindungsauf- bzw. -abbau zur App vornimmt. Insbesondere der Verbindungsabbau geschieht auf diese Weise auch dann, wenn einer der Testcases fehlschlägt und der Test abgebrochen wird.		Starten Sie nun den Appium-Server (siehe [[#Appium-Server starten\|Appium-Server starten]]). Nun können Sie den Testplan starten. Dieser sollte ohne Fehler durchlaufen. Der Testplan besteht aus mehreren Testcases, die hintereinander ausgeführt werden. Zudem wird je ein Baustein vor und nach der Ausführung ausgeführt, der den Verbindungsauf- bzw. -abbau zur App vornimmt. Insbesondere der Verbindungsabbau geschieht auf diese Weise auch dann, wenn einer der Testcases fehlschlägt und der Test abgebrochen wird.