How to create an AmbientTalk distribution
Creating an AmbientTalk distribution
The easiest way to build an AmbientTalk distribution is using the Ant build tool:
- Perform a checkout of the atbuild repository. The parent directory in which you check out this directory should have subdirectories
iat. We will refer to this parent directory as the base directory.
- Make sure the
ant_contrib.jarfile is either in the same directory as
build.xmlor copy it to
- Make sure all
.javafiles in the base directory's subdirectories are compiled and that the corresponding
.classfiles are located in a
/binsubdirectory (if your project is compiled by Eclipse, this is the default).
- run the command
antin the directory containing
build.xml. If the build was successful, a directory with the name
at2distDDMMYYshould have been created.
- to remove generated files and the distribution, run
If you don't want to checkout the
atbuild directory in the base directory or its subdirectories have names other than the defaults (for example if you checked out these directories separately under different names, e.g. as Eclipse projects), edit the
build.xml file and check the section marked as platform-dependent. Check whether the platform-dependent directories and names correspond to those of your system.
You can get an overview of the different "targets" supported by the ant build file by executing in a shell:
Using the build file, you can create an
ambienttalk2.jar file, provided that you (or Eclipse) have previously compiled all the necessary .java files into .class files already. You can create a distribution by executing
You can also create the Javadoc documentation for the language reference by executing
ant doc. However, this requires that you have checked out the
atdoclet project from the SVN repository, and that you have a 1.4.2-compatible
javadoc executable installed.
Releasing a new distribution
*This is only required for internal use, external users can ignore this. *
Here is a checklist that needs to be followed when creating a new distribution of AmbientTalk:
- update AmbientTalk's version number in the IAT Shell project's
- create a new build:
- test whether the source code you're about to release works properly outside of your Eclipse platform. That is, start up the to-be-released
iatand execute the distribution tests as follows:
- upload the newly created and zipped distribution to the Downloads google drive folder (https://drive.google.com/drive/folders/0B07Ew8FJun94MVJrTHlBWlJfeFE).
- update the AmOP wiki download page.
- Change Log
- create the documentation:
- upload the documentation to the SOFT server (soft.vub.ac.be:/var/www/html/amop/at2langref).
- update the tutorial if necessary.
- inform the mailing list of the new build.
- tag the build in the SVN repository. This can be done by means of the
tag.shshell script provided in the build zip.
- assign a new version number to iat (via the .props file again), and commit the new .props file to the repository.