L'installation d'Aptana IDE est très simple, tout comme les mises à jour pour Ruby on Rails et l'accès à un dépot de code (via subversion avec Subclipse). J'utilise Gentoo comme distribution, mais la procédure reste semblablement la même pour d'autres distributions ou système d'exploitation. L'installation s'effectue manuelle (pas de emerge).

Prérequis

Java

Vérifier qu'une version de java 1.5 est installée et que c'est celle-ci est utilisé par votre usager. 

plec@laptop ~ $ eselect java-vm list
Available Java Virtual Machines:
  [1]   blackdown-jre-1.4.2  system-vm
  [2]   sun-jdk-1.5  user-vm

Flag java

Pour le support de Subclipse dans Aptana IDE, le "flag" java doit être présent pour que la librairie javaHL soit complilée en même temps que Subversion.

Voici une façon simple de vérifier : 

# equery u dev-util/subversion | grep "java"
+java

Installation

Télécharger Aptana IDE avec Rails 

cd /opt
wget http://www.web20.com/downloads/current/Linux/Aptana_IDE_Setup_Linux.zip
unzip Aptana_IDE_Setup_Linux.zip

J'ai ajouté Aptana IDE dans /opt et changé les permissions pour que mon usager puisse écrire dans /opt/aptana lors de mise à jour. J'aurais aussi pu installer l'application dans mon répertoire personnel (home), mais je suis le seul à utiliser cet ordinateur. Il est aussi possible d'installer les mises à jour dans dans son répertoire personnel, mais je n'ai pas essayé cette possibilité.

Menu

Ajouter Aptana IDE au menu pour un lancement rapide et en même temps ajouté le PATH pour la librairie de javaHT.

Pour tester si javaHT est correctement trouvé par l'application, il suffit d'aller dans les préférences (Windows -> Preferences -> Team -> SVN. Le message d'erreur JavaHL interface is not available.

Mettre Work path au même path que le binaire de l'application. Pour mon installation c'est le path /opt/aptana.

Ou un "pop-up" : Failed to Load JavaHT Library

Sans l'ajout du export LD_LIBRARY_PATH=/usr/lib ces messages d'erreurs apparaitront.

Premier démarage

Démarrer l'application et choisir votre "workplace". Dans mon cas, ça va être /home/plec/workspace.

Mise à jour

Aller dans le menu Help, ensuite dans Software Updates -> Find and install.... Sélectionner Search for new features to install. Cocher Ruby on Rails Development Environment et Subclipse (pour subverion). Poursuivre l'installation jusqu'à la fin.

Note: Ne pas installer Mylar avec Subclipse, cocher uniquement Subclipse dans les fonctionnalités à installer.

Rails

Pour changer la perspective d'Aptana IDE (et travailler sur un projet en Rails), aller dans le menu Windows, Aller dans Open Perspective et choisir Other.... Sélectionner Rails.

Format de codage de caractères

En écrivant des commentaires en français et comprenant des accents, je suis rapidement tombé sur un problème d'encodage :

Lors de la sauvegarde de mon fichier source. Le message débutait par "Save could not be completed" et de ANSI_X3.4.-1968 character encoding.

En fouillant dans les préférences d'Aptana (Preferences -> General -> Workspace) j'ai changé le format d'encodage pour UTF-8 dans Text file encoding(Default encoding : ANSI_ANSI_X3.4.-1968). Le problème était réglé et la sauvegarde s'est déroulée normalement.

Il est aussi possible de régler le problème en définissant un format d'encodage pour le type de fichier source (Preferences -> General -> Content Types -> Text -> Properties -> Ruby Source File) => UTF-8.

Autres informations

En cas de problème avec l'applications, le fichier de logs est ~/workplace/.metadata/.log. Si des messages d'erreurs s'affichent, c'est un bon début pour trouver d'où vient le problème.

Options intéressantes

Désactiver le chargement de la page web d'Aptana

Preferences > Aptana > Start Page : X Never display after startup.

Refresh automatically

Pour éviter les messages de fichiers modifiés en dehors d'Aptana IDE (Resource is out of sync with the file system) : Preferences > General > Workspace > "Refresh automatically". En plus, ça raffraichit automatiquement les répertoires et fichiers dans le navigateur qui sont ajoutés sans passer par Aptana IDE.

Références