StrataCode Getting Started

It requires: Java 8 or 11, Git, Unix (linux and mac - windows testing in progress), a machine with 4GB of memory and a fast processor for code-processing and compilation.

IntelliJ plugin

To use StrataCode from IntelliJ, download a recent version of IntelliJ (either Community or Ultimate) and install the IntelliJ plugin - a full featured IDE for StrataCode to build and run applications.

Command line - scc

To download the command line interface and libraries, download scc.zip here. Unzip this file to create the /home/scc directory:

  cd /home
  unzip ~/Downloads/scc.zip

Run or add to ~/.bashrc:

  export PATH=$PATH:/home/scc/bin

Test:

  scc -version

Create a StrataCode project, and then run scc from the project directory with a list of layers.

Create a StrataCode project

A StrataCode project contains one or more bundles of layers in the bundles directory:

  mkdir /home/myProj
  cd /home/myProj
  mkdir bundles
  cd bundles
  git clone https://github.com/stratacode/coreFramework.git

Add additional layer bundles as well (inside of the 'bundles' directory):

  git clone https://github.com/stratacode/example.git
  git clone https://github.com/stratacode/siteBuilder.git
  git clone https://github.com/stratacode/programEditor.git

Java to Javascript converter

See this quickstart

Installing scc source

The code behind 'scc' is not open source but would make a great open source project if there's enough demand. It's a lot more fun to build when you have the source and we're looking for new partners to help so get in touch if you'd like to see more. With the source, run:

  mkdir ~/scc
  cd ~/scc
  git clone https://github.com/stratacode/system.git .
  (or unzip the scc-src.zip)

Configure project to point to scc source

When using StrataCode with it's source code, it's best for the project build to use this source for the scc libraries, rather than than the copy bundled with the scc command.

Add this configuration file so that the 'scc' command can find it's own source code:

cd /home/myProj
mkdir conf
cat > conf/scSourcePath
/home/scc

Running StrataCode examples

From your /home/myProj directory run:

Swing management UI and the expert system:

scc editor.swing.main example.expertSystem.main

See example layers for more examples.

Problems?

If you have problems after code changes, use the '-a' option to build all files or remove the layer's build directory in /home/myProj/build or the modelCache in ~/.stratacode/modelCache.

The modelCache is a recent optimization to speed up parsing of a file and the IDE but still sometimes gets corrupted which can cause weird errors that are easily corrected by removing that directory.

Third party packages for most layers are installed by default in ~/.stratacode/pkgs when the layer is started the first time (either at build time, or when the IDE indexes the layer).

There's a usage for the scc command or type "help" at the command line.

See the documentation or current project status

known issues or report a bug please for any problems big or small. Email Jeff (jeff@jvroom.com). Your feedback is much appreciated.