1 |
54 |
nyawn |
The AdvancedWatchpointControl program is a Java-language program distributed
|
2 |
|
|
as an Eclipse project. These instructions assume you have both the
|
3 |
|
|
Eclipse platform and the JDT Java development plugins installed. These
|
4 |
|
|
instructions were written for Eclipse version 3.5.2, though other versions
|
5 |
|
|
should be similar.
|
6 |
|
|
|
7 |
|
|
To build the project in Eclipse, you must first import it into your workspace.
|
8 |
|
|
From the 'File' menu, select 'Import...'. In the Import menu, under the
|
9 |
|
|
'General' folder, select 'Existing Projects into Workspace', then click 'Next'.
|
10 |
|
|
On the next screen, select 'Select root directory', then enter (or browse to)
|
11 |
|
|
the adv_debug_sys/Software/AdvancedWatchpointControl directory. Finally,
|
12 |
|
|
click the 'Finish' button to import the project.
|
13 |
|
|
|
14 |
|
|
AdvancedWatchpointControl depends on the SWT GUI widget toolkit from the
|
15 |
|
|
Eclipse project. This can be downloaded directly from the Eclipse project,
|
16 |
|
|
at http://www.eclipse.org/swt/. Download the version appropriate for your
|
17 |
|
|
operating system.
|
18 |
|
|
|
19 |
|
|
There are (at least) two ways to satisfy the dependancy on SWT. As shipped,
|
20 |
|
|
AdvancedWatchpointControl is configured to depend on a project in the
|
21 |
|
|
workspace called org.eclipse.swt To create this project, you may import the
|
22 |
|
|
SWT project into the workspace from the downloaded archive file in the same
|
23 |
|
|
way you imported AdvancedWatchpointControl.
|
24 |
|
|
|
25 |
|
|
In some versions of the SWT archive, there is a bug which prevents Eclipse
|
26 |
|
|
from importing the project. If this is the case, you must work around.
|
27 |
|
|
Extract the SWT archive, and find the swt.jar file. In Eclipse, right-click
|
28 |
|
|
on the AdvancedWatchpointControl, and click on 'Properties.' Under the
|
29 |
|
|
'Projects' tab, remove the dependancy on org.eclipse.swt. Under the
|
30 |
|
|
'Libraries' tab, remove SWT_CONTAINER/PLATFORM. Then click the 'Add
|
31 |
|
|
External JARs...' button. This will open the 'JAR Selection' dialog. Select
|
32 |
|
|
the swt.jar file from the archive, and click OK.
|
33 |
|
|
|
34 |
|
|
You should now be able to build AdvancedWatchpointControl, and run it as a
|
35 |
|
|
Java application via the Eclipse GUI.
|
36 |
|
|
|
37 |
|
|
If you do not have or wish to install Eclipse, a simple Makefile has been
|
38 |
|
|
included which should be able to build AdvancedWatchpointControl as an
|
39 |
|
|
executable JAR file. Simply type "make" in the project's root directory
|
40 |
|
|
to build the program, which will be called AdvancedWatchpointControl.jar.
|
41 |
|
|
Typing "make run" will build the program, then execute it.
|
42 |
|
|
|
43 |
|
|
A pre-compiled executable JAR file has been included in the root directory of
|
44 |
|
|
AdvancedWatchpointControl, called AdvancedWatchpointControl.jar. To run this
|
45 |
|
|
file using the Sun JVM in Linux, use the command line:
|
46 |
|
|
|
47 |
|
|
>java -jar AdvancedWatchpointControl.jar
|
48 |
|
|
|
49 |
|
|
Other JVMs and operating systems may use different syntax. Note that the
|
50 |
|
|
AdvancedWatchpointControl.jar file includes the SWT library, which is
|
51 |
|
|
distributed under the terms of the Eclipse Public License v1.0. A copy of
|
52 |
|
|
this license may be found in the doc/ subdirectory.
|
53 |
|
|
|
54 |
|
|
|