You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ace.apache.org by ma...@apache.org on 2013/04/23 15:13:12 UTC
svn commit: r1470938 - /ace/site/trunk/content/dev-doc/getting-started.mdtext
Author: marrs
Date: Tue Apr 23 13:13:12 2013
New Revision: 1470938
URL: http://svn.apache.org/r1470938
Log:
Modified the getting started guide after some changes to the release process.
Modified:
ace/site/trunk/content/dev-doc/getting-started.mdtext
Modified: ace/site/trunk/content/dev-doc/getting-started.mdtext
URL: http://svn.apache.org/viewvc/ace/site/trunk/content/dev-doc/getting-started.mdtext?rev=1470938&r1=1470937&r2=1470938&view=diff
==============================================================================
--- ace/site/trunk/content/dev-doc/getting-started.mdtext (original)
+++ ace/site/trunk/content/dev-doc/getting-started.mdtext Tue Apr 23 13:13:12 2013
@@ -10,17 +10,18 @@ There are two ways to obtain a copy of t
Point your browser to: http://ace.apache.org/download.html
-On that page you will find, amongst others, a link to the latest released sources. The page will automatically select a download mirror close to you. Download the archive and then type:
+On that page you will find, amongst others, a link to the latest released sources, plus an archive containing all binary third-party dependencies. The page will automatically select a download mirror close to you. Download both the source and dependencies archive and then type:
:::sh
- $ unzip apache-ace-src-1.0.0.zip
+ $ unzip apache-ace-1.0.0-src.zip
+ $ unzip apache-ace-1.0.0-deps.zip
### Checkout from subversion
:::sh
$ svn co http://svn.apache.org/repos/asf/ace/trunk apache-ace
-In both cases you end up with a copy of the source code in the apache-ace folder.
+In both cases you end up with a copy of the source code.
## Building the sources
@@ -68,15 +69,27 @@ If you want to develop for ACE, you migh
#### Running & debugging
-One of the benefits of the migration to BndTools is that we can now directly run ACE from Eclipse with almost zero effort. In fact, it is even possible to directly debug or profile ACE from Eclipse.
+One of the benefits of the migration to BndTools is that we can now directly run ACE from Eclipse with almost zero effort. In fact, it is even possible to directly debug or profile ACE from Eclipse. All runnable projects start with "run-" and contain a ".bndrun" file.
##### ACE server
-To run or debug the ACE server, you open up the "<tt>server.bndrun</tt>" file in the "run-server" project. This will present you with a view in which you can directly choose to run it (use "Run OSGi") or debug it (use "Debug OSGi"). Alternatively, you can right click on "server.bndrun" and choose either "Run As -> OSGi Run" or "Debug As -> OSGi Run".
+To run or debug the ACE server, you open up the "<tt>server.bndrun</tt>" file in the "run-server" project. This will present you with a view in which you can directly choose to run it (use "Run OSGi") or debug it (use "Debug OSGi"). Alternatively, you can right click on "server.bndrun" and choose either "Run As -> Bnd OSGi Run Launcher" or "Debug As -> Bnd OSGi Run Launcher".
+
+##### ACE obr
+
+To run or debug the ACE obr, you open up the "<tt>obr.bndrun</tt>" file in the "run-obr" project. This will present you with a view in which you can directly choose to run it (use "Run OSGi") or debug it (use "Debug OSGi"). Alternatively, you can right click on "obr.bndrun" and choose either "Run As -> Bnd OSGi Run Launcher" or "Debug As -> Bnd OSGi Run Launcher".
+
+##### ACE client
+
+To run or debug the ACE client, you open up the "<tt>client.bndrun</tt>" file in the "run-client" project. This will present you with a view in which you can directly choose to run it (use "Run OSGi") or debug it (use "Debug OSGi"). Alternatively, you can right click on "client.bndrun" and choose either "Run As -> Bnd OSGi Run Launcher" or "Debug As -> Bnd OSGi Run Launcher".
+
+##### ACE server-allinone
+
+To run or debug the "all in one" ACE server, you open up the "<tt>server-allinone.bndrun</tt>" file in the "run-server-allinone" project. This will present you with a view in which you can directly choose to run it (use "Run OSGi") or debug it (use "Debug OSGi"). Alternatively, you can right click on "server-allinone.bndrun" and choose either "Run As -> Bnd OSGi Run Launcher" or "Debug As -> Bnd OSGi Run Launcher".
##### ACE target
-You can also directly run a target from Eclipse. Doing this is almost equal as running the ACE server described in the previous section. The only difference is that for running a target, you need to use the "<tt>target.bndrun</tt>" file from the "run-target" project.
+You can also directly run a target from Eclipse. Doing this is almost equal as running the ones described in the previous sections. The only difference is that for running a target, you need to use the "<tt>target.bndrun</tt>" file from the "run-target" project.
##### Unit tests