https://doc.expecco.de/api.php?action=feedcontributions&feedformat=atom&user=Chzeiher expecco Wiki (Version 25.x) - Benutzerbeiträge [de] 2026-04-26T03:15:59Z Benutzerbeiträge MediaWiki 1.44.2 https://doc.expecco.de/index.php?title=Datei:OPCUATutorial.mp4&diff=15200 Datei:OPCUATutorial.mp4 2019-02-28T10:28:30Z <p>Chzeiher: Video ohne Ton für weitere Bearbeitung (Beachte Werbung links unten weil Freeware Aufnahme. also evtl alles nochmal neu)</p> <hr /> <div>Video ohne Ton für weitere Bearbeitung (Beachte Werbung links unten weil Freeware Aufnahme. also evtl alles nochmal neu)</div> Chzeiher https://doc.expecco.de/index.php?title=Tutorials&diff=15199 Tutorials 2019-02-28T10:08:34Z <p>Chzeiher: /* Erste Schritte OPCUA */</p> <hr /> <div>= Erste Schritte mit expecco =<br /> <br /> Die ersten Schritte richten sich an alle, die expecco zum ersten Mal benutzen und sollen als erste Starthilfe dienen. Anhand eines einfachen Beispiels wollen wir Ihnen einen Überblick über expecco verschaffen. Es empfiehlt sich expecco parallel zum Tutorial zu starten um alle Schritte innerhalb von expecco nachvollziehen zu können.<br /> <br /> [[Medium:Erste_Schritte_mit_expecco.pdf|Erste Schritte mit expecco.pdf]]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte mit Android =<br /> <br /> Mit dem Mobile Testing Plugin lassen sich Tests für Apps auf Android- oder iOS-Mobilgeräten erstellen und ausführen. Dieses Tutorial beschreibt das grundsätzliche Vorgehen anhand eines mit gelieferten Beispiels für Android, bestehend aus einer einfachen App und einer expecco-Testsuite. Die App expecco Mobile Demo berechnet und überprüft verschiedene alltägliche Codes: die IBAN aus dem europäischen Zahlungsverkehr, die internationalen GTIN-13-Produktcodes, wie man sie bei Strichcodes im Einzelhandel findet, und die Seriennummern auf Euro-Banknoten. Die Testsuite enthält Testfälle für einzelne Funktionen der App. Dabei sind noch nicht alle Funktionen abgedeckt, sondern werden im Laufe des Tutorials ergänzt.<br /> <br /> '''&quot;Erste Schritte mit Android&quot; als pdf:'''<br /> <br /> [[Medium:Erste_Schritte_mit_Android.pdf|Erste Schritte mit Android.pdf]]<br /> <br /> '''Tutorial als Video bei &quot;YouTube&quot;:'''<br /> <br /> [https://www.youtube.com/watch?v=H8H4gQO_Tx8 Testing with Android]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte Web Test =<br /> <br /> Dieses Tutorial führt Sie in das Testen bzw. Automatisieren von Web-Anwendungen in Browsern (chrome, firefox, edge, etc.) ein.<br /> <br /> *[[Web Test Tutorial - Teil 1]]<br /> *[[Web Test Tutorial - Teil 2]]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte Manueller Test =<br /> <br /> In diesem Tutorial erfahren Sie, wie geführte manuelle Tests mit expecco durchgeführt werden können.<br /> Manuel Tests können aus bestehenden Testfallbeschreibungen (aus Excel oder anderen Dokumenten) importiert werden,<br /> und danach schrittweise teil- oder vollautomatisiert werden.<br /> <br /> *[[Manueller Test Tutorial]]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte Scripting =<br /> <br /> *[[Scripting Tutorial]]<br /> <br /> &lt;br&gt;<br /> = Erste Schritte OPCUA=<br /> <br /> *[[OPC/en|Kurzbeschreibung zur OPC Library]]<br /> [[Datei:OPCUATutorial.mp4|Video Tutorial]] <br /> <br /> &lt;br&gt;<br /> <br /> = Bibliotheken =<br /> <br /> '''Video &quot;Verwendung von Bibliotheken&quot; bei &quot;YouTube&quot;:'''<br /> <br /> [https://www.youtube.com/watch?v=moi3AiexalQ Verwendung von Bibliotheken]<br /> <br /> &lt;br&gt;<br /> <br /> = Tutorial: Generieren von Testdaten =<br /> <br /> Eine der am häufigsten gestellten Fragen ist &quot;Wie kann ich Testdaten generieren&quot;. Aufgrund der Flexibilität von expecco gibt es mehrere Lösungen zur Lösung dieser Aufgabe. Je nach Art und Umfang der zu erzeugenden Daten gilt eines von mehreren Mustern. Im Folgenden erhalten Sie einen groben Überblick über dieses Thema. <br /> <br /> &lt;br&gt;<br /> [[Generating Test Data|Tutorial: Generieren von Testdaten]]<br /> &lt;br&gt;<br /> <br /> = Der Umgang mit Bausteinen =<br /> <br /> '''Video &quot;Umgang mit Bausteinen bei &quot;YouTube&quot;:'''<br /> <br /> [https://www.youtube.com/watch?v=GYXXyJWmNT8 Umgang mit Bausteinen]<br /> <br /> &lt;br&gt;<br /> <br /> = [[Testing Java Applications using Groovy blocks]] =<br /> Through this tutorial, we'll use a simple &quot;Bank Account&quot; application as system under test.<br /> <br /> &lt;br&gt;<br /> <br /> = [[expecco API]] =<br /> Bevor Sie mit der Programmierung beginnen, lesen Sie bitte das Dokument [[How_to_Program/en|&quot;How to Program&quot;]], das den Umgang mit dem Programmcode in expecco beschreibt.<br /> Sie werden mehr Spaß haben und produktiver sein, wenn Sie die Leistungsfähigkeit der Tools kennen. Das beste Entwicklungserlebnis bietet der Debugger, der Arbeitsbereich (Notepad) und die Dateninspektoren.<br /> Der Rest dieses Dokuments beschreibt die Syntax und Semantik der elementaren Aktionssprachen; für die Verwendung der Werkzeuge lesen Sie bitte das [[How_to_Program/en|HowTo]] Dokument.<br /> <br /> &lt;br&gt;<br /> <br /> = [[Parametrizing Tests|Parametrisierung von Tests]] =<br /> Parameterwerte (wie Hostnamen, Portnummern, Benutzernamen, DB-Namen usw.) sollten normalerweise nicht buchstäblich als Freeze-Wert verwendet werden oder fest in den Code eines elementaren Aktionsbausteins verdrahtet werden, da dies die Pflege der Suite erschweren kann. Da Sie nach solchen Werten suchen müssen, wenn eine Änderung erforderlich ist (über die Stringsuchfunktion in der linken Baumansicht).<br /> <br /> &lt;br&gt;<br /> <br /> = [[Common_Errors/en|Common Errors and how to Deal with Them]] =<br /> Dieses Dokument beschreibt die häufigsten Fehlersituationen und gibt Hinweise zur Behebung. Sie ist unvollständig und deckt nicht alle möglichen Fehler ab. <br /> <br /> &lt;br&gt;<br /> <br /> &lt;!-- = Executor =<br /> <br /> &lt;br&gt; --&gt;<br /> <br /> &lt;!-- = Executor#Activity =<br /> <br /> &lt;br&gt;--&gt;<br /> <br /> = [[Reimport Tool|Reimporting a Library]] =<br /> Diese Seite erklärt, wie Sie Ihre Bibliotheken mit dem Reimporting-Tool auf dem aktuellsten Stand halten können.<br /> <br /> &lt;br&gt;<br /> <br /> = [[The Use of Tags|Nutzung von Etiketten (Tags)]] =<br /> <br /> Elemente in expecco können mit Etiketten (Tags) markiert werden. So werden funktionale Gruppen von Elementen gebildet und das Finden von Elementen in Such-Dialogen vereinfacht. Suchdialoge enthalten dafür eine eine Auswahlbox.</div> Chzeiher https://doc.expecco.de/index.php?title=Tutorials&diff=15198 Tutorials 2019-02-28T10:08:16Z <p>Chzeiher: /* Erste Schritte OPCUA */</p> <hr /> <div>= Erste Schritte mit expecco =<br /> <br /> Die ersten Schritte richten sich an alle, die expecco zum ersten Mal benutzen und sollen als erste Starthilfe dienen. Anhand eines einfachen Beispiels wollen wir Ihnen einen Überblick über expecco verschaffen. Es empfiehlt sich expecco parallel zum Tutorial zu starten um alle Schritte innerhalb von expecco nachvollziehen zu können.<br /> <br /> [[Medium:Erste_Schritte_mit_expecco.pdf|Erste Schritte mit expecco.pdf]]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte mit Android =<br /> <br /> Mit dem Mobile Testing Plugin lassen sich Tests für Apps auf Android- oder iOS-Mobilgeräten erstellen und ausführen. Dieses Tutorial beschreibt das grundsätzliche Vorgehen anhand eines mit gelieferten Beispiels für Android, bestehend aus einer einfachen App und einer expecco-Testsuite. Die App expecco Mobile Demo berechnet und überprüft verschiedene alltägliche Codes: die IBAN aus dem europäischen Zahlungsverkehr, die internationalen GTIN-13-Produktcodes, wie man sie bei Strichcodes im Einzelhandel findet, und die Seriennummern auf Euro-Banknoten. Die Testsuite enthält Testfälle für einzelne Funktionen der App. Dabei sind noch nicht alle Funktionen abgedeckt, sondern werden im Laufe des Tutorials ergänzt.<br /> <br /> '''&quot;Erste Schritte mit Android&quot; als pdf:'''<br /> <br /> [[Medium:Erste_Schritte_mit_Android.pdf|Erste Schritte mit Android.pdf]]<br /> <br /> '''Tutorial als Video bei &quot;YouTube&quot;:'''<br /> <br /> [https://www.youtube.com/watch?v=H8H4gQO_Tx8 Testing with Android]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte Web Test =<br /> <br /> Dieses Tutorial führt Sie in das Testen bzw. Automatisieren von Web-Anwendungen in Browsern (chrome, firefox, edge, etc.) ein.<br /> <br /> *[[Web Test Tutorial - Teil 1]]<br /> *[[Web Test Tutorial - Teil 2]]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte Manueller Test =<br /> <br /> In diesem Tutorial erfahren Sie, wie geführte manuelle Tests mit expecco durchgeführt werden können.<br /> Manuel Tests können aus bestehenden Testfallbeschreibungen (aus Excel oder anderen Dokumenten) importiert werden,<br /> und danach schrittweise teil- oder vollautomatisiert werden.<br /> <br /> *[[Manueller Test Tutorial]]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte Scripting =<br /> <br /> *[[Scripting Tutorial]]<br /> <br /> &lt;br&gt;<br /> = Erste Schritte OPCUA=<br /> <br /> *[[OPC|Kurzbeschreibung zur OPC Library]]<br /> [[Datei:OPCUATutorial.mp4|Video Tutorial]] <br /> <br /> &lt;br&gt;<br /> <br /> = Bibliotheken =<br /> <br /> '''Video &quot;Verwendung von Bibliotheken&quot; bei &quot;YouTube&quot;:'''<br /> <br /> [https://www.youtube.com/watch?v=moi3AiexalQ Verwendung von Bibliotheken]<br /> <br /> &lt;br&gt;<br /> <br /> = Tutorial: Generieren von Testdaten =<br /> <br /> Eine der am häufigsten gestellten Fragen ist &quot;Wie kann ich Testdaten generieren&quot;. Aufgrund der Flexibilität von expecco gibt es mehrere Lösungen zur Lösung dieser Aufgabe. Je nach Art und Umfang der zu erzeugenden Daten gilt eines von mehreren Mustern. Im Folgenden erhalten Sie einen groben Überblick über dieses Thema. <br /> <br /> &lt;br&gt;<br /> [[Generating Test Data|Tutorial: Generieren von Testdaten]]<br /> &lt;br&gt;<br /> <br /> = Der Umgang mit Bausteinen =<br /> <br /> '''Video &quot;Umgang mit Bausteinen bei &quot;YouTube&quot;:'''<br /> <br /> [https://www.youtube.com/watch?v=GYXXyJWmNT8 Umgang mit Bausteinen]<br /> <br /> &lt;br&gt;<br /> <br /> = [[Testing Java Applications using Groovy blocks]] =<br /> Through this tutorial, we'll use a simple &quot;Bank Account&quot; application as system under test.<br /> <br /> &lt;br&gt;<br /> <br /> = [[expecco API]] =<br /> Bevor Sie mit der Programmierung beginnen, lesen Sie bitte das Dokument [[How_to_Program/en|&quot;How to Program&quot;]], das den Umgang mit dem Programmcode in expecco beschreibt.<br /> Sie werden mehr Spaß haben und produktiver sein, wenn Sie die Leistungsfähigkeit der Tools kennen. Das beste Entwicklungserlebnis bietet der Debugger, der Arbeitsbereich (Notepad) und die Dateninspektoren.<br /> Der Rest dieses Dokuments beschreibt die Syntax und Semantik der elementaren Aktionssprachen; für die Verwendung der Werkzeuge lesen Sie bitte das [[How_to_Program/en|HowTo]] Dokument.<br /> <br /> &lt;br&gt;<br /> <br /> = [[Parametrizing Tests|Parametrisierung von Tests]] =<br /> Parameterwerte (wie Hostnamen, Portnummern, Benutzernamen, DB-Namen usw.) sollten normalerweise nicht buchstäblich als Freeze-Wert verwendet werden oder fest in den Code eines elementaren Aktionsbausteins verdrahtet werden, da dies die Pflege der Suite erschweren kann. Da Sie nach solchen Werten suchen müssen, wenn eine Änderung erforderlich ist (über die Stringsuchfunktion in der linken Baumansicht).<br /> <br /> &lt;br&gt;<br /> <br /> = [[Common_Errors/en|Common Errors and how to Deal with Them]] =<br /> Dieses Dokument beschreibt die häufigsten Fehlersituationen und gibt Hinweise zur Behebung. Sie ist unvollständig und deckt nicht alle möglichen Fehler ab. <br /> <br /> &lt;br&gt;<br /> <br /> &lt;!-- = Executor =<br /> <br /> &lt;br&gt; --&gt;<br /> <br /> &lt;!-- = Executor#Activity =<br /> <br /> &lt;br&gt;--&gt;<br /> <br /> = [[Reimport Tool|Reimporting a Library]] =<br /> Diese Seite erklärt, wie Sie Ihre Bibliotheken mit dem Reimporting-Tool auf dem aktuellsten Stand halten können.<br /> <br /> &lt;br&gt;<br /> <br /> = [[The Use of Tags|Nutzung von Etiketten (Tags)]] =<br /> <br /> Elemente in expecco können mit Etiketten (Tags) markiert werden. So werden funktionale Gruppen von Elementen gebildet und das Finden von Elementen in Such-Dialogen vereinfacht. Suchdialoge enthalten dafür eine eine Auswahlbox.</div> Chzeiher https://doc.expecco.de/index.php?title=Tutorials&diff=15197 Tutorials 2019-02-28T09:48:49Z <p>Chzeiher: /* Erste Schritte Scripting */</p> <hr /> <div>= Erste Schritte mit expecco =<br /> <br /> Die ersten Schritte richten sich an alle, die expecco zum ersten Mal benutzen und sollen als erste Starthilfe dienen. Anhand eines einfachen Beispiels wollen wir Ihnen einen Überblick über expecco verschaffen. Es empfiehlt sich expecco parallel zum Tutorial zu starten um alle Schritte innerhalb von expecco nachvollziehen zu können.<br /> <br /> [[Medium:Erste_Schritte_mit_expecco.pdf|Erste Schritte mit expecco.pdf]]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte mit Android =<br /> <br /> Mit dem Mobile Testing Plugin lassen sich Tests für Apps auf Android- oder iOS-Mobilgeräten erstellen und ausführen. Dieses Tutorial beschreibt das grundsätzliche Vorgehen anhand eines mit gelieferten Beispiels für Android, bestehend aus einer einfachen App und einer expecco-Testsuite. Die App expecco Mobile Demo berechnet und überprüft verschiedene alltägliche Codes: die IBAN aus dem europäischen Zahlungsverkehr, die internationalen GTIN-13-Produktcodes, wie man sie bei Strichcodes im Einzelhandel findet, und die Seriennummern auf Euro-Banknoten. Die Testsuite enthält Testfälle für einzelne Funktionen der App. Dabei sind noch nicht alle Funktionen abgedeckt, sondern werden im Laufe des Tutorials ergänzt.<br /> <br /> '''&quot;Erste Schritte mit Android&quot; als pdf:'''<br /> <br /> [[Medium:Erste_Schritte_mit_Android.pdf|Erste Schritte mit Android.pdf]]<br /> <br /> '''Tutorial als Video bei &quot;YouTube&quot;:'''<br /> <br /> [https://www.youtube.com/watch?v=H8H4gQO_Tx8 Testing with Android]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte Web Test =<br /> <br /> Dieses Tutorial führt Sie in das Testen bzw. Automatisieren von Web-Anwendungen in Browsern (chrome, firefox, edge, etc.) ein.<br /> <br /> *[[Web Test Tutorial - Teil 1]]<br /> *[[Web Test Tutorial - Teil 2]]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte Manueller Test =<br /> <br /> In diesem Tutorial erfahren Sie, wie geführte manuelle Tests mit expecco durchgeführt werden können.<br /> Manuel Tests können aus bestehenden Testfallbeschreibungen (aus Excel oder anderen Dokumenten) importiert werden,<br /> und danach schrittweise teil- oder vollautomatisiert werden.<br /> <br /> *[[Manueller Test Tutorial]]<br /> <br /> &lt;br&gt;<br /> <br /> = Erste Schritte Scripting =<br /> <br /> *[[Scripting Tutorial]]<br /> <br /> &lt;br&gt;<br /> = Erste Schritte OPCUA=<br /> <br /> *[[Scripting Tutorial]]<br /> [[Datei:OPCUATutorial.mp4|Video Tutorial]] <br /> <br /> &lt;br&gt;<br /> <br /> = Bibliotheken =<br /> <br /> '''Video &quot;Verwendung von Bibliotheken&quot; bei &quot;YouTube&quot;:'''<br /> <br /> [https://www.youtube.com/watch?v=moi3AiexalQ Verwendung von Bibliotheken]<br /> <br /> &lt;br&gt;<br /> <br /> = Tutorial: Generieren von Testdaten =<br /> <br /> Eine der am häufigsten gestellten Fragen ist &quot;Wie kann ich Testdaten generieren&quot;. Aufgrund der Flexibilität von expecco gibt es mehrere Lösungen zur Lösung dieser Aufgabe. Je nach Art und Umfang der zu erzeugenden Daten gilt eines von mehreren Mustern. Im Folgenden erhalten Sie einen groben Überblick über dieses Thema. <br /> <br /> &lt;br&gt;<br /> [[Generating Test Data|Tutorial: Generieren von Testdaten]]<br /> &lt;br&gt;<br /> <br /> = Der Umgang mit Bausteinen =<br /> <br /> '''Video &quot;Umgang mit Bausteinen bei &quot;YouTube&quot;:'''<br /> <br /> [https://www.youtube.com/watch?v=GYXXyJWmNT8 Umgang mit Bausteinen]<br /> <br /> &lt;br&gt;<br /> <br /> = [[Testing Java Applications using Groovy blocks]] =<br /> Through this tutorial, we'll use a simple &quot;Bank Account&quot; application as system under test.<br /> <br /> &lt;br&gt;<br /> <br /> = [[expecco API]] =<br /> Bevor Sie mit der Programmierung beginnen, lesen Sie bitte das Dokument [[How_to_Program/en|&quot;How to Program&quot;]], das den Umgang mit dem Programmcode in expecco beschreibt.<br /> Sie werden mehr Spaß haben und produktiver sein, wenn Sie die Leistungsfähigkeit der Tools kennen. Das beste Entwicklungserlebnis bietet der Debugger, der Arbeitsbereich (Notepad) und die Dateninspektoren.<br /> Der Rest dieses Dokuments beschreibt die Syntax und Semantik der elementaren Aktionssprachen; für die Verwendung der Werkzeuge lesen Sie bitte das [[How_to_Program/en|HowTo]] Dokument.<br /> <br /> &lt;br&gt;<br /> <br /> = [[Parametrizing Tests|Parametrisierung von Tests]] =<br /> Parameterwerte (wie Hostnamen, Portnummern, Benutzernamen, DB-Namen usw.) sollten normalerweise nicht buchstäblich als Freeze-Wert verwendet werden oder fest in den Code eines elementaren Aktionsbausteins verdrahtet werden, da dies die Pflege der Suite erschweren kann. Da Sie nach solchen Werten suchen müssen, wenn eine Änderung erforderlich ist (über die Stringsuchfunktion in der linken Baumansicht).<br /> <br /> &lt;br&gt;<br /> <br /> = [[Common_Errors/en|Common Errors and how to Deal with Them]] =<br /> Dieses Dokument beschreibt die häufigsten Fehlersituationen und gibt Hinweise zur Behebung. Sie ist unvollständig und deckt nicht alle möglichen Fehler ab. <br /> <br /> &lt;br&gt;<br /> <br /> &lt;!-- = Executor =<br /> <br /> &lt;br&gt; --&gt;<br /> <br /> &lt;!-- = Executor#Activity =<br /> <br /> &lt;br&gt;--&gt;<br /> <br /> = [[Reimport Tool|Reimporting a Library]] =<br /> Diese Seite erklärt, wie Sie Ihre Bibliotheken mit dem Reimporting-Tool auf dem aktuellsten Stand halten können.<br /> <br /> &lt;br&gt;<br /> <br /> = [[The Use of Tags|Nutzung von Etiketten (Tags)]] =<br /> <br /> Elemente in expecco können mit Etiketten (Tags) markiert werden. So werden funktionale Gruppen von Elementen gebildet und das Finden von Elementen in Such-Dialogen vereinfacht. Suchdialoge enthalten dafür eine eine Auswahlbox.</div> Chzeiher https://doc.expecco.de/index.php?title=OPC/en&diff=15196 OPC/en 2019-02-27T11:51:16Z <p>Chzeiher: </p> <hr /> <div>OPC is a wellknown communication framework used in manufactoring, factory automation and the IoT (&quot;''Internet of Things''&quot;).<br /> <br /> Traditionally, OPC used COM/DCOM as underlying transport and was therefore more or less bound to Windows architectures (or required expensive COM/DCOM frameworks under Unix/Linux).<br /> In contrast, the more recent OPC-UA (&quot;''OPC-Unified Architecture''&quot;) uses standard TCP communication on top of which either binary data or XML-based HTTP requests are exchanged.<br /> <br /> This plugin provides both a server and a client implementation of OPC-UA, by interfacing an open source (and license free) OPC-UA implementation written for NodeJS.<br /> <br /> ==Node Installation==<br /> NodeJS is mandatory to be installed on our machine.<br /> <br /> Check if node is already present (by entering on the command line): <br /> &lt;code&gt;node --version&lt;/code&gt;<br /> or open the expecco settings-dialog and navigate to &quot;''External Script Interpreters''&quot;.<br /> If node is not installed, download and install it from &quot;https://nodejs.org/en/download&quot;.<br /> <br /> Also make sure that the node package manager (npm) is installed with<br /> &lt;code&gt;npm -v&lt;/code&gt;<br /> <br /> ==Node-OPC-UA Installation==<br /> &quot;node-opcua&quot; is an open source, license free and pure JavaScript implementation of OPC-UA for nodeJS. <br /> For more information, consult &quot;https://github.com/node-opcua&quot;.<br /> <br /> Using &quot;npm&quot;, the node package manager, install the &quot;node-opcua&quot; package:&lt;br&gt;<br /> Disclaimer! using &lt;code&gt;install&lt;/code&gt; in this way will install the files locally in your current directory.<br /> If you wish for a globally available module, add a &lt;code&gt;-g&lt;/code&gt; at the end.<br /> npm install node-opcua <br /> and optionally, the demo examples with:<br /> npm install node-opcua-samples<br /> <br /> Verify that the modules are present in your &quot;&lt;code&gt;~/node_modules&lt;/code&gt;&quot; folder.<br /> (the OPC_UA_Interface library contains a action block named &quot;Assert &quot;node-opcua&quot; module is present&quot; to verify that the module is found.<br /> <br /> If it is not found (typically, because the &quot;node_modules&quot; folder is not configured to be found by node), you can adjust the &lt;code&gt;NODE_PATH&lt;/code&gt; setting in the &quot;''Extras''&quot; - &quot;''Settings''&quot; - &quot;''External Script Interpreters''&quot; dialog, or set it in the shell environment before starting expecco.<br /> <br /> ==Launching a Demo Server==<br /> <br /> ===The node-opcua Sample Server===<br /> If you installed the samples (as above), a server can be started with:<br /> node ~/node_modules/node-opcua-samples/bin/simple_server.js<br /> <br /> If warning messages about missing modules are shown, you may restart it after<br /> installing additional packages:<br /> npm install usage<br /> <br /> ==Connecting to the Demo Server==<br /> <br /> ===The node-opcua Sample Client===<br /> <br /> For a quick smoke test, run the node sample client against the above sample server:<br /> <br /> node ~/node_modules/node-opcua-samples/bin/simple_client.js<br /> <br /> &lt;!-- You can now run the &quot;&lt;code&gt;Demo Testplan&lt;/code&gt;&quot; contained in the &quot;&lt;code&gt;MQTT_Interface_Library.ets&lt;/code&gt;&quot; delivered with expecco. <br /> If your MQTT docker container is running on a different host than expecco, change the &lt;code&gt;MQTT_HOST&lt;/code&gt; environment variable from &quot;&lt;code&gt;localhost&lt;/code&gt;&quot; to the hostname or IP-Address of the docker host. --&gt;<br /> <br /> &lt;H2&gt;Using the Library OPC_UA_Interface&lt;/H2&gt;<br /> First and foremost, you can find documentation as well as a working example for each Action in the &quot;Documentation&quot; and &quot;Test/Demo&quot; Sections respectively.<br /> <br /> ==Testsuite Samples==<br /> <br /> &lt;br&gt;You will find a server to test against in &quot;&lt;i&gt;MenuActions&lt;/i&gt;&quot; &gt;&gt; &quot;&lt;i&gt;Start Sample Server in Background&lt;/i&gt;&quot;.<br /> &lt;br&gt;It runs the attached &quot;&lt;code&gt;opcuaDemoServerScript.js&lt;/code&gt;&quot; script which you can change freely for your own testing purposes.<br /> &lt;br&gt;If you wish, you may also try the &quot;Server&quot; blocks (see the attached readme in that folder) which enable you to create a very basic server as well.<br /> &lt;br&gt;<br /> <br /> <br /> &lt;H3&gt;Troubleshooting:&lt;/H3&gt;<br /> The following errors may or may not occur, here is how you deal with them:<br /> &lt;ul&gt;<br /> <br /> &lt;li&gt;&quot;&lt;code&gt;node-opcua not found&lt;/code&gt;&quot;<br /> &lt;br&gt;may occur if the module path to opcua is not set correctly in the Expecco settings.<br /> &lt;br&gt;This may also occur with a global opcua installation with Windows10; <br /> if this should apply to you, do a local installation instead.<br /> <br /> &lt;li&gt;&lt;code&gt;&quot;ERROR_write other&lt;/code&gt;&quot;<br /> &lt;br&gt;may occur if you manually shut down a node server which the still running bridge tries to access.<br /> <br /> &lt;li&gt;&quot;&lt;code&gt;port undefined&lt;/code&gt;&quot; or &quot;&lt;code&gt;already in use&lt;/code&gt;&quot;<br /> &lt;br&gt;may occur if you are trying to start an opc server while another still holds the tcp socket you are trying to use.<br /> &lt;br&gt;If your created session runs into a timeout, it may be that node<br /> still holds an expired session token.<br /> &lt;br&gt;In that case (within expecco) navigate to &quot;&lt;i&gt;Plugins&lt;/i&gt;&quot; &gt;&gt; &quot;&lt;i&gt;Bridges&lt;/i&gt;&quot; &gt;&gt; &quot;&lt;i&gt;Node Bridge&lt;/i&gt;&quot; &gt; &quot;&lt;i&gt;Disconnect All Open Connections&lt;/i&gt;&quot; <br /> and try again.</div> Chzeiher https://doc.expecco.de/index.php?title=OPC/en&diff=14726 OPC/en 2019-01-28T10:14:22Z <p>Chzeiher: /* Node-OPC-UA Installation */</p> <hr /> <div>OPC is a wellknown communication framework used in manufactoring, factory automation and the IoT (&quot;''Internet of Things''&quot;).<br /> <br /> Traditionally, OPC used COM/DCOM as underlying transport and was therefore more or less bound to Windows architectures (or required expensive COM/DCOM frameworks under Unix/Linux).<br /> In contrast, the more recent OPC-UA (&quot;''OPC-Unified Architecture''&quot;) uses standard TCP communication on top of which either binary data or XML-based HTTP requests are exchanged.<br /> <br /> This plugin provides both a server and a client implementation of OPC-UA, by interfacing an open source (and license free) OPC-UA implementation written for NodeJS.<br /> <br /> ==Node Installation==<br /> NodeJS is mandatory to be installed on our machine.<br /> <br /> Check if node is already present (by entering on the command line): <br /> &lt;code&gt;node --version&lt;/code&gt;<br /> or open the expecco settings-dialog and navigate to &quot;''External Script Interpreters''&quot;.<br /> If node is not installed, download and install it from &quot;https://nodejs.org/en/download&quot;.<br /> <br /> Also make sure that the node package manager (npm) is installed with<br /> &lt;code&gt;npm -v&lt;/code&gt;<br /> <br /> ==Node-OPC-UA Installation==<br /> &quot;node-opcua&quot; is an open source, license free and pure JavaScript implementation of OPC-UA for nodeJS. <br /> For more information, consult &quot;https://github.com/node-opcua&quot;.<br /> <br /> Using &quot;npm&quot;, the node package manager, install the &quot;node-opcua&quot; package:&lt;br&gt;<br /> Disclaimer! using &lt;code&gt;install&lt;/code&gt; in this way will install the files locally in your current directory.<br /> If you wish for a globally available module, add a &lt;code&gt;-g&lt;/code&gt; at the end.<br /> npm install node-opcua <br /> and optionally, the demo examples with:<br /> npm install node-opcua-samples<br /> <br /> Verify that the modules are present in your &quot;&lt;code&gt;~/node_modules&lt;/code&gt;&quot; folder.<br /> (the OPC_UA_Interface library contains a action block named &quot;Assert &quot;node-opcua&quot; module is present&quot; to verify that the module is found.<br /> <br /> If it is not found (typically, because the &quot;node_modules&quot; folder is not configured to be found by node), you can adjust the &lt;code&gt;NODE_PATH&lt;/code&gt; setting in the &quot;''Extras''&quot; - &quot;''Settings''&quot; - &quot;''External Script Interpreters''&quot; dialog, or set it in the shell environment before starting expecco.<br /> <br /> ==Launching a Demo Server==<br /> <br /> ===The node-opcua Sample Server===<br /> If you installed the samples (as above), a server can be started with:<br /> node ~/node_modules/node-opcua-samples/bin/simple_server.js<br /> <br /> If warning messages about missing modules are shown, you may restart it after<br /> installing additional packages:<br /> npm install usage<br /> <br /> ==Connecting to the Demo Server==<br /> <br /> ===The node-opcua Sample Client===<br /> <br /> For a quick smoke test, run the node sample client against the above sample server:<br /> <br /> node ~/node_modules/node-opcua-samples/bin/simple_client.js<br /> <br /> &lt;!-- You can now run the &quot;&lt;code&gt;Demo Testplan&lt;/code&gt;&quot; contained in the &quot;&lt;code&gt;MQTT_Interface_Library.ets&lt;/code&gt;&quot; delivered with expecco. <br /> If your MQTT docker container is running on a different host than expecco, change the &lt;code&gt;MQTT_HOST&lt;/code&gt; environment variable from &quot;&lt;code&gt;localhost&lt;/code&gt;&quot; to the hostname or IP-Address of the docker host. --&gt;</div> Chzeiher https://doc.expecco.de/index.php?title=OPC/en&diff=14725 OPC/en 2019-01-28T10:14:04Z <p>Chzeiher: /* Node-OPC-UA Installation */</p> <hr /> <div>OPC is a wellknown communication framework used in manufactoring, factory automation and the IoT (&quot;''Internet of Things''&quot;).<br /> <br /> Traditionally, OPC used COM/DCOM as underlying transport and was therefore more or less bound to Windows architectures (or required expensive COM/DCOM frameworks under Unix/Linux).<br /> In contrast, the more recent OPC-UA (&quot;''OPC-Unified Architecture''&quot;) uses standard TCP communication on top of which either binary data or XML-based HTTP requests are exchanged.<br /> <br /> This plugin provides both a server and a client implementation of OPC-UA, by interfacing an open source (and license free) OPC-UA implementation written for NodeJS.<br /> <br /> ==Node Installation==<br /> NodeJS is mandatory to be installed on our machine.<br /> <br /> Check if node is already present (by entering on the command line): <br /> &lt;code&gt;node --version&lt;/code&gt;<br /> or open the expecco settings-dialog and navigate to &quot;''External Script Interpreters''&quot;.<br /> If node is not installed, download and install it from &quot;https://nodejs.org/en/download&quot;.<br /> <br /> Also make sure that the node package manager (npm) is installed with<br /> &lt;code&gt;npm -v&lt;/code&gt;<br /> <br /> ==Node-OPC-UA Installation==<br /> &quot;node-opcua&quot; is an open source, license free and pure JavaScript implementation of OPC-UA for nodeJS. <br /> For more information, consult &quot;https://github.com/node-opcua&quot;.<br /> <br /> Using &quot;npm&quot;, the node package manager, install the &quot;node-opcua&quot; package:<br /> Disclaimer! using &lt;code&gt;install&lt;/code&gt; in this way will install the files locally in your current directory.<br /> If you wish for a globally available module, add a &lt;code&gt;-g&lt;/code&gt; at the end.<br /> npm install node-opcua <br /> and optionally, the demo examples with:<br /> npm install node-opcua-samples<br /> <br /> Verify that the modules are present in your &quot;&lt;code&gt;~/node_modules&lt;/code&gt;&quot; folder.<br /> (the OPC_UA_Interface library contains a action block named &quot;Assert &quot;node-opcua&quot; module is present&quot; to verify that the module is found.<br /> <br /> If it is not found (typically, because the &quot;node_modules&quot; folder is not configured to be found by node), you can adjust the &lt;code&gt;NODE_PATH&lt;/code&gt; setting in the &quot;''Extras''&quot; - &quot;''Settings''&quot; - &quot;''External Script Interpreters''&quot; dialog, or set it in the shell environment before starting expecco.<br /> <br /> ==Launching a Demo Server==<br /> <br /> ===The node-opcua Sample Server===<br /> If you installed the samples (as above), a server can be started with:<br /> node ~/node_modules/node-opcua-samples/bin/simple_server.js<br /> <br /> If warning messages about missing modules are shown, you may restart it after<br /> installing additional packages:<br /> npm install usage<br /> <br /> ==Connecting to the Demo Server==<br /> <br /> ===The node-opcua Sample Client===<br /> <br /> For a quick smoke test, run the node sample client against the above sample server:<br /> <br /> node ~/node_modules/node-opcua-samples/bin/simple_client.js<br /> <br /> &lt;!-- You can now run the &quot;&lt;code&gt;Demo Testplan&lt;/code&gt;&quot; contained in the &quot;&lt;code&gt;MQTT_Interface_Library.ets&lt;/code&gt;&quot; delivered with expecco. <br /> If your MQTT docker container is running on a different host than expecco, change the &lt;code&gt;MQTT_HOST&lt;/code&gt; environment variable from &quot;&lt;code&gt;localhost&lt;/code&gt;&quot; to the hostname or IP-Address of the docker host. --&gt;</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14566 Java GUI Plugins 2018-12-21T11:45:56Z <p>Chzeiher: /* Warnhinweise */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Unterstützte Java-Technologien ==<br /> expecco unterstützt die Automatisierung von Java-Anwendungen, die mit Java Swing, Java SWT oder JavaFX implementiert sind. Ebenso weden Anwendungen unterstützt, die mehrere dieser Technologien vereinen, z.B. eine Swing-Anwendung mit eingebettetem JavaFX-Inhalt.<br /> <br /> === Java Swing ===<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> ==== Hauptmerkmale ====<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Java SWT ===<br /> <br /> === JavaFX ===<br /> Ab Java 11 ist JavaFX nicht mehr im JDK enthalten. Daher müssen Sie zusätzlich ein JavaFX SDK installieren, z.B. von [https://openjfx.io/ OpenJFX]. Kopieren Sie dann die jar-Dateien aus dem lib-Verzeichnis des JavaFX JDKs nach &lt;code&gt;packages\exept\expecco\plugin\javafx\lib&lt;/code&gt; im expecco-Installationsverzeichnis.<br /> <br /> == Funktionsweise ==<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> == Anforderungen ==<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> ===Zugriffsberechtigungen===<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei nicht mehr funktionieren, falls die Zielapplikation eine festgelegte Modulkapselung besitzt ([https://stackoverflow.com/questions/46741907/what-is-an-automatic-module Details]).&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> Je nach verwendeter Technologie können die benötigten Parameter variieren, weshalb Sie diese selbstständig herausfinden müssen.<br /> &lt;br&gt;&lt;code&gt;jdeps list-deps JARNAME.jar&lt;/code&gt; Jdeps ist dafür ein frei verfügbares (teil der jdk) sehr nützliches Werkzeug.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein<br /> <br /> &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;<br /> ParameterListe (ausklappbar)<br /> &lt;div class=&quot;mw-collapsible-content&quot;&gt;<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> &lt;/div&gt;<br /> &lt;/div&gt;<br /> <br /> Sollten Sie dennoch einen &lt;code&gt;java.lang.IllegalAccessError&lt;/code&gt; erhalten, müssen Sie diese Parameter in folgender Weise erweitern:<br /> * Fehlertext der Art &lt;code&gt;module &lt;module&gt; does not &quot;opens &lt;package&gt;&quot; to unnamed module&lt;/code&gt;<br /> : &lt;code&gt;--add-opens &lt;module&gt;/&lt;package&gt;=ALL-UNNAMED &lt;/code&gt;<br /> : ''Beispiel:'' &lt;code&gt;module java.base does not &quot;opens java.lang&quot; to unnamed module&lt;/code&gt; ''lösen Sie mit'' &lt;code&gt;--add-opens java.base/java.lang=ALL-UNNAMED&lt;/code&gt;<br /> * Fehlertext der Art &lt;code&gt;cannot access class &lt;package&gt;.&lt;class name&gt; (in module &lt;module&gt;) because module &lt;module&gt; does not export &lt;package&gt; to unnamed module&lt;/code&gt;<br /> : &lt;code&gt;--add-exports &lt;module&gt;/&lt;package&gt;=ALL-UNNAMED &lt;/code&gt;<br /> : ''Beispiel:'' &lt;code&gt;cannot access class com.sun.javafx.scene.input.ExtendedInputMethodRequests (in module javafx.graphics) because module javafx.graphics does not export com.sun.javafx.scene.input to unnamed module&lt;/code&gt; ''lösen Sie mit'' &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED&lt;/code&gt;<br /> <br /> == Konfiguration ==<br /> === Installation auf dem expecco Rechner ===<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> === Installation auf dem Testanwendungsrechner ===<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> == expecco GUI Browser ==<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> === Verbindungsaufbau ===<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden: [[Expecco_GUI_Tests_Extension_Reference| GUI Test Referenz]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies im Dialogfenster nach durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> === Verbindung zu Entfernten Systemen ===<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> === Warnhinweise ===<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen.&lt;br&gt; Eine Remote Verbindung müsste das Programm stattdessen manuell mit der gewollten Java Version starten.&lt;br&gt; Der Java Agent, wenn über das &lt;code&gt;startAgentLoader&lt;/code&gt; skript aufgerufen, wählt die Version Anhand von &lt;code&gt;JAVA_HOME&lt;/code&gt; auf dem remote System<br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.&lt;br&gt;<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |}<br /> :<br /> <br /> == Technologieübergreifende Verbindungen ==<br /> Falls eine Anwendung mehrere Java-Technologien verwendet, müssen Sie nur eine Verbindung aufbauen und dann die Bausteine aus der Library entsprechend der Technologie des anzusprechenden Elements verwenden.<br /> <br /> == JavaSwingLibrary ==<br /> <br /> == Example ==<br /> <br /> == FAQ ==<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> *'''Ich kann mich nicht verbinden aber alle Einstellungen stimmen'''<br /> :Auch wenn dies generell nicht passieren sollte, hier ein paar Aspekte, die Einfluss auf die Verbindung nehmen können.<br /> ::{|<br /> |FIREWALL <br /> |Die Firewall kann das kommunizieren des Java Agenten mit der Anwendung stören. &lt;br&gt;Entweder man richtet eine Ausnahmeregel für den Agenten ein oder aber man deaktiviert die Firewall für die Dauer des Tests.<br /> |-<br /> |SOCKET BELEGT<br /> |Es kann vorkommen, besonders beim Debuggen, dass eine vorherige Instanz eines Java Agenten nicht korrekt geschlossen wurde. Das kann dazu führen, dass dieser den Socket belegt und andere Verbindungen abweist.&lt;br&gt;Über &lt;code&gt;Extrax =&gt; Fehleranalyse =&gt; Alle BridgeVerbindung schließen / Alle Socketverbindungen schließen&lt;/code&gt; werden vorherige Instanzen entfernt. &lt;br&gt;Bitte beachten, dass damit auch alle anderen bestehenden (lokalen) Expecco Verbindungen geschlossen werden. Im Fall Remote sollte ein Neustart des Agenten und evtl. auch der Anwendung Abhilfe schaffen.<br /> |}</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14517 Java GUI Plugins 2018-12-17T08:59:08Z <p>Chzeiher: /* Fehlerbehandlung */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei nicht mehr funktionieren, falls die Zielapplikation eine festgelegte Modulkapselung besitzt ([https://stackoverflow.com/questions/46741907/what-is-an-automatic-module Details]).&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> Je nach verwendeter Technologie können die benötigten Parameter variieren, weshalb Sie diese selbstständig herausfinden müssen.<br /> &lt;br&gt;&lt;code&gt;jdeps list-deps JARNAME.jar&lt;/code&gt; Jdeps ist dafür ein frei verfügbares (teil der jdk) sehr nützliches Werkzeug.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein<br /> <br /> &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;<br /> ParameterListe (ausklappbar)<br /> &lt;div class=&quot;mw-collapsible-content&quot;&gt;<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> &lt;/div&gt;<br /> &lt;/div&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden: [[Expecco_GUI_Tests_Extension_Reference| GUI Test Referenz]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies im Dialogfenster nach durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Warnhinweise ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.&lt;br&gt;<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> *'''Ich kann mich nicht verbinden aber alle Einstellungen stimmen'''<br /> :Auch wenn dies generell nicht passieren sollte, hier ein paar Aspekte, die Einfluss auf die Verbindung nehmen können.<br /> ::{|<br /> |FIREWALL <br /> |Die Firewall kann das kommunizieren des Java Agenten mit der Anwendung stören. &lt;br&gt;Entweder man richtet eine Ausnahmeregel für den Agenten ein oder aber man deaktiviert die Firewall für die Dauer des Tests.<br /> |-<br /> |SOCKET BELEGT<br /> |Es kann vorkommen, besonders beim Debuggen, dass eine vorherige Instanz eines Java Agenten nicht korrekt geschlossen wurde. Das kann dazu führen, dass dieser den Socket belegt und andere Verbindungen abweist.&lt;br&gt;Über &lt;code&gt;Extrax =&gt; Fehleranalyse =&gt; Alle BridgeVerbindung schließen / Alle Socketverbindungen schließen&lt;/code&gt; werden vorherige Instanzen entfernt. &lt;br&gt;Bitte beachten, dass damit auch alle anderen bestehenden (lokalen) Expecco Verbindungen geschlossen werden. Im Fall Remote sollte ein Neustart des Agenten und evtl. auch der Anwendung Abhilfe schaffen.<br /> |}<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14516 Java GUI Plugins 2018-12-17T08:48:09Z <p>Chzeiher: /* FAQ */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei nicht mehr funktionieren, falls die Zielapplikation eine festgelegte Modulkapselung besitzt ([https://stackoverflow.com/questions/46741907/what-is-an-automatic-module Details]).&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> Je nach verwendeter Technologie können die benötigten Parameter variieren, weshalb Sie diese selbstständig herausfinden müssen.<br /> &lt;br&gt;&lt;code&gt;jdeps list-deps JARNAME.jar&lt;/code&gt; Jdeps ist dafür ein frei verfügbares (teil der jdk) sehr nützliches Werkzeug.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein<br /> <br /> &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;<br /> ParameterListe (ausklappbar)<br /> &lt;div class=&quot;mw-collapsible-content&quot;&gt;<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> &lt;/div&gt;<br /> &lt;/div&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden: [[Expecco_GUI_Tests_Extension_Reference| GUI Test Referenz]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies im Dialogfenster nach durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.&lt;br&gt;<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein ''Neustart der Anwendung und des Agenten'' (im Fall remote), sowie das Ausführen von &lt;br&gt;&lt;code&gt;Extrax =&gt; Fehleranalyse =&gt; Alle BridgeVerbindung schließen / Alle Socketverbindungen schließen &lt;/code&gt; sollte helfen. &lt;br&gt; (Achtung dies schließt ALLE offenen Expecco-Java Verbindungen) &lt;br&gt; Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre ''Firewall Einstellungen'', die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> *'''Ich kann mich nicht verbinden aber alle Einstellungen stimmen'''<br /> :Auch wenn dies generell nicht passieren sollte, hier ein paar Aspekte, die Einfluss auf die Verbindung nehmen können.<br /> ::{|<br /> |FIREWALL <br /> |Die Firewall kann das kommunizieren des Java Agenten mit der Anwendung stören. &lt;br&gt;Entweder man richtet eine Ausnahmeregel für den Agenten ein oder aber man deaktiviert die Firewall für die Dauer des Tests.<br /> |-<br /> |SOCKET BELEGT<br /> |Es kann vorkommen, besonders beim Debuggen, dass eine vorherige Instanz eines Java Agenten nicht korrekt geschlossen wurde. Das kann dazu führen, dass dieser den Socket belegt und andere Verbindungen abweist.&lt;br&gt;Über &lt;code&gt;Extrax =&gt; Fehleranalyse =&gt; Alle BridgeVerbindung schließen / Alle Socketverbindungen schließen&lt;/code&gt; werden vorherige Instanzen entfernt. &lt;br&gt;Bitte beachten, dass damit auch alle anderen bestehenden (lokalen) Expecco Verbindungen geschlossen werden. Im Fall Remote sollte ein Neustart des Agenten und evtl. auch der Anwendung Abhilfe schaffen.<br /> |}<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14493 Java GUI Plugins 2018-12-13T15:41:32Z <p>Chzeiher: </p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei nicht mehr funktionieren, falls die Zielapplikation eine festgelegte Modulkapselung besitzt ([https://stackoverflow.com/questions/46741907/what-is-an-automatic-module Details]).&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> Je nach verwendeter Technologie können die benötigten Parameter variieren, weshalb Sie diese selbstständig herausfinden müssen.<br /> &lt;br&gt;&lt;code&gt;jdeps list-deps JARNAME.jar&lt;/code&gt; Jdeps ist dafür ein frei verfügbares (teil der jdk) sehr nützliches Werkzeug.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein<br /> <br /> &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;<br /> ParameterListe (ausklappbar)<br /> &lt;div class=&quot;mw-collapsible-content&quot;&gt;<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> &lt;/div&gt;<br /> &lt;/div&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden: [[Expecco_GUI_Tests_Extension_Reference| GUI Test Referenz]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies im Dialogfenster nach durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.&lt;br&gt;<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein ''Neustart der Anwendung und des Agenten'' (im Fall remote), sowie das Ausführen von &lt;br&gt;&lt;code&gt;Extrax =&gt; Fehleranalyse =&gt; Alle BridgeVerbindung schließen / Alle Socketverbindungen schließen &lt;/code&gt; sollte helfen. &lt;br&gt; (Achtung dies schließt ALLE offenen Expecco-Java Verbindungen) &lt;br&gt; Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre ''Firewall Einstellungen'', die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14492 Java GUI Plugins 2018-12-13T15:35:30Z <p>Chzeiher: /* Zugriffsberechtigungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei nicht mehr funktionieren, falls die Zielapplikation eine festgelegte Modulkapselung besitzt ([https://stackoverflow.com/questions/46741907/what-is-an-automatic-module Details]).&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> Je nach verwendeter Technologie können die benötigten Parameter variieren, weshalb Sie diese selbstständig herausfinden müssen.<br /> &lt;br&gt;&lt;code&gt;jdeps --list-deps JARNAME.jar&lt;/code&gt; Jdeps ist dafür ein frei verfügbares (teil der jdk) sehr nützliches Werkzeug.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein<br /> <br /> &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;<br /> ParameterListe (ausklappbar)<br /> &lt;div class=&quot;mw-collapsible-content&quot;&gt;<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> &lt;/div&gt;<br /> &lt;/div&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden: [[Expecco_GUI_Tests_Extension_Reference| GUI Test Referenz]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies im Dialogfenster nach durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.&lt;br&gt;<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein ''Neustart der Anwendung und des Agenten'' (im Fall remote), sowie das Ausführen von &lt;br&gt;&lt;code&gt;Extrax =&gt; Fehleranalyse =&gt; Alle BridgeVerbindung schließen / Alle Socketverbindungen schließen &lt;/code&gt; sollte helfen. &lt;br&gt; (Achtung dies schließt ALLE offenen Expecco-Java Verbindungen) &lt;br&gt; Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre ''Firewall Einstellungen'', die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14491 Java GUI Plugins 2018-12-13T15:30:27Z <p>Chzeiher: /* Zugriffsberechtigungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei nicht mehr funktionieren, falls die Zielapplikation eine festgelegte Modulkapselung besitzt ([https://stackoverflow.com/questions/46741907/what-is-an-automatic-module Details]).&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein<br /> <br /> &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;<br /> ParameterListe (ausklappbar)<br /> &lt;div class=&quot;mw-collapsible-content&quot;&gt;<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> &lt;/div&gt;<br /> &lt;/div&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden: [[Expecco_GUI_Tests_Extension_Reference| GUI Test Referenz]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies im Dialogfenster nach durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.&lt;br&gt;<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein ''Neustart der Anwendung und des Agenten'' (im Fall remote), sowie das Ausführen von &lt;br&gt;&lt;code&gt;Extrax =&gt; Fehleranalyse =&gt; Alle BridgeVerbindung schließen / Alle Socketverbindungen schließen &lt;/code&gt; sollte helfen. &lt;br&gt; (Achtung dies schließt ALLE offenen Expecco-Java Verbindungen) &lt;br&gt; Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre ''Firewall Einstellungen'', die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14490 Java GUI Plugins 2018-12-13T14:23:17Z <p>Chzeiher: /* Fehlerbehandlung */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei in manchen Fällen nicht mehr funktionieren.&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> <br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein<br /> <br /> &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;<br /> ParameterListe (ausklappbar)<br /> &lt;div class=&quot;mw-collapsible-content&quot;&gt;<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> &lt;/div&gt;<br /> &lt;/div&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden: [[Expecco_GUI_Tests_Extension_Reference| GUI Test Referenz]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies im Dialogfenster nach durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.&lt;br&gt;<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein ''Neustart der Anwendung und des Agenten'' (im Fall remote), sowie das Ausführen von &lt;br&gt;&lt;code&gt;Extrax =&gt; Fehleranalyse =&gt; Alle BridgeVerbindung schließen / Alle Socketverbindungen schließen &lt;/code&gt; sollte helfen. &lt;br&gt; (Achtung dies schließt ALLE offenen Expecco-Java Verbindungen) &lt;br&gt; Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre ''Firewall Einstellungen'', die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14489 Java GUI Plugins 2018-12-13T14:15:44Z <p>Chzeiher: /* Verbindungsaufbau */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei in manchen Fällen nicht mehr funktionieren.&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> <br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein<br /> <br /> &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;<br /> ParameterListe (ausklappbar)<br /> &lt;div class=&quot;mw-collapsible-content&quot;&gt;<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> &lt;/div&gt;<br /> &lt;/div&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden: [[Expecco_GUI_Tests_Extension_Reference| GUI Test Referenz]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies im Dialogfenster nach durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14488 Java GUI Plugins 2018-12-13T14:12:54Z <p>Chzeiher: /* Verbindungsaufbau */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei in manchen Fällen nicht mehr funktionieren.&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> <br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein<br /> <br /> &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;<br /> ParameterListe (ausklappbar)<br /> &lt;div class=&quot;mw-collapsible-content&quot;&gt;<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> &lt;/div&gt;<br /> &lt;/div&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden: [[Expecco_GUI_Tests_Extension_Reference| GUI Test Referenz]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14487 Java GUI Plugins 2018-12-13T12:51:09Z <p>Chzeiher: /* Anforderungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei in manchen Fällen nicht mehr funktionieren.&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> <br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein<br /> <br /> &lt;div class=&quot;toccolours mw-collapsible mw-collapsed&quot;&gt;<br /> ParameterListe (ausklappbar)<br /> &lt;div class=&quot;mw-collapsible-content&quot;&gt;<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> &lt;/div&gt;<br /> &lt;/div&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14486 Java GUI Plugins 2018-12-13T12:16:49Z <p>Chzeiher: /* Anforderungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei in manchen Fällen nicht mehr funktionieren.&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> <br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [https://doc.expecco.de/w2.x/images/0/03/Java_module_cheat_sheet.pdf hier] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein.<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14485 Java GUI Plugins 2018-12-13T12:15:40Z <p>Chzeiher: /* Anforderungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei in manchen Fällen nicht mehr funktionieren.&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> <br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [[:Datei:java_module_cheat_sheet.pdf|hier]] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein.<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Datei:Java_module_cheat_sheet.pdf&diff=14484 Datei:Java module cheat sheet.pdf 2018-12-13T11:59:14Z <p>Chzeiher: © https://zeroturnaround.com/rebellabs/java-9-modules-cheat-sheet/</p> <hr /> <div>© https://zeroturnaround.com/rebellabs/java-9-modules-cheat-sheet/</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14483 Java GUI Plugins 2018-12-13T11:58:20Z <p>Chzeiher: /* Zugriffsberechtigungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei in manchen Fällen nicht mehr funktionieren.&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> <br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;<br /> Eine kurze Übersicht der Kommandos findet man [[Datei:java_module_cheat_sheet.pdf|hier]] [https://zeroturnaround.com/rebellabs ©]<br /> &lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein.<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14482 Java GUI Plugins 2018-12-13T11:41:19Z <p>Chzeiher: /* Anforderungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> * (Alternativ kann man Zugriffsrechte in den module-info.java Dateien direkt verändern, dies ist jedoch alles andere als praktikabel)<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei in manchen Fällen nicht mehr funktionieren.&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> <br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;&lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)&lt;br&gt;<br /> Die folgenden Parameter müssen beim Start der Java Anwendung vorhanden sein.<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14481 Java GUI Plugins 2018-12-13T11:32:51Z <p>Chzeiher: /* Zugriffsberechtigungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen (''Am Beispiel JDK_JAVA_OPTIONS welche bei jedem JVM Start geladen wird'')&lt;br&gt;<br /> '''für Windows Systeme'''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> '''für Unix Systeme'''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei in manchen Fällen nicht mehr funktionieren.&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.&lt;br&gt;<br /> <br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;&lt;hr&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14480 Java GUI Plugins 2018-12-13T11:29:50Z <p>Chzeiher: /* Zugriffsberechtigungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> '''Bis Java 11''' sollte es ausreichen, folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen&lt;br&gt;<br /> ''für Windows Systeme''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> ''für Unix Systeme''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> '''Ab Java 11''' erfolgt für die Kapselung von Modulen eine striktere Trennung:&lt;br&gt; <br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; wird dabei in manchen Fällen nicht mehr funktionieren.&lt;br&gt;<br /> In diesem Fall müssen beim Programmstart zusätzliche Parameter angegeben werden, welche Expecco einen Zugriff auf die innewohnenden Ressourcen gewähren.<br /> <br /> Je nach verwendeter Technologie können die benötigten Parameter variieren.&lt;br&gt;<br /> '''Beispiel JavaFX''':&lt;br&gt;<br /> Die Umgebungsvariable &lt;code&gt;PATH_TO_FX&lt;/code&gt; die auf das JavaFX Verzeichnis zeigt muss gesetzt sein (Funktionsweise s.o.)<br /> *&lt;code&gt;--module-path &quot;%PATH_TO_FX%&quot; &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-modules=javafx.controls &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.swing &lt;/code&gt;<br /> * &lt;code&gt;--add-modules=javafx.web &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.sg.prism=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.javafx.stage=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.layout=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.control.skin=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/javafx.scene.chart=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.charts=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.image=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.shape=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.text=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.application=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.geometry=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.robot=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/com.sun.glass.ui.win=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.graphics/javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-opens javafx.base/javafx.event=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-opens javafx.base/com.sun.javafx.runtime=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.util=ALL-UNNAMED &lt;/code&gt;<br /> * &lt;code&gt;--add-exports javafx.graphics/com.sun.javafx.scene.input=ALL-UNNAMED &lt;/code&gt;<br /> <br /> * &lt;code&gt;--add-exports javafx.web/com.sun.webkit.dom=ALL-UNNAMED&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14479 Java GUI Plugins 2018-12-13T10:53:28Z <p>Chzeiher: /* Java Optionen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Zugriffsberechtigungen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung (sowie des Java Agenten) zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariablen die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> Bis Java 11 reicht es aus folgende Parameter zu setzen:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen einer Umgebungsvariable funktioniert folgendermaßen&lt;br&gt;<br /> ''für Windows Systeme''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> ''für Unix Systeme''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14478 Java GUI Plugins 2018-12-13T09:50:24Z <p>Chzeiher: /* Java Optionen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Java Optionen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung sowie des Java Agenten zwei zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariable die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> Die Parameter lauten wie folgt:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen der Umgebungsvariable funktioniert folgendermaßen&lt;br&gt;<br /> ''für Windows Systeme''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> ''für Unix Systeme''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14477 Java GUI Plugins 2018-12-13T09:50:06Z <p>Chzeiher: /* Java Optionen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Java Optionen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung sowie des Java Agenten zwei zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariable die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> Die Parameter lauten wie folgt:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen der Umgebungsvariable funktioniert folgendermaßen&lt;br&gt;<br /> ''für Windows Systeme''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> ''für Unix Systeme''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> <br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14476 Java GUI Plugins 2018-12-13T09:49:35Z <p>Chzeiher: /* Java Optionen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Java Optionen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung sowie des Java Agenten zwei zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariable die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> Die Parameter lauten wie folgt:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen der Umgebungsvariable funktioniert folgendermaßen&lt;br&gt;<br /> ''für Windows Systeme''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> ''für Unix Systeme''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14475 Java GUI Plugins 2018-12-13T09:49:23Z <p>Chzeiher: /* Java Optionen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Java Optionen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung sowie des Java Agenten zwei zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariable die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> Die Parameter lauten wie folgt:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen der Umgebungsvariable funktioniert folgendermaßen&lt;br&gt;<br /> ''für Windows Systeme''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;<br /> ''für Unix Systeme''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14474 Java GUI Plugins 2018-12-13T09:46:01Z <p>Chzeiher: /* Verbindungsaufbau */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Java Optionen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung sowie des Java Agenten zwei zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariable die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> Die Parameter lauten wie folgt:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen der Umgebungsvariable funktioniert folgendermaßen&lt;br&gt;<br /> ''für Windows Systeme''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> <br /> <br /> ''für Unix Systeme''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14473 Java GUI Plugins 2018-12-13T09:45:36Z <p>Chzeiher: /* expecco GUI Browser */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Java Optionen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung sowie des Java Agenten zwei zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariable die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> Die Parameter lauten wie folgt:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen der Umgebungsvariable funktioniert folgendermaßen&lt;br&gt;<br /> ''für Windows Systeme''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> <br /> <br /> ''für Unix Systeme''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14472 Java GUI Plugins 2018-12-13T09:45:06Z <p>Chzeiher: /* Verbindungsaufbau */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Java Optionen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung sowie des Java Agenten zwei zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariable die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> Die Parameter lauten wie folgt:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen der Umgebungsvariable funktioniert folgendermaßen&lt;br&gt;<br /> ''für Windows Systeme''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> <br /> <br /> ''für Unix Systeme''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> ^Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] &lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;hr width=&quot;50%&quot;&gt;&lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Datei:Windows_Setenvironment.png&diff=14471 Datei:Windows Setenvironment.png 2018-12-13T09:34:36Z <p>Chzeiher: </p> <hr /> <div></div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14470 Java GUI Plugins 2018-12-13T09:25:14Z <p>Chzeiher: /* Anforderungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> <br /> =====Java Optionen=====<br /> <br /> Um eine Verbindung auf dem Zielsystem garantieren zu können, müssen beim Start der zu testenden Anwendung sowie des Java Agenten zwei zusätzliche Parameter mitgegeben werden.&lt;br&gt;<br /> Dabei ergeben sich zwei Möglichkeiten dies zu tun<br /> <br /> * Setzen einer Umgebungsvariable die automatisch beim Start jeder Java Anwendung geladen wird&lt;br&gt;<br /> * Manuelle Übergabe der Parameter bei jedem Start einer Java Anwendung<br /> <br /> Die Parameter lauten wie folgt:&lt;br&gt;<br /> &lt;code&gt;-Djdk.attach.allowAttachSelf=true&lt;/code&gt; &lt;br&gt;<br /> &lt;code&gt;--illegal-access=permit&lt;/code&gt; &lt;br&gt;<br /> <br /> Das Setzen der Umgebungsvariable funktioniert folgendermaßen&lt;br&gt;<br /> ''für Windows Systeme''&lt;br&gt;<br /> * &lt;code&gt;setx JDK_JAVA_OPTIONS &quot;-Djdk.attach.allowAttachSelf=true; --illegal-access=permit&quot;&lt;/code&gt;<br /> * oder über das GUI (Windowstaste + Pause).&lt;br&gt;<br /> [[Datei:Windows Setenvironment.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> <br /> <br /> ''für Unix Systeme''&lt;br&gt;<br /> * Bash: &lt;code&gt;export _JAVA_OPTIONS='-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt; <br /> * C Shell: &lt;code&gt;setenv _JAVA_OPTIONS '-Djdk.attach.allowAttachSelf=true; --illegal-access=permit'&lt;/code&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14452 Java GUI Plugins 2018-12-12T15:12:07Z <p>Chzeiher: /* Verbindungsaufbau */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14451 Java GUI Plugins 2018-12-12T15:06:00Z <p>Chzeiher: /* Installation auf dem expecco Rechner */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.&lt;br&gt;<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. &lt;br&gt;<br /> Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14450 Java GUI Plugins 2018-12-12T15:04:53Z <p>Chzeiher: /* Anforderungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> &lt;br&gt;Aufgrund von JDK Änderungen zwischen den Java Versionen, können potentiell Versionskonflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14449 Java GUI Plugins 2018-12-12T15:01:36Z <p>Chzeiher: /* Anforderungen */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt. [[Java GUI Plugins#Fehlerbehandlung|Weitere Informationen dazu.]]&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14448 Java GUI Plugins 2018-12-12T14:57:55Z <p>Chzeiher: /* Verbindungsaufbau */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt.&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;&lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14447 Java GUI Plugins 2018-12-12T14:57:11Z <p>Chzeiher: /* Fehlerbehandlung */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt.&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell auftreten und sind einfach behebbar:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14446 Java GUI Plugins 2018-12-12T14:55:50Z <p>Chzeiher: /* Verbindungsaufbau */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt.&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; (roter Kreis) aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell Probleme machen und sind leicht zu beheben:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14445 Java GUI Plugins 2018-12-12T14:55:26Z <p>Chzeiher: /* Verbindungsaufbau */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt.&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den &lt;code&gt;GUI Browser&lt;/code&gt; (schwarzer Kreis) im Reiter &lt;code&gt;Verbinden&lt;/code&gt; die Option &lt;code&gt;Java&lt;/code&gt; aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell Probleme machen und sind leicht zu beheben:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14444 Java GUI Plugins 2018-12-12T14:54:31Z <p>Chzeiher: /* Verbindungsaufbau */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt.&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als '''Leitfaden''' dienen kann&lt;br&gt;<br /> &lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den GUI Browser (schwarzer Kreis) im Reiter Verbinden die Option Java aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell Probleme machen und sind leicht zu beheben:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14443 Java GUI Plugins 2018-12-12T14:54:00Z <p>Chzeiher: </p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt.&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als Leitfaden dienen kann&lt;br&gt;<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den GUI Browser (schwarzer Kreis) im Reiter Verbinden die Option Java aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> ==== Verbindung zu Entfernten Systemen ====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> ==== Fehlerbehandlung ====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell Probleme machen und sind leicht zu beheben:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Datei:JavaSwing_GUI_Browser.png&diff=14442 Datei:JavaSwing GUI Browser.png 2018-12-12T14:52:48Z <p>Chzeiher: Chzeiher lud eine neue Version von „Datei:JavaSwing GUI Browser.png“ hoch</p> <hr /> <div></div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14441 Java GUI Plugins 2018-12-12T14:47:04Z <p>Chzeiher: /* Verbindungsdialog */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt.&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als Leitfaden dienen kann&lt;br&gt;<br /> =====Verbindungsdialog=====<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den GUI Browser (schwarzer Kreis) im Reiter Verbinden die Option Java aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> =====Verbindung zu Entfernten Systemen=====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> =====Fehlerbehandlung=====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell Probleme machen und sind leicht zu beheben:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14440 Java GUI Plugins 2018-12-12T14:46:53Z <p>Chzeiher: /* Verbindungsdialog */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt.&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als Leitfaden dienen kann&lt;br&gt;<br /> =====Verbindungsdialog=====<br /> [[Datei:JavaSwing GUI Browser.png|border|550px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den GUI Browser (schwarzer Kreis) im Reiter Verbinden die Option Java aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> =====Verbindung zu Entfernten Systemen=====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> =====Fehlerbehandlung=====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell Probleme machen und sind leicht zu beheben:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14439 Java GUI Plugins 2018-12-12T14:46:30Z <p>Chzeiher: /* Verbindungsdialog */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt.&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als Leitfaden dienen kann&lt;br&gt;<br /> =====Verbindungsdialog=====<br /> [[Datei:JavaSwing GUI Browser.png|border|500px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den GUI Browser (schwarzer Kreis) im Reiter Verbinden die Option Java aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> =====Verbindung zu Entfernten Systemen=====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> =====Fehlerbehandlung=====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell Probleme machen und sind leicht zu beheben:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Java_GUI_Plugins&diff=14438 Java GUI Plugins 2018-12-12T14:46:16Z <p>Chzeiher: /* Verbindungsdialog */</p> <hr /> <div>[[Datei:AllJavaInterfaces.png|thumb|300px]]<br /> expecco unterstützt unterschiedliche UI-Frameworks. Hierzu zählen unter anderem auch JavaFX,<br /> Java Swing und Java SWT. Die folgenden Abschnitte sollen einen Überblick in die von expecco unterstützten Java UI-Frameworks geben, um Ihnen einen schnellen und einfachen Einstieg zu ermöglichen.<br /> In diesem Zusammenhang wird Ihnen bei dieser Einführung von den Hauptmerkmalen der einzelnen Frameworks über die Funktionsweise, die Konfigurationen und den Anforderungen bis hin zu der Verwendung einzelner Funktionsbausteine aus den jeweiligen 'Funktionsbibliotheken' näher erläutert.<br /> Um das Verständnis zum theoretischen Teil noch zu festigen, wird im Anschluss ein Praxisnahes Beispiel Schritt für Schritt durchgearbeitet und beschrieben, bei dem Sie aktiv mitarbeiten können. Die dazu benötigten Testsuiten und Anwendungen laden Sie sich bitte über die in den Abschnitten zu Verfügung gestellten Links herunter.<br /> <br /> == Java Swing ==<br /> <br /> Diese Erweiterung für expecco ermöglicht die Benutzeroberflächen Testautomatisierung für Java Anwendungen deren Benutzeroberflächen mit Swing erstellt wurden. Die Baustein-Bibliothek beinhaltet Blöcke zur Steuerung und Überprüfung von Swing Benutzeroberflächen. Zudem integriert sich diese Erweiterung in die expecco GUI Test Extension. Diese dient der Unterstützung bei der Entwicklung von Testsequenzen.<br /> <br /> === Hauptmerkmale ===<br /> <br /> * Automatisierte Bedienung und Überprüfung von Swing Benutzeroberflächen<br /> * Gleichzeitige Bedienung mehrerer Anwendungen<br /> * Steuerung von Swing Benutzeroberflächen auf entfernten Zielsystemen<br /> * Steuerung von bereits eigenständig Laufenden Java Anwendungen (keine Änderung am Quell-Code notwendig, Keine Rekompilierung der Anwendung nötig)<br /> * Adressierung der Bedienelemente durch Pfade ähnliche dem XPath<br /> * Zugriff auf Objektebene durch Java Bridge Interface Library möglich<br /> * Integration in die expecco GUI Tests Extension<br /> * Block-Bibliothek mit Aktionen und Überprüfungen für Swing Komponenten<br /> <br /> === Funktionsweise ===<br /> <br /> Das Interface baut eine Verbindung zur Java VM auf, und stellt Funktionen zum Lesen von Widget-Attributen, Aufnehmen von Benutzereingaben sowie zum Fernsteuern der Anwendung zur Verfügung. Außerdem werden in einer Bibliothek zusätzliche Bausteine zur Automatisierung von Tests bereitgestellt.<br /> Im wesentlichen besteht das Java Swing plugin aus zwei Teilen, der Erweiterung<br /> für expecco und der Applikationssteuerung (Agent). Zur Steuerung der Swing Anwendung wird ein so genannter Agent in die Java Virtual Machine der laufenden Java Anwendung geladen. Um den Agenten zu laden wird ein Java Development Kit 1.8 (JDK) oder höher benötigt. Die zu Testende Anwendung kann jedoch in einer normalen Java Runtime Edition 1.8 (JRE) ausgeführt werden.<br /> <br /> === Anforderungen ===<br /> <br /> Auf dem Rechner auf dem die zu testende Anwendung laufen soll (lokal oder entfernt):<br /> <br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java Development Kit 1.8] oder höher (zum laden des Agents)<br /> * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java Runtime Edition 1.8] oder höher (zur Ausführung der zu testenden Anwendung)<br /> <br /> Auf dem expecco Rechner gelten die expecco Anforderungen.<br /> <br /> Bitte nehmen Sie zur Kenntnis, dass sowohl der Agent als auch die zu testende Anwendung, jeweils beide entweder mit 32 oder 64 Bit Java gestartet werden müssen, da ansonsten keine Verbindung möglich ist.<br /> Aufgrund von JDK Änderungen zwischen den Java Versionen, können bei falscher Handhabung Konflikte auftreten.&lt;br&gt;&lt;br&gt;Die Kompatibilität der Versionen ist wie folgt.&lt;br&gt;<br /> [[Datei:JavaSwing Bridge Compatibility.png|border|400px|]]<br /> &lt;br&gt;<br /> <br /> === Konfiguration ===<br /> ==== Installation auf dem expecco Rechner ====<br /> <br /> Die Java Swing Erweiterung wird automatisch durch ein Installationsprogramm in expecco Installiert.<br /> Wird die zu Testende Anwendung zur Entwicklung von Testsequenzen auf dem gleichen Rechner ausgeführt sollte nach dem Start von expecco unter&lt;br&gt;&lt;code&gt;Extras =&gt; Einstellungen =&gt; Erweiterungen =&gt; Java Bridge&lt;/code&gt; <br /> der Lokale Pfad zu einem Java Development Kit 1.8 oder höher angegeben werden. &lt;br&gt;Die unbedingt erforderliche Einstellung hier ist &lt;code&gt;Pfad zur JDK Installation&lt;/code&gt; welcher für die Hauptverbindung genutzt wird.&lt;br&gt; &lt;code&gt;Pfad zur Java Installation&lt;/code&gt; ist eine alternative Einstellung für Groovy, welches nur ein JRE benötigt. Der Java Agent wird in lokalen Verbindungen automatisch mit diesen Einstellungen gestartet. <br /> <br /> [[Datei:JDKPfadEinstellungen.png|border|600px|]]<br /> <br /> ==== Installation auf dem Testanwendungsrechner ====<br /> <br /> Es muss das javaBin Verzeichnis des Expecco Bridge Frameworks auf den Testrechner kopiert werden. Dieses befindet sich im expecco Installationsverzeichnis unter:<br /> <br /> &lt;nowiki&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/nowiki&gt;<br /> <br /> === expecco GUI Browser ===<br /> <br /> Der expecco GUI-Browser ist ein zusätzliches 'Werkzeug', welches die Möglichkeit bietet, laufende Anwendungen zu analysieren und Testsequenzen zu entwickeln. Anschließend kann man die Informationen, wie beispielsweise Namen und Eigenschaften einzelner Elemente dazu verwenden, um mit der Funktionsbibliothek Aktionen auszuführen bzw. mit einzelnen Elementen zu interagieren.<br /> <br /> ==== Verbindungsaufbau ====<br /> <br /> Im Folgenden eine kurze Bilderstrecke, die Ihnen beim Einrichten einer Verbindung als Leitfaden dienen kann&lt;br&gt;<br /> =====Verbindungsdialog=====<br /> [[Datei:JavaSwing GUI Browser.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Zunächst wählt man über den GUI Browser (schwarzer Kreis) im Reiter Verbinden die Option Java aus.<br /> Im sich öffnenden Dialog kann man nun zwischen 3 Optionen wählen.<br /> &lt;br&gt;<br /> <br /> * '''Anwendung auf der lokalen Maschine starten''' &lt;br&gt; liefert eine bequeme Möglichkeit eine lokale Java Anwendung per Kommandozeilenbefehl zu starten<br /> * '''Zu einer laufenden Anwendung auf der lokalen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu lokal laufenden Java Anwendungen&lt;br&gt;Der Java Agent wird automatisch mit der Java Version, die Sie in den Expecco Einstellungen festgelegt haben, gestartet.<br /> * '''Zu einer laufenden Anwendung auf einer anderen Maschine verbinden''' &lt;br&gt; Ermöglicht die Verbindung zu einem bereits gestarteten Java Agenten auf einer anderen Maschine &lt;br&gt;Dieser stellt dann die Verbindung zur dort laufenden Java Anwendung her.<br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Window.png|border|500px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Eine Suche nach Java Anwendungen listet uns alle laufenden Java Virtuellen Maschinen auf, die sich auf dem Zielsystem befinden&lt;br&gt; <br /> (im Beispiel: localhost). Eine Auswahl der einzelnen Einträge listet weitere Informationen über die betreffende Anwendung auf.&lt;br&gt;<br /> [[Datei:JavaSwing Connection Connected.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn eine Verbindung erfolgreich aufgebaut wurde, wird sie automatisch in die Expecco Konfigurationsliste eingetragen.&lt;br&gt;<br /> Dort kann auch der GUI Aufbau der Anwendung als hierarchischer Baum eingesehen werden. &lt;br&gt;<br /> Informationen zum weiteren Vorgehen können Sie hier finden [[Expecco_GUI_Tests_Extension_Reference]] <br /> &lt;br&gt;<br /> [[Datei:JavaSwing Connection Reconnect.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Wenn Sie zu einer zuvor verbundenen Anwendung erneut eine Verbindung aufstellen möchten, können Sie dies durch Rechtsklick auf den Eintrag.&lt;br&gt;<br /> Falls Sie die Anwendung (oder im Fall entferntes System auch den Agenten) zwischenzeitlich neu gestartet haben, müssen Sie die Verbindung eventuell neu aufbauen.&lt;br&gt;<br /> &lt;br&gt;<br /> <br /> =====Verbindung zu Entfernten Systemen=====<br /> [[Datei:JavaSwing Connection RemoteSetup.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Um eine Verbindung remote zu erstellen, muss zunächst auf dem Zielrechner der Java Agent gestartet werden. &lt;br&gt;<br /> Dazu navigieren Sie auf dem Rechner zum zuvor kopierten Verzeichnis &lt;code&gt;...\exept\bridgeFramework\javaBridge\javaBin&lt;/code&gt; &lt;br&gt;<br /> Dort liegt ein Skript, welches automatisch die Java Version in JAVA_HOME erkennt und den korrekten Agenten startet.<br /> * Windows Nutzer starten &lt;code&gt;startAgentLoader.bar&lt;/code&gt;<br /> * UNIX Nutzer starten &lt;code&gt;startAgentLoader.sh&lt;/code&gt;<br /> Diese Skripte können über die Kommandozeile wie im Bild gezeigt mit Parametern versehen werden.<br /> * &lt;code&gt;-ip &lt;HostnameOderIP&gt;&lt;/code&gt; gibt dem Agenten eine spezielle IP an, auf der auf eine Verbindung gewartet werden soll. Nützlich für spezifische Netzwerkmasken.&lt;br&gt; StandardHost ist 0.0.0.0.<br /> * &lt;code&gt;-port &gt;PortNummer&lt;/code&gt; gibt dem Agenten einen spezifischen Port an, auf dem auf Verbindungen von Expecco gewartet werden soll.&lt;br&gt; Standardport ist 56784.<br /> <br /> =====Fehlerbehandlung=====<br /> [[Datei:JavaSwing Connection Warnings.png|border|600px|]]<br /> &lt;br&gt;&lt;br&gt;<br /> Sollten bei den Anwendungen in dieser Liste Probleme auftreten wie im oben stehenden Bild zu sehen ist,<br /> liefert der Verbindungsdialog automatisch einen Lösungsvorschlag.&lt;br&gt; Wenn der auftretende Fehler eine Verbindung unmöglich machen würde, wird der Entsprechende Eintrag automatisch als ungültig markiert.<br /> &lt;br&gt;<br /> Folgende Fehlermeldungen könnten eventuell Probleme machen und sind leicht zu beheben:<br /> ::{|<br /> |JAVA VERSION MISMATCH<br /> |Wie im Bild zu sehen, kann es zu Java Versionskonflikten zwischen dem Agenten und der Anwendung kommen.&lt;br&gt; In diesem Fall ist es am einfachsten die Expecco Einstellungen für Java Bridge anzupassen. <br /> |-<br /> |32 BIT - 64 BIT KONFLIKT<br /> |32 und 64 Bit Versionen von Java sind nicht miteinander Kompatibel. &lt;br&gt;Sowohl der Agent als auch die Anwendung müssen mit der selben &quot;Bit Version&quot; von Java gestartet werden.<br /> |-<br /> |UNABLE TO DETERMINE VERSION<br /> |Der Agent kann nicht feststellen, welche Java Version die Anwendung nutzt. &lt;br&gt;Eine Verbindung ist eventuell möglich, es kann aber potentiell ein Versionskonflikt auftreten.<br /> |-<br /> |CONNECTION REFUSED<br /> |In seltenen Fällen, kann die Socket-Verbindung zu einer Anwendung oder dem Agent durch eine vorherige Verbindung blockiert werden. &lt;br&gt;Ein Neustart der Anwendung und des Agenten (im Fall remote) sollte helfen. &lt;br&gt;Sollte das Problem bestehen bleiben, prüfen Sie bitte auch ihre Firewall Einstellungen, die eine Verbindung verhindern können.<br /> |}<br /> :<br /> <br /> === JavaSwingLibrary ===<br /> === Example ===<br /> === FAQ ===<br /> *'''Der Baum im GUI-Browsers zeigt nicht alle Elemente meiner Applikation'''<br /> :Eine Applikation besteht aus vielen verschiedenen Elementen. Manche davon sind nicht interaktiv, das heißt sie sind für den Anwender nicht direkt sichtbar und dienen lediglich der Formatierung, wie beispielsweise Panels. Das Vorhandensein solcher Elemente führt dazu, dass der Baum sehr groß und tief werden kann. Da diese Elemente in der Regel für die Automatisierung uninteressant sind, werden sie in expecco standardmäßig ausgeblendet.<br /> :Wenn Sie in Ihrem Fall auf eines dieser Elemente zugreifen wollen oder es für das Erstellen eines eindeutigen Pfades brauchen, können Sie dieses Verhalten ändern. In der JavaSwingLibrary gibt es dafür den Baustein ''Set Skip Mode''. Dabei sind vier Modi auswählbar:<br /> ::{|<br /> |INTERACTIVE <br /> |nur interaktive Elemente einsammeln<br /> |-<br /> |ALL<br /> |alle Elemente einsammeln<br /> |-<br /> |INTERACTIVE_HYBRID<br /> |wie INTERACTIVE, aber mit dem Fallback zu ALL wenn ein Pfad nicht aufgelöst werden kann<br /> |-<br /> |ALL_HYBRID<br /> |wie ALL, aber mit dem Fallback auf INTERACTIVE wenn ein Pfad nicht aufgelöst werden kann<br /> |}<br /> :Durch das Ausführen des Bausteins ändert sich das Verhalten für die aktuelle Verbindung. Es bezieht sich sowohl darauf, was im Baum angezeigt wird, als auch, wie mit den Pfaden an den Bausteinen umgegangen wird.<br /> <br /> == Java SWT ==<br /> == JavaFX ==</div> Chzeiher https://doc.expecco.de/index.php?title=Datei:JavaSwing_GUI_Browser.png&diff=14437 Datei:JavaSwing GUI Browser.png 2018-12-12T14:45:42Z <p>Chzeiher: Chzeiher lud eine neue Version von „Datei:JavaSwing GUI Browser.png“ hoch</p> <hr /> <div></div> Chzeiher