Sculptor Installation Guide
This instruction describes what you need to install and configure to be able to use Sculptor as normal developer, e.g. for getting started with the Hello World Tutorial.
Table of Contents:
JDK
Install JDK 6 or JDK 5.
Maven
Maven is used for generating source code and building the system.
1. Install Maven2. Use Maven 2.0.8 or later.
2. Define JAVA_HOME environment variable.
 | I often put JAVA_HOME and MAVEN_OPTS directly in mvn.bat. I increase the heap size for better performance and avoiding out of memory.
Windows:
set JAVA_HOME=c:\devtools\jdk1.6.0_03
set MAVEN_OPTS=-Xms128m -Xmx1024m
Mac OS X:
JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
MAVEN_OPTS="-Dfile.encoding=iso-8859-1 -Xms128m -Xmx1024m"
|
Eclipse and Plugins
Sculptor can be used with a text editor or any IDE, but if you are an Eclipse user it is recommended that you install the following Eclipse plugins to be able to use DSL editor with error highlight, code completion, and outline.
Sculptor 1.8.0 DSL editor has been tested with Eclipse 3.5 Galileo and MWE/Xpand/Xtext 0.7.2. If you must use Eclipse 3.4 Ganymede you can use Sculptor version 1.7.0 plugins as described in the old installation guide.
1. Install Eclipse 3.5 Galileo, Eclipse IDE for Java EE Developers.
2. Install from Galileo update site - http://download.eclipse.org/releases/galileo
- Modeling > MWE SDK 0.7.2
- Modeling > Xpand SDK 0.7.2
- Modeling > Xtext SDK 0.7.2
3. Install from Itemis update site - http://download.itemis.com/updates/releases
- Xtext Antlr Support 0.7.2
4. Sculptor Plugins
Final release for Sculptor version 1.8.0 is available at update Site: http://fornax-platform.org/updatesite/.
Install Sculptor DSL Feature 1.8.0.
If you are going to develop rich clients you should also install Sculptor Rich Client Feature 1.8.0.
Configuration in Eclipse
Add 'Classpath Variable' in Eclipse for M2_REPO=<your local repository location>
You find this setting in Window -> Preferences -> Java -> Build Path -> Classpath Variables
The local repository location is by default in .m2/repository in your home directory (Document and Settings in Windows)
Add 'String Substitution Variable' in Eclipse for MAVEN_EXEC=<MAVEN_HOME>/bin/mvn.bat
| If you are using Mac OS X you should change the default file encoding in Eclipse to ISO-8859-1. Preferences -> General -> Workspace |
Maven Launcher
Maven can be executed from the command prompt, but when developing a better alternative is to run it inside Eclipse as an external tool. You can checkout some preconfigured launchers from Fornax Subversion repository. The menu items for this are available in the external tools menu.
Checkout https://fornax.svn.sourceforge.net/svnroot/fornax/trunk/maven-launcher/
Use the subversive plugin, open view SVN Repositories. Connect to the Subversion repository root: https://fornax.svn.sourceforge.net/svnroot/fornax/
| If you don't see the list of fornax maven commands under the 'External tools' menu in Eclipse, try closing the 'Maven Launcher' project and open it again. |
m2eclipse
If you like you can use the m2eclipse plugin instead of the combination of the eclipse:eclipse plugin and Maven Launcher.
There are two things to have in mind.
1. For the plugin to know about all different sources folders you need to configure it to run the goal generate-sources at import moment. This is done in the Maven configuration at workspace level:
2. When running web projects (like the library-web example), you need to set Maven configuration (at project level) to NOT resolve dependencies from workspace projects:
Continue
Now you are ready to continue with the 2. Hello World Tutorial (CSC).
Posted by Anonymous at 
If you want users to install oAW 4.2 you need to specify the update site http://www.openarchitectureware.org/updatesite/milestone/4.2.0/site.xml instead.