Differences

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

--- at:download [2007/03/15 16:27] – * tvcutsem
+++ at:download [2020/02/10 13:59] (current) – elisag
@@ Line 1: / Line 1: @@
 ~~NOTOC~~
 ====== Downloading/Installing AmbientTalk ======
 ===== AmbientTalk/2 =====
@@ Line 8: / Line 9: @@
 AmbientTalk/2 has been designed to co-exist with available Java programs. It offers a symbiotic interface to the Java language, making it possible to instantiate and use Java objects from within AmbientTalk, and to pass AmbientTalk objects that implement a Java interface to the Java level. This makes AmbientTalk an ideal language to write 'distributed glue code' to make isolated Java programs talk to one another.
-== Download ==
+To get started with AmbientTalk programming, we recommend installing our Intellij IDEA plugin (see IDE support).
-Download the [[http://prog.vub.ac.be/amop/downloads/at2-build150307.zip|latest build]].
+<box 80% round blue><html><center style="clear:both;"><img src="http://soft.vub.ac.be/amop/_media/at/intellij_idea.png" style="vertical-align:middle" height="50px"/><font size="+1"><a href=""https://plugins.jetbrains.com/plugin/8884-ambienttalk-ide">Install Intellij IDEA Plugin
+</a></font> </html></box>
+==== Download the AmbientTalk Distribution ====
+If you are interested in downloading a stand-alone version of the AmbientTalk/2 interpreter and run it via command line:
+<box 80% round blue><html><center style="clear:both;"><font size="+1"><a href="https://drive.google.com/drive/folders/0B07Ew8FJun94MVJrTHlBWlJfeFE">Download AmbientTalk 2.23
+</a></font> </html></box>
+See the [[https://gitlab.soft.vub.ac.be/ambienttalk/ambienttalk/wikis/Change-Log|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 ==
-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.
+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.
 For an overview of the iat shell options, execute:
 <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>
+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.
-== TextMate Plugin ==
+<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>
-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.
+<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 TextMate plugin supports:
+<note warning>
-  * Source code colouring
+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.
-  * Autocompletion for statements such as 'if', 'def' etc. (by pressing TAB)
+</note>
-  * 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.
+== Requirements ==
-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.
+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 version 1.6 or higher, and on J2ME under a CDC/Personal Profile configuration.
-== Documentation ==
+<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>
-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.
+[[at:amophtc|Additional instructions]] on how to run AmbientTalk on J2ME.
-===== AmbientTalk/1 =====
-{{: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 =====
-AmbientTalk consists of two JAR files.
-{{:at:ambienttalk.jar|Core}} Contains the core of the AmbientTalk evaluator, which interprets the AmbientTalk language.
-{{:at:ambienttalkdt.jar|Desktop Frontend}} Contains the J2SE Swing interface for running AmbientTalk on a desktop machine.
+==== IDE Support ====
-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 =====
+We recommend using our Intellij IDEA plugin which already contains the AmbientTalk/2 interpreter and the AmbientTalk standard library (atlib).
-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.
-AmbientTalk for PDAs and SmartPhones also 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/intellij_idea.png" style="vertical-align:middle" height="90px"/><font size="+1"><a style="margin-left: 1em" href="https://plugins.jetbrains.com/plugin/8884-ambienttalk-ide">Install Intellij Plugin</a></font></center></html></box>
+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.
+The TextMate plugin supports:
+  * Source code colouring
+  * 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)
+<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>
+<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.
-{{: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)
+==== 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"