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:
Sculptor is implemented in Java. So we need a Java development environment:
Install a JDK (from Java 6 up to Java 8)
Currently only Java up to version 8 is supported!
Define environment variable
JAVA_HOMEwith path to JDK installation folder
Mac OS X:
JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_51.jdk/Contents/Home export JAVA_HOME
Check from the command line that Java is configured properly, e.g.
$ java -version java version "1.7.0_51" Java(TM) SE Runtime Environment (build 1.7.0_51-b13) Java HotSpot(TM) 64-Bit Server VM (build 24.51-b03, mixed mode)
- Install Maven (Version 3.1.1 or newer)
- Define environment variable
M2_HOMEwith path to Maven installation folder
Define environment variable
MAVEN_OPTSwith JVM arguments, e.g. for increase the heap size for better performance and avoiding out of memory
To prevent OutOfMemoryError when using Sculptors code generator it’s neccesary to increase the Oracle JVMs heap and permanent generation via
set M2_HOME=C:\devtools\apache-maven-3.2.1\ set MAVEN_OPTS=-Xms128m -Xmx1024m -XX:MaxPermSize=128m
M2_HOME=C:\devtools\apache-maven-3.2.1\ MAVEN_OPTS="-Xms128m -Xmx1024m -XX:MaxPermSize=128m" export M2_HOME MAVEN_OPTS
Check from the command line that Maven is configured properly, e.g.
$ mvn -v Apache Maven 3.2.1 (ea8b2b07643dbb1b84b6d16e1f08391b666bc1e9; 2014-02-14T18:37:52+01:00) Maven home: /Users/torsten/Develop/apache-maven-3.2.1 Java version: 1.7.0_51, vendor: Oracle Corporation Java home: /Library/Java/JavaVirtualMachines/jdk1.7.0_51.jdk/Contents/Home/jre Default locale: en_US, platform encoding: UTF-8 OS name: "mac os x", version: "10.9.3", arch: "x86_64", family: "mac"
Sculptor generates several UML diagrams for the domain model. Theses diagrams are defined as textual GraphViz
generate-images of Sculptors Maven plugin generates images (.png) from these
.dot files. This plugin is included in the
created by the Sculptor Maven archetypes, but you need to install GraphViz and have the
dot executable in path.
If the GraphViz Maven
dot executable is not available in path then the Maven build aborts with the error message
Executing 'dot' command failed.
Sculptor can be used with any text editor or IDE. But if you are an Eclipse user it is recommended that you install Eclipse with the following plugins to be able to use Sculptors DSL editor with error highlight, code completion, and outline.
Install Eclipse (Juno or newer), Eclipse IDE for Java EE Developers
To prevent OutOfMemoryError when using the Sculptor editor you can add
eclipse.ini, which is located in the Eclipse installation directory.
Directly in Eclipse (Help -> Install New Software) install from the Eclipse releases update site the following plugins:
- General Purpose Tools > m2e - Maven Integration for Eclipse 1.4.0 (or newer)
Modeling > Xtext SDK 2.5.0 (or newer)
Xtext version 2.5.0 (or newer) is required because Sculptors DSL text editor leverages public API introduced with this version!
Sculptor Eclipse Plugins
Sculptors Eclipse plugins are available from the update site http://sculptorgenerator.org/updates/.
Install “Sculptor DSL Editor”.
In Eclipse the following configuration settings are required:
- To support Xtend template expressions (which are using the “guillemets” characters
»for tag brackets) the default file encoding in Eclipse should be set to
ISO-8859-1via “Preferences > General > Workspace”
- To use Sculptors Maven archetypes from within m2e Eclipse plugins New Maven Project wizard the Archetype catalog from Maven Central
http://repo1.maven.org/maven2/archetype-catalog.xmlhas to be added to the list of archetype catalogs in m2e with Eclipse preferences (Maven > Archetypes > Add Remote Catalog)
- Refresh in Eclipse is often time consuming. In the m2e Eclipse plugin Maven launch configurations (created via context menu “Run As > Maven build…” on the corresponding Maven project or Maven POM) you should enable the option “Refresh > Refresh resources upon completion > The project containing the selected resource”. Don’t use “The entire workspace”.
Eclipse projects and Maven build started from command line
After executing a Maven build from the command line the corresponding projects in Eclipse have to be refreshed manually! Thereafter you should not have any red crosses (problems) in Eclipse. Sometimes, validation errors in code generation files (.xtend) must be cleaned manually as well. This an be done with a “clean build” (using “Project > Clean…”) of the corresponding Eclipse project.