Differences

This shows you the differences between two versions of the page.

--- at:download [2007/03/15 16:19] – tvcutsem
+++ at:download [2013/02/06 16:29] – updated tvcutsem
@@ Line 10: / Line 10: @@
 == Download ==
-Download the [[http://prog.vub.ac.be/amop/downloads/at2-build150307.zip|latest build]].
+<box 80% round blue><html><center style="clear:both;"><font size="+1"><a href="http://ambienttalk.googlecode.com/files/at2dist060213.zip">Download AmbientTalk 2.22
+</a></font> </html></box>
+<box 80% round blue><html><center><font size="+1"><div><a  href="https://market.android.com/details?id=edu.vub.at.android.interpreter">Download AmbientTalk for
+<br /></div></a></font> <a href="https://market.android.com/details?id=edu.vub.at.android.interpreter"> <img src="http://soft.vub.ac.be/amop/_media/at/androidlogo.png" height="90px" style="vertical-align:middle" /></a></center></html></box>
+See the [[http://code.google.com/p/ambienttalk/wiki/ChangeLog|changelog]] for changes w.r.t. previous versions.
 This build contains:
-  * The AmbientTalk/2 Interpreter (400K)
+  * The AmbientTalk/2 Interpreter
-  * The IAT Interactive AmbientTalk Shell (40K)
+  * iat, the Interactive AmbientTalk Shell
-  * Additional libraries (JGroups, ANTLR, LOG4J) used by the interpreter (5.5MB)
+  * The AmbientTalk standard library
-  * The TextMate plugin (see below)
-== Installation and Usage ==
+== Requirements ==
-To run the interactive shell, it suffices to launch the included **iat** shell script. IAT is a simple read-eval-print loop: statements are typed at the command line, evaluated and the result is printed to standard output. Note that the log and error traces are piped to the console.
+The AmbientTalk/2 interpreter is written in pure Java and requires a regular J2SE Java Virtual Machine supporting version 1.5 or higher. AmbientTalk currently runs on Android 1.6 and on J2ME under a CDC/Personal Profile configuration.
-For an overview of the iat shell options, excute:
+[[at:amophtc|Additional instructions]] on how to run AmbientTalk on J2ME.
-<code>iat --help</code>
-<note>We advise you to add **iat** to the **$PATH** environment variable, such that **iat** can be invoked from any directory. </note>
+== Installation and Usage ==
-== TextMate Plugin ==
+To implement and run ambientTalk programs, we recommend using our Eclipse Plugin (see IDE support).
-Support for AmbientTalk is available in the form of a [[http://www.macromates.com|TextMate]] bundle for AmbientTalk/2, which is available in the latest build.
+To run the interactive shell, it suffices to launch the included ''iat'' shell script. IAT is a simple read-eval-print loop: statements are typed at the command line, evaluated and the result is printed to standard output. Note that the log and error traces are piped to the console.
-The TextMate plugin supports:
+For an overview of the iat shell options, execute:
-  * Source code colouring
+<code>iat --help</code>
-  * Autocompletion for statements such as 'if', 'def' etc. (by pressing TAB)
-  * Running AmbientTalk/2 scripts by pressing Apple+R (output is shown in a separate window)
-<html><font color="red">Please note:</font></html> upon installing the bundle, you need to set the **AT_HOME** variable in the TextMate Preferences window (under the Advanced tab pane) to point to the directory in which iat can be found.
+The system library shipped with the build can be found in the ''at/'' directory. It includes, among others, some demo applications and additional language constructs (most notably future-type asynchronous message sends). Also, the file ''at/init/init.at'' is loaded by default in each actor created at runtime to intialize that actor's global scope.
-For a full overview of the supported features, open the Bundles > Bundle Editor > Show Bundle Editor menu and select the AmbientTalk 2 bundle in the bundle editor. All available actions, together with their hotkey are listed there.
+<note tip>We advise you to add ''iat'' to the ''$PATH'' environment variable, such that ''iat'' can be invoked from any directory. Note also that ''iat'' assumes that the ''java'' executable is available on the ''$PATH''</note>
-== Documentation ==
+<note warning>
+**Note to windows users:** ''iat.bat'' has been reported not to work when the ''AT_HOME'' directory contains spaces, so consider placing your AmbientTalk distribution in a directory that does not contain spaces.
+</note>
-The [[http://prog.vub.ac.be/amop/at2doc|Javadoc of the Interpreter]] is also online. It provides documentation about the implementation of the interpreter. A design document describing the design of the interpreter will follow soon.
+<note warning>
+For service discovery, AmbientTalk makes use of IP multicasting. AmbientTalk broadcasts messages to IP 224.0.0.1 on port 4446. Make sure your firewall does not block this port.
+</note>
-===== AmbientTalk/1 =====
+== IDE Support ==
-{{:at:qtek_small.png|:at:qtek_small.png }} AmbientTalk is a contemporary distributed programming language. It is an ambient-oriented programming language, which means that it is particularly geared towards developing next-generation distributed software which has to run on mobile devices (such as cellular phones or PDAs) deployed on open, ad hoc wireless networks. At its core, AmbientTalk uses a prototype-based object model for building abstractions. Its distribution and concurrency facilities are heavily inspired by the actor model. Current implementations are available for the Java J2SE and J2ME (PocketPC) platforms.
-This page provides access to the latest version of AmbientTalk, and gives some instructions on how to deploy it on your desktop or PDA.
-===== AmbientTalk on a Desktop Computer =====
+We recommend using our Eclipse plugin (IdeAT) which already contains the ambientTalk/2 interpreter.
-AmbientTalk consists of two JAR files.
-{{:at:ambienttalk.jar|Core}} Contains the core of the AmbientTalk evaluator, which interprets the AmbientTalk language.
+<box 70% round orange><html><center><img src="http://soft.vub.ac.be/amop/_media/at/eclipse.png" style="vertical-align:middle" height="90px"/><font size="+1"><a style="margin-left: 1em" href="http://code.google.com/p/ambienttalk/wiki/EclipsePlugin">Install Eclipse Plugin</a></font></center></html></box>
-{{:at:ambienttalkdt.jar|Desktop Frontend}} Contains the J2SE Swing interface for running AmbientTalk on a desktop machine.
+For Mac OS X users that use TextMate, there exists a [[http://www.macromates.com|TextMate]] bundle for AmbientTalk/2, which is available for download below.
-Once both files are downloaded into a single directory on your machine you may simply run java -jar ambienttalkdt.jar (Or typically you may also double-click on this JAR file)
-===== AmbientTalk on a PDA or Smartphone =====
+The TextMate plugin supports:
-AmbientTalk is developed to run on a virtual machine that supports the J2ME CDC Personal Profile 1.0. For our experiments we have deployed AmbientTalk on top of IBM's J9 virtual machine, but the implementation of AmbientTalk does not require any of the libraries that are specific to this virtual machine.
+  * Source code colouring
-AmbientTalk for PDAs and SmartPhones also consists of two JAR files.
+  * Autocompletion for statements such as ''if'', ''def'' etc. (by pressing TAB)
+  * Running AmbientTalk/2 scripts by pressing Apple+R (output is shown in a separate window)
-{{:at:ambienttalk.jar|Core}} Contains the core of the AmbientTalk evaluator, which interprets the AmbientTalk language.
+<box 70% round orange><html><center><font size="+1"><a href="http://soft.vub.ac.be/amop/downloads/at2textmate.zip">Download TextMate Plugin</a></font></center></html></box>
-{{:at:ambienttalkppc.jar|PocketPC Frontend}} Contains the J2ME AWT interface for running AmbientTalk on a PDA. (Note that this version may be tested as well on a desktop machine, since no native GUI components are used)
+<html><font color="red">Please note:</font></html> upon installing the bundle, you need to set the ''AT_HOME'' variable in the TextMate Preferences window (under the Advanced tab pane) to point to the directory in which iat can be found.
+For a full overview of the supported features, open the Bundles > Bundle Editor > Show Bundle Editor menu and select the AmbientTalk 2 bundle in the bundle editor. All available actions, together with their hotkey are listed there.
+== Documentation ==
-Once both files are downloaded, transfer them to your device and launch the PocketPC frontend. Using the J9 virtual machine the following shortcut is needed :
+See the [[at:tutorial:tutorial|tutorial]] for an introduction to AmbientTalk/2. An overview of the available primitives and libraries is available in the [[at:reference:reference|language reference]].
-"\Program Files\J9\PPRO10\bin\j9w.exe" "-jcl:ppro10" "-cp" "\AmbientTalk\ambienttalkppc.jar" "edu.vub.picoo.process.AmbientTalk"