If you are reading this, we'd like to thank you for your interest Aptana Studio. Please read through this guide carefully.
For Aptana Studio 2 Upgraders
Aptana Studio 3 is intended to be completely independent from Aptana Studio 2. You can install both Studio 2 and Studio 3 separately and run them both on the same machine, since they will use different workspace directories. If you wish to import your Studio 2 projects into Studio 3, you can follow instructions here.
Before you install the Release, you should have the following tools installed and working correctly:
- Sun/Oracle Java 1.5.x or later on Mac and Linux. OpenJDK is not yet supported. The Windows installer includes a compatible version of Java.
- Git is required because it is used internally to update your scripting environment. On Windows, we recommend PortableGit from msysgit because we also require its bash shell for executing commands. If you don't have msysgit installed, Studio 3 will offer to install it for its own internal use.
- If you are installing Studio 3 as an Eclipse plugin, you must use Eclipse 3.5 or better.
If you intend to do Ruby on Rails development, you will also need to set up your Ruby and Rails development environment:
Ruby 1.8.7+ and/or 1.9.1+ (on Windows, we recommend
along with its optional DevKit addon). You can use other ruby runtimes (e.g. jruby)
if you like, but we expect to find
gemtools on your path by name. Plus we haven't tested debugging with other interpreters yet, so debugging may not work if you use an alternate runtime.
- Rails (2.x and/or 3.0)
- The gem that supports the database(s) of your choice.
For debugging, you will need to have the
You should also make sure that your login PATH is set up correctly
such that you can execute the
git commands correctly. Setting these things up in your
.bashrc (or equivalent) isn't sufficient, because it doesn't get evaluated
by default when GUI applications like Aptana Studio 3 get launched.
Ruby switching utilities like rvm should also work, provided that you set them up in your login PATH as well.
If getting your login PATH set up in this way isn't practical for you,
you can work around the problem by launching Aptana Studio 3
from the command line, using the
studio3 command line utility.
This utility can be found at the top level of the Aptana Studio 3 installation
folder, so you can put that folder in your PATH for convenience. (The command line
utility can also be called after Aptana Studio 3 is running, to get it to open
source code files for editing.)
Update Your Installation Regularly
The IDE is configured to check for updates from our update site, and we plan on releasing new versions on a regular schedule.
Getting Started With Studio 3
Check the help system for links on geting started and how to use various features.