This is a version of the ACT-R Environment built using AndroWish for use on 
Android devices running Android 2.3.3 or newer.  This is only the ACT-R 
Environment -- it is not a complete standalone version of ACT-R.  It must 
be connected to a Lisp running ACT-R to be of any use.  

Installing

To install the ACT-R environment app, download the application package from:
<http://act-r.psy.cmu.edu/actr6/ACT-R_Environment-debug.apk> 
and then install it using the package installer on the device.

You will need to enable installation of non-Market applications if it is not
already enabled.  That can be set under the Settings:Applications:Unknown sources
option, or a similar setting depending on the specific version/device.

Running

When you run the app it will first ask if you would like it to display
the IP address of the device.  You will need to know the device's IP address
to connect ACT-R to the Environment.  If you do not know the IP address of
the device, pressing "yes" will cause the app to connect to root-servers.net
and attempt to determine the IP address of the device.  If you know the
IP address of the device you can press "no" to continue without connecting
to root-servers.net.

After pressing "yes" or "no" on the initial dialog the Environment app will
open the ACT-R Control Panel window just as it does when running the 
Environment on any other device and wait for a connection from ACT-R.

Connecting to ACT-R

To connect ACT-R to the Environment you will need to call the connect-to-
environment command from Lisp specifying the IP address of the device
running the Environment as the :host keyword parameter.  Here is an example
where the android device has an IP address of 192.168.1.1:

(connect-to-environment :host "192.168.1.1")

That should result in the buttons being displayed in the Control Panel.
Once the buttons are available the Environment is useable, but if there was 
a model already defined in ACT-R it may need to be reset for some of the tools 
to function correctly.

Stopping

To quit the app you must close the Control Panel window.  You may put the app 
back into the "waiting for ACT-R" state by calling stop-environment from Lisp.
If you close the app without first stopping it you may receive a warning message
in Lisp about the connection being closed or unreadable, and you can safely
ignore that message.

Notes

For more information on the ACT-R Environment tools please see the Environment's
manual found in the docs directory of the ACT-R software or online on the ACT-R
software page: <http://act-r.psy.cmu.edu/software/>.

Because there can be a lot of data passed back and forth between ACT-R and the 
Environment it is best to use this with a WiFi connection, especially if one has 
to pay for data otherwise.

The current version of the ACT-R Environment for Android does not save any
information when it quits nor can it save the option settings.  Thus the window
positions will not be saved between uses and pressing the "Save" button in
the options dialog will bring up an error message.  If you encounter that
error you will need to hit "Ok" or "Skip Messages" to continue.  

Right now, this is a direct port of the current ACT-R Envrionment tools as a 
test to see how well it works and to see if there is any interest in further 
development of such a tool.  It may be difficult to use on a small touch
screen interface, particularly when it comes to hitting the close window
buttons.

If you have any comments, questions, or suggestions about the Android version 
of the Environment please let me know at: db30@andrew.cmu.edu.