forked from visad/visad
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
125 lines (100 loc) · 4.16 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
Repository Layout
=================
:core: Everything in the `visad.*` and `edu.ssec.wisc.mcidas.*` namespace.
:deps: Third party dependencies
:examples: VisAD examples with the default namespace (no java package).
::
|-- core
| |-- build
| |-- lib
| `-- src
| |-- edu/...
| `-- visad/...
|
|-- deps
| |-- build
| `-- src
| |-- HTTPClient/...
| |-- Jama/...
| |-- dods/...
| |-- gnu/...
| |-- loci/...
| |-- ncsa/...
| |-- nom/...
| `-- ucar/...
|
`-- examples
|-- build
|-- lib
`-- src
Building
========
There are 4 main build files (the old visad/build.xml has been removed).
The main build file `./build.xml` can be used to build the sub-projects
and create the main VisAD distribution files. Each sub-project also has
its own build file that can be used to perform basic build/clean/jar
operations for just that project.
You can use `ant -p` to display build script target descriptions
for each ant file for more information.
Building the Distribution
-------------------------
Check out https://svn.ssec.wisc.edu/repos/visad
Run `ant dist`
Building the Core
----------------------
You can either work from the entire SVN tree (https://svn.ssec.wisc.edu/repos/visad/trunk)
or check out only the core (https://svn.ssec.wisc.edu/repos/visad/trunk/core).
From your working copy you can simply run any of the commands listed by `ant -p`.
If you jar the core it will extract `lib/visaddeps.jar` and include the class files
in the generated visad.jar.
Building the Examples
---------------------
You can either work from the entire SVN tree (https://svn.ssec.wisc.edu/repos/visad/trunk)
or check out only the core (https://svn.ssec.wisc.edu/repos/visad/trunk/).
The examples project build file check to see if VisAD is available as either a jar file
in the exmples project lib directory or in ../core (assuming you checked out all of
visad/trunk). If it cannot find VisAD it attempts to call ../core/build.xml to build
it before compiling the examples. If you have VisAD in another location you can compile
the examples as follows::
ant -Dvisad.dir=<YOUR VISAD DIR> build
VisAD and Eclipse
=================
:Eclipse: http://www.eclipse.org
First, download and install Eclipse. These instructions assume you will be using
Eclipse >= v3.2. There are multiple flavors of Eclipse that can add varying
amounts of bloat. I recommend you keep it simple and stick to "Eclipse IDE for
Java Developers."
:Note: These instructions were written from a Mac, so you may have to adjust
slightly for your platform.
Install Subclipse
-----------------
Unfortunately, at this time Eclipse does not by default come with SVN
capabilities, so you have to install the Subclipse SVN Plugin
(http://subclipse.tigris.org).
* Open Eclipse
* Select a workspace (where all your project will be saved)
* Start the `Install New Software` wizard. (`Help > Install New Software`)
* Put this URL in the `Work with` box: http://subclipse.tigris.org/update_1.6.x
and click `Add`.
* Give your new software update site a name and click `OK`.
* Check all boxes in the software list and click `Next`.
* Complete the install process by reviewing the install details, accepting
the license, and restarting Eclipse.
* Ensure you have a valid SVN client selected
- Open the preferences and select `Team > SVN`
- Under `SVN Interface` select `SVNKit` and click `OK`
Create and Checkout Projects
----------------------------
* From the menubar select `File > New > Other`
* In the new dialog select `SVN > Check Projects from SVN` and click `Next`
* Select `Create a new repository location` and click next.
* Enter https://svn.ssec.wisc.edu/repos/visad as the url (http*s* not http),
and click `Next`
* Select `trunk > core` and click `Finish`
* (optional) Do the same for `deps` and `examples` if desired.
Building from Eclipse
---------------------
* From the menubar select `Window > Show View > Ant`
* In the `Ant` view tab, right-click and select `Add Buildfiles`
* Select the build file for each sub-project created above and click `OK`
* In the `Ant` view tab, expand a project and select the build target to run