README
1This suite contains automated client sanity tests which can be run using JTReg.
2
3Contact alexander.kouznetsov@oracle.com in case of issues.
4
5-------------------------------------------------------------------------------
6How to run:
7
81) Download/Install the JDK to be tested in the system.
9 (For example C:/java/jdk1.9.0 in windows or
10 /export/jdk/jdk1.9.0 in linux/mac/solaris)
112) Download/Install JTReg harness, minimum required version is 4.1 b13.
123) Open terminal(cmd in windows, *not* cygwin) and go to the this directory.
134) To run
14 - see the notes below on how to prepare for the test run
15 - set JT_HOME to <path/to/jtreg>, for example
16 set JT_HOME=C:\Java\client\jtreg (Windows)
17 - run the command
18 'sh <path/to/jtreg/bin/jtreg> -ea -k:\!screenshots -jdk:<Path/to/JDK> SwingSet'
19
20 For example: 'sh C:/jtreg/bin/jtreg -ea -k:\!screenshots -jdk:C:/java/jdk1.9.0 SwingSet' (Windows)
21 'sh /export/jtreg/bin/jtreg -ea -k:\!screenshots -jdk:/export/jdk/jdk1.9.0 SwingSet' (Linux/Solaris)
22 'sh /export/jtreg/bin/jtreg -ea -k:\!screenshots -jdk:/export/jdk/jdk1.9.0/Contents/Home SwingSet' (Mac)
23
24Try to minimize all the other windows for no interference and test stability.
25Do not touch keyboard or mouse, open any window, nor lock the screen while the tests are running.
26The tests will be executed, and the results will be displayed in the terminal.
27
28A report will be generated under
29 a) JTReg: "JTReport/index.html".
30The failure logs could be found under:
31 a) JTReg: "JTWork/<testname>/<testname>.jtr"
32
33The following additional options might be useful:
34-retain:all to keep work files for passed tests
35-k:\!screenshots removal of this option will run tests that require full environment with Robot and screenshots
36-g to run JavaTest GUI
37
38-------------------------------------------------------------------------------
39
40The tests in the suite are based on SwingSet3 demo application. They use Jemmy to
41operate on controls of the demo and verify that it is behaving as expected. Both
42Jemmy and SwingSet3 sources are available as copies in lib folder.
43
44Original Jemmy repository is https://jemmy.java.net
45Original SwingSet3 repository is https://java.net/projects/swingset3