Project

General

Profile

Step 3 - First steps with Z2 on Git » History » Version 11

Udo Offermann, 10.09.2012 17:37

1 1 Udo Offermann
h1. First steps with z2 v2.1
2
3 2 Udo Offermann
[[How_to_install_z2_v21|prev]] :: [[Z2_v21|home]]
4 1 Udo Offermann
5 4 Udo Offermann
h2. Prerequisites
6
7
You need a cloned z2-base.core repository as described on the [[How_to_install_z2_v21|previous]] page.
8
Furthermore you need the "Eclipse-IDE":http://www.eclipse.org (one of Galileo, Helios, Indigo or Juno is fine) and the "Egit plg-in:":http://www.eclipse.org/egit. 
9
10 1 Udo Offermann
h2. First steps with the z2-environment
11
12 4 Udo Offermann
As the next step you will learn how to do the first development steps using Eclipse. Please stop the server before you continue because we will now show you how to start it from inside the Eclipse IDE.
13 3 Udo Offermann
14 4 Udo Offermann
We recommend to keep the repositories and workspace close together. So please go back to the "z2-base" directory (@cd ../../..@, if you are still inside the "run/bin" directory) and create a folder called "workspace" - this will be used as the workspace root for Eclipse:
15 3 Udo Offermann
16
<pre>
17 6 Udo Offermann
:bin$ cd ../../..
18
:z2-base$ mkdir workspace
19
:z2-base$ ls -l
20
total 0
21
0 drwxr-xr-x   2 mr_x  staff   68  7 Sep 16:34 workspace
22
0 drwxr-xr-x  12 mr_x  staff  408  7 Sep 15:11 z2-base.core
23
:z2-base$
24 1 Udo Offermann
</pre>
25
26
Now start Eclipse and choose @.../z2-base/workspace@ as your workspace folder.
27
28
We have to add the core repository to the EGit repositories view. Detailed documentation of how-to work with EGit can be found on the "EGit Wiki pages":http://wiki.eclipse.org/EGit/User_Guide.
29 6 Udo Offermann
On the Git perspective choose "Add an existing local Git repository". In the "Directory" field type in the path to the ".../z2-base" directory. 
30 1 Udo Offermann
After hitting "search" the search results should list the _z2-base.core_ repository, click "finish" and the repositories view should look like this:
31 4 Udo Offermann
32
> !EGit_repo_view_with_z2-core.png!
33
34 6 Udo Offermann
Now import the core project from the repository. Right-click the repository, choose "Import projects..." from the context menu and click "next" and then "finish". 
35
On the Java perspective the "core" project should be now available in the package explorer:
36
37
> !z2_core_project_in_package_explorer.png!
38 3 Udo Offermann
39 7 Udo Offermann
The core project contains two launch entries, one for Linux/Mac OS and one for Windows. Right click the one that fits to your OS and choose "Run As >" and "z2_base".
40
This starts the z2-environment again and opens the z2-gui inside a new window labled "Z2 Home (z2-base v2.1)":
41
42 8 Udo Offermann
> !z2_gui.png!
43 7 Udo Offermann
44 9 Udo Offermann
The z2-environment provides an Eclipse plug-in called "Eclipsoid" that enables convenient development of z2 applications. 
45
Developing modular software requires that the IDE can resolve the dependencies between single projects. 
46
Either you import all projects into your workspace or you live with the red x-markers indicating that Eclipse cannot compile the Java sources properly. 
47
The third option is that someone else resolves the dependencies for you - this is what the Eclipsoid does. This way you can checkout and focus on a project subsets while
48
the Eclipsoid plug-in provides the transitive closure of all required prjects and libraries. 
49
There are other features provided by the Eclipsoid plug-in that are explained in more details on the [[Eclipsoid]] wiki pages.
50 3 Udo Offermann
51
h2. Installation of the Eclipsoid plug-in
52
53 9 Udo Offermann
The z2-environment that you just started contains the update-site for the Eclipsoid plug-in. Open the software update/installation wizard (in Indigo it's located at "Help/Install New Software...") 
54
and use http://localhost:8080/eclipsoid/update as update-site URL (the field labled "Work with"):
55 3 Udo Offermann
56 9 Udo Offermann
> !Install_Eclipsoid.png!
57 3 Udo Offermann
58 11 Udo Offermann
Please note that the Eclipsoid version will be different because the screenshots are made with an intermediate version of the plug-in.
59 3 Udo Offermann
Complete the installation wizard (you can speed up the installation procedure by deselecting "Contact all update sites during install...") and restart Eclipse. 
60
Now you should see a new menu entry labled "z2-Environment" and two new icons:
61
62 1 Udo Offermann
>!Eclipsoid_menu_entries_and_icons.png!
63 11 Udo Offermann
64
65 2 Udo Offermann
[[How_to_install_z2_v21|prev]] :: [[Z2_v21|home]]