AsTeRICS based AT solution
This folder contains an AsTeRICS based solution using the APE (AsTeRICS Packaging Environment) template folder structure.
Please follow the instructions of this tutorial
Demos / Examples
to build all the dependencies and start the ARE.
You can also start the ARE using the ARE start-scripts in the
Subsequently you can see the simplified folder structure of an APE-based project, which contains an ant build file (
build.xml), a property-based configuration file (
custom/bin/ARE folder to store the solution-specific files (e.g. model files), a
build folder and a
package folder for native installer customization.
build |- merged |- deploy custom |- bin/ARE |- data |- images |- LICENSE |- models |- <custom model file>.acs |- ... |-profile |- web |- webapps |- startpage |- start.html |- <your webapps folder> |- index.html package |- linux |- windows |- macosx APE.properties build.xml
How to use the repository
First, please read the tutorial about the AsTeRICS Solution Template Repository.
Put all your custom files (model files, images, config files,...) to the custom/bin/ARE folder.
In case you have a web UI put the files (.html, images, .css, .js,...) to the document root (custom/bin/ARE/web) of the built-in webserver. The webserver also provides a websocket. Finally the ARE provides a REST API that can be used within a web application.
Before the project can be run it must be built (builds the AsTeRICS repository and copies/merges needed plugin jars and project files to the ```build/merged/bin/ARE`` folder). You can also directly run the ARE with the project's solution.
- Save custom files (models, images, config files,...) to the custom/bin/ARE folder or subfolders (e.g. web/...) or modify them
ant APE-copy & ant run-quick
- This should automatically open http://localhost:8081 in your standard browser.
- If you want to modify the running model, press 'F8' to open it in the WebACS, then modify and upload it. To save successful modifications permanently, save the model file to the
- Kill program and go to step 1
To create a native installer open a console and run
Other ant targets
To see all supported targets, call
Changing AsTeRICS snapshot (ARE) used
ARE.baseURI defines the location of the ARE used for the execution of the project.
APE automatically searches for an ARE at the following locations:
dependencies/AsTeRICS/bin/ARE(if Asterics is added as submodule)
../AsTeRICS/bin/ARE(if it's an APE projectdir withouth FABI and FLipMouse folder structure)
../../AsTeRICS/bin/ARE(if it's an AT solution folder structure)
C:/Program Files (x86)/AsTeRICS/ARE/(if there is an Asterics installation on windows)
You can also set ARE.baseURI manually, either in the file
APE.properties or within an ant call, e.g.
ant -DARE.baseURI=<path to ARE> run
ant -DARE.baseURI=D:/AsTeRICS/AsTeRICS/bin/ARE/ run
Dual license MIT or GPLv3 with CLASSPATH exception. Please read more in the license section of the wiki.