1# VM test harness
2
3There are two suites of tests in this directory: run-tests and gtests.
4
5The run-tests are identified by directories named with with a numeric
6prefix and containing an info.txt file. For most run tests, the
7sources are in the "src" subdirectory. Sources found in the "src2"
8directory are compiled separately but to the same output directory;
9this can be used to exercise "API mismatch" situations by replacing
10class files created in the first pass. The "src-ex" directory is
11built separately, and is intended for exercising class loaders.
12Resources can be stored in the "res" directory, which is distributed
13together with the executable files.
14
15The gtests are in named directories and contain a .java source
16file.
17
18All tests in either suite can be run using the "art/test.py"
19script. Additionally, run-tests can be run individidually. All of the
20tests can be run on the build host, on a USB-attached device, or using
21the build host "reference implementation".
22
23To see command flags run:
24
25```sh
26$ art/test.py -h
27```
28
29## Running all tests on the build host
30
31```sh
32$ art/test.py --host
33```
34
35## Running all tests on the target device
36
37```sh
38$ art/test.py --target
39```
40
41## Running all gtests on the build host
42
43```sh
44$ art/test.py --host -g
45```
46
47## Running all gtests on the target device
48
49```sh
50$ art/test.py --target -g
51```
52
53## Running all run-tests on the build host
54
55```sh
56$ art/test.py --host -r
57```
58
59## Running all run-tests on the target device
60
61```sh
62$ art/test.py --target -r
63```
64
65## Running one run-test on the build host
66
67```sh
68$ art/test.py --host -r -t 001-HelloWorld
69```
70
71## Running one run-test on the target device
72
73```sh
74$ art/test.py --target -r -t 001-HelloWorld
75```
76