Com desenvolupar una aplicació rails amb eclipse
De Wiki d'Animelliure
En aquest manual es mostrarà com crear-nos un entorn de treball amb eclipse per desenvolupar una aplicació web amb el framework de ruby on rails i amb suport de subversion (SVN).
Contingut |
Instal·lar eclipse
Instal·lar eclipse és molt fàcil. Només hem d'anar a la seva plana web, a descàrregues i triar la versió 'Eclipse Classic'. Un cop tinguem el tar.gz (és un zip bàsicament, a windows segurament haurem d'obri-lo dues vegades, una per extreure el gz, zip, i l'altre per desenpaquetar-lo, el tar.) el descomprimim on vulguem.
Al obrir-lo ens demanarà que establim una carpeta de treball, on hi tindrem les aplicacions que vulguem crear.
Instal·lar aptana i Radrails
Aptana i Radrails afegiran a eclipse la capacitat de treballar amb aplicacions rails. Per descarregar-los obrim l'eclipse i cliquem sobre el menú help. Allí triem la opció Software Updates i llavors del seu submenú Find and Install.
Ara ens sortirà una finestra on marcarem la opció Search for new features to install i li donarem a Next. Aptana no es troba als repositoris oficials, així que n'haurem d'afegir l'ubicació a mà clicant al botó New Remote Site. Allí com a Name posem Aptana i com a URL posem http://update.aptana.com/update/3.2/. Una imatge per ilustrar-ho.
Lo donem al botó ok. Veurem que l'element aptana que hem afegit a la llista està marcat, el checkbox, si no ho està el marquem, i premem el botó Finish.
Ens sortirà una nova pantalla, on veurem l'element Aptana, on el seu checkbox no està marcat. El marquem i premem el botó Next. N'hem acceptar la llicència per a continuar i llavors li donem al botó Finish de la nova finestra on se'ns informa de que s'instal·larà.
El procés d'instal·lació trigarà una estona, paciència, i quan acabi ens demanarà que reiniciem eclipse, ho fem.
Una vegada hem reiniciat, anem al menú Help i triem la opció Aptana Studio Start Page. Si no ens apareix res, tacarem la pestanya Welcome.Veurem la seva web, i anirem a la part inferior de la columna central on posarà Ruby on Rails i premerem sobre el enllaç install.
Ens apareixerà una finestra anomenada updates, amb una opció Aptana RaidRails, en desplegarem les opcions prement sobre la fletxa a la part esquerra i marcarem Rails.
Com anteriorment, premerem el botó Next i acceptarem la llicència, tornarem a prémer el botó Next dues vegades i finalment el botó Finish.
Aquesta instal·lació serà un xic més ràpida que l'anterior, i tornarem a reiniciar l'eclipse.
Al reiniciar veurem que es queixa de que no disposa d'una instal·lació de ruby, es descriurà en el següent pas.
Instal·lar ruby,rails i mongrel
Windows
Linux
Per a linux podem emprar dos mètodes, seguir la guia d'instal·lació de windows o emprar les versions que hi ha al repositori de la nostra distribució. En el meu cas concret l'executable es troba a /usr/bin.
Li donem a Ok, un cop triat i ens assegurem de que estigui triat 'Standard VM' en comptes de JRuby VM.
Ara anem dintre del mateix menú a la opció Rails, a l'esquerra, i anem al submenú Configuration. Allí hem d'establir les rutes per rails, rake i mongrel_rails (mongrel_rails és opcional però recomanable). Si no els tenim fem com abans, els instal·lem amb el gestor de paquets de la nostra distribució.
En el meu cas concret tant rails com rake com mongrel_rails es troben dintre del directori /usr/bin, com passava amb ruby.
Premem el botó Ok.
Instal·lar subclipse
Aquest plugin d'eclipse ens permetrà treballar amb repositoris SVN (subversion).
Per instal·lar-lo anem al menú Help d'eclipse i triem la opció Software Updates d'on en triem el submenú Find and Install. Ens assegurem que estigui marcat Search for new features to install i li donem al botó Next. En el següent menú premem el botó New Remote Site, on com a nom li donem Subclipse (SVN) i com a adreça http://subclipse.tigris.org/update_1.2.x.
Ens assegurem que la nova entrada sigui la única marcada i premem el botó Finish. Ens apareixerà una nova finestra. Allí desplegarem les opcions prement a la fletxa de l'esquerra de Subclipse (SVN) i marcarem el checkbox de Subclipse Plugin.
Ara premerem el botó Next, n'acceptarem la llicència i tornarem a prèmer Next. Finalment premerem el botó Finish. La instal·lació trigarà una estona i finalment ens demanarà reiniciar eclipse. Ho fem.
Possibles problemes sota linux
Subclipse empra JavaHL, que per desgràcia no ve compilat per defecte en diverses distribucions. La única solució és recompilar subversion per a que ho suporti.
Gentoo
Gentoo sí que porta per defecte JavaHL, però no n'especifica la variable LD_LIBRARY_PATH. Hi ha dues alternatives en aquest cas.
La primera és anar a la carpeta /etc/env.d/ i crear 00eclipse. On definirem la variable LD_LIBRARY_PATH escrivint-hi aquesta línia:
LD_LIBRARY_PATH= "/usr/local/lib:."
La segona opció és crear un arxiu, per exemple, e.sh, i fer-lo executable ( chmod +x e.sh a la consola). Llavors hi escriure el següent:
export LD_LIBRARY_PATH=/usr/local/lib:. ./eclipse
Crear un projecte
Si volem començar de zero un projecte anirem al menú File, triarem la opció New i en el submenú triarem Rails Project. Al crear-lo podrem especificar si volem que funcioni amb WEBrick o mongrel. Si disposem de mongrel triem mongrel, en cas contrari WEBrick.
Importar un projecte
Una vegada tenim totes les eines, només ens queda importar el projecte en el que volem treballar. En cas de no estar treballant en cap projecte iniciat, mirar com Crear un projecte, en aquesta mateix manual.
Per importar un projecte anirem al menú File i triarem la opció import. Per importar un projecte subversion (SVN), desplegarem les opcions de Other clicant a la seva fletxa a l'esquerra. Allí marcarem la opció Checkout Projects for SVN i li premerem el botó Next. Al nou menú triarem la opció Create a new repositori location i premerem el botó Next.
A la nova finestra hem d'especificar l'adreça del nostre repositori SVN i al premer el botó Next ens demanarà una autentificació, si és necessària, i començarà a descarregar el projecte. Encara que hi hagi el botó Finish, l'aplicació no en farà cap cas fins que no hagi acabat de descarregar el projecte, així que paciència.
