-
Notifications
You must be signed in to change notification settings - Fork 8
Development Environment
For complete distribution build instructions, see the README of the easysoa-demo-dist
repository:
The current page gives details about how to set up your development environment.
- required : git, openssh (for github), ruby (for buildr)
- optional : vim (for conf files, or other shell editor), wget (for HTTP tests), gcc/make/automake/autoconf/python (if you choose to build node.js)
- linux : get them using your favorite package manager
- windows : install cygwin by getting it from http://www.cygwin.com/install.html and executing setup.exe, and configure it with said dependencies
If you don't have one, generate your ssh identity :
linux :
do
ssh-keygen -t dsa
windows : in the cygwin shell do
ssh-user-config
and copy the generated .ssh/ files to your home, and there in ssh/ because eclipse needs it, see http://www.slideshare.net/loianeg/using-the-egit-eclipse-plugin-with-git-hub-2578587
more at http://inside.mines.edu/~gmurray/HowTo/sshNotes.html
Install JDK 6 : either
sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner"
sudo apt-get update
sudo apt-get install sun-java6-jdk
sudo update-alternatives --config java
- or download it from Oracle,
- setup the JAVA_HOME environment
- and twice in Eclipse : Preferences > default JDK, AND in Eclipse Maven : default
linux :
- get and build it (requires gcc, autoconf, automake, python)
do :
git clone --depth 1 https://github.com/joyent/node.git
./configure
make
sudo make install
- OR install it as packages
windows :
- get and install binaries from http://node-js.prcn.co.cc/ (NB. uses its own cygwin)
- OR ge the code and compile it with cygwin as in linux
more at https://github.com/joyent/node/wiki/Installation
(to build frascati and nuxeo)
(requires Java)
get and install the latest Maven 2.x
- including setup of MAVEN_HOME and PATH
- if running it from Eclipse, configure it in Eclipse as an "external installation" of Maven
- tested on maven 2.2.1
FAQ problems compiling frascati (such as blocks on downloading maven dependency tree)
- frascati is incompatible with Maven 3, use the latest Maven 2.x instead
(to build the release)
on linux, install rubygems using your favorite package manager, then do
gem install buildr
on windows (using cygwin with wget, ruby) in the cygwin shell, do
wget http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz
tar xfz rubygems-1.3.1.tgz ; cd rubygems*
ruby setup.rb
gem install buildr
more at http://buildr.apache.org/installing.html
Get Eclipse for Java, Classic or EE (at least check you have the XML editors) and the plugins for :
- Maven. To configure it, in Window > Preferences, add under Java > Build Path > Classpath Variables a new one named M2_REPO and pointing at your maven repository (typically $HOME/.m2/reository). FAQ : for Frascati, remember to configure it to use your external Maven 2 installation.
- EGit : great for visual comparison, BUT more complicated to use than the shell (especially with github upstreams), and not as stable (UI bugs). More at http://www.vogella.de/articles/EGit/article.html
- SVN (to work with the development version of Frascati)
- Node (Optional) : The "Chrome Developer Tools" provides useful debugging features for Node. A full setup tutorial is available on the node wiki.
Netbeans, vim, emacs, notepad++...
with a few useful plugins :
- SOA Client for Firefox
- REST Client for Firefox
- Firebug
- put tabs to sleep when not used https://addons.mozilla.org/en-US/firefox/addon/bartab/
To help test services :
- soapui
- wget --post-data='a=b' url
Once done, the PATH env var should look like :
- on windows : %SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;C:\dev\easysoa\node-0.4.7-i686-pc-cygwin\bin;C:\Program Files\Java\jdk1.6.0_14\bin;C:\dev\easysoa\apache-maven-2.2.1\bin