duheng1992 / alice3

The Alice 3 block-based IDE desktop application. Also contains a NetBeans plugin to extend development into java.

Alice 3

Alice is an innovative block-based programming environment that makes it easy to create animations, build interactive narratives, or program simple games in 3D.

Latest Released Build:

Building Alice 3 from the source

Download and install the following build tools

• J2SE 1.8 JDK
  • Set $JAVA_HOME accordingly, and add $JAVA_HOME/bin to your PATH
  • Using more recent versions of Java 8 may cause problems for jogl when building. Alice is currently tested and built using Oracle's JDK 1.8.0_152.
• Apache Maven (3.6.3 is used on the build system)
• git
• git-lfs
• Install4J 7 (Only required to build the installers)

---

Clone the Alice 3 repository into a local directory, ${alice3}

cd ${alice3}
git clone --recurse-submodules https://github.com/TheAliceProject/alice3.git

Alice 3 uses a submodule for the Tweedle language, the internal representation of Alice code. If you do not use the --recurse-submodules flag above it can be pulled in explicitly.

git submodule init
git submodule update

To ensure the lfs files are available locally:

git lfs pull 

Compile and jar the Alice code.

mvn compile

or, to also build the NetBeans plugin:

mvn -Dinstall4j.skip install

And, if you want to use Install4J to build the installers:

    mvn install

Executing, testing, and building

After successfully compiling, you can launch the Alice IDE

cd alice-ide
mvn exec:java -Dentry-point

Run unit tests

cd ${alice3}
mvn test

Build the Alice installers, which requires Install4J 7:

cd ${alice3}
mvn install

IDE

IntelliJ IDEA is suggested for coding/building Alice 3. There is a free community edition or JetBrains offers a product pack for students using an edu email address here.

Build with IntelliJ

Although IntelliJ IDEA installs Openjdk-14.0.1 Alice 3 builds with Java 8 which will need to be installed and selected.

IntelliJ IDEA has a bundled maven.

• The location is set in:
  • File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven
• To build with maven using build project in the IDE first check the "Delegate IDE build/run actions to Maven" option in
  • File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven -> Runner

Run with IntelliJ

After the project is built successfully. You can create a Run/Debug Configuration and run the project. In the Run/Debug Configurations window, create a new Application configuration and enter lines as bellow. The working directory should be the root directory where you checked the Alice 3 project out, ${alice3}.

The VM options are:

-ea
-splash:"./core/resources/target/distribution/application/SplashScreen.png"
-Xmx1024m
-Dswing.aatext=true
-Dorg.alice.ide.rootDirectory="./core/resources/target/distribution"
-Dcom.apple.mrj.application.apple.menu.about.name=Alice3
-Dedu.cmu.cs.dennisc.java.util.logging.Logger.Level=WARNING
-Dorg.alice.ide.internalTesting=true
-Dorg.lgna.croquet.Element.isIdCheckDesired=true
-Djogamp.gluegen.UseTempJarCache=false
-Dorg.alice.stageide.isCrashDetectionDesired=false
-Dsun.java2d.cmm=sun.java2d.cmm.kcms.KcmsServiceProvider

Then the project should be ready to run.

Final note: If you were delegating IDE build/run actions to Maven in the previous step, please uncheck that option. Or you might run into some graphics errors running Alice.

Working without the Sims*

The compile, package, and install phases can all be limited to not include the Sims assets. To do that disable the includeSims maven profile.

It is a good idea to clean if you have previously made a full build. This may prevent leftover Sims artifacts getting bundled in.

cd ${alice3}
mvn -DincludeSims=false -Dinstall4j.skip clean package

Or:

cd ${alice3}
mvn -DincludeSims=false clean install

*This is still experimental, so there may be errors.

How to contribute

We appreciate contributions from the Alice community.

To make it easier to merge in new work, when submitting PRs please:

• Keep each one small and focused
• Make individual commits of smaller chunks with clear descriptions
• Follow the established coding style

Development tools

This repository previously included a number of projects that were experiments, test beds, and development aids.

They have been relocated to the Alice 3 Tools repo. (NB If you are looking for historic versions of any of those projects, the richer git history is in this repo. The history did not migrate due to the way filter-branch was applied.)