Com instal·lar Ruby al Windows pas a pas

Vols posar-te fil a l'agulla amb Ruby al teu PC amb Windows i encara no tens clar com començar? Tranquil, no és gens complicat si segueixes una guia clara que t'expliqui cada pas i eviti els problemes més habituals que solen sorgir. A més, si has llegit diversos tutorials i t'ha semblat que cadascú aborda el procés de forma diferent (o deixa coses importants sense aclarir), aquí en trobaràs una explicació exhaustiva i sense tecnicismes complicats, que uneix tota la informació rellevant disponible i te la presenta de forma fàcil, ordenada i actualitzada.

Desgranarem tot el que necessites saber per instal·lar Ruby a Windows, ja sigui per programar els teus propis scripts, per desenvolupar amb frameworks com Ruby on Rails, o simplement per aprendre el llenguatge des de zero. Pareu atenció perquè, a més, afegirem recomanacions útils per evitar errors freqüents i optimitzar el vostre entorn de desenvolupament des del principi.

Per què instal·lar Ruby a Windows i quines opcions hi ha?

Ruby és un llenguatge de programació versàtil i fàcil d'aprendre, ideal tant per als que fan els seus primers passos en la programació com per a professionals que busquen una eina potent i flexible. Tot i que és més habitual trobar-lo en sistemes Linux o macOS, cada cop són més els desenvolupadors que opten per Windows, sobretot amb eines com RubyInstaller que simplifiquen el procés.

Gràcies a RubyInstaller, instal·lar Ruby a Windows és més senzill que mai, ja que inclou tot el necessari per començar a treballar immediatament. Però, a més, hi ha altres mètodes per als que busquen administrar diverses versions de Ruby, o requereixen personalitzar la instal·lació per a projectes concrets, com els gestors de versions, la línia de ordres i la compilació manual del codi font.

Un dels avantatges més grans d'utilitzar RubyInstaller és que integra l'entorn MSYS2, el que facilita la instal·lació de gemmes natives i dependències, fent possible treballar en projectes complexos com Ruby on Rails sense complicacions addicionals.

Eines i requisits previs

Abans de posar-te a instal·lar Ruby, és recomanable comptar amb una sèrie d'eines bàsiques al teu equip:

• Vés: Molt útil per gestionar els teus projectes i descarregar codi font des de repositoris en línia com GitHub.
• Editor de text: Atom, VS Code o Sublim Text són bones opcions per editar codi Ruby.
• Node.js i Yarn: Necessaris si penseu treballar amb Ruby on Rails o amb eines modernes de l'ecosistema JavaScript.
• SQLite: Recomanat si començaràs projectes Rails, ja que sol ser el sistema de base de dades per defecte.

No us preocupeu si encara no teniu algun d'aquests elements, perquè a continuació repassarem com instal·lar-los i configurar-los de forma senzilla.

Pas 1: Instal·lant Git a Windows

Git és fonamental per a qualsevol desenvolupador modern. Per instal·lar-lo a Windows, simplement accedeix a la web oficial de Git (https://git-scm.com/download/win), descarrega l'instal·lador que correspongui al teu sistema (normalment, 64 bits) i segueix els passos de l'assistent. Durant la instal·lació, pots deixar seleccionades les opcions per defecte, triant GitBash com a emulador de terminal. En acabar, pots obrir Git Bash i comprovar si tot funciona bé executant l'ordre git –versió.

Pas 2: Descarregant i usant RubyInstaller

El mètode més recomanable i habitual per instal·lar Ruby a Windows és a través de RubyInstaller, una eina oficial que integra tant l'intèrpret com els components essencials per al desenvolupament.

Per obtenir la darrera versió:

• Vés a la web oficial de RubyInstaller: https://rubyinstaller.org/
• Descarrega l'instal·lador més actual, cercant la variant que inclou Devkit. Exemple: Ruby+Devkit 3.xx (x64).
• Executeu l'instal·lador, accepteu la llicència i seleccioneu l'opció per afegir Ruby a la variable PATH del Windows. Això facilitarà que puguis fer servir Ruby des de qualsevol terminal.
• A l'últim pas, assegura't de deixar seleccionada l'opció per instal·lar MSYS2 i les eines de desenvolupament necessàries. Quan acabis, s'obrirà una terminal que executarà la configuració automàtica de MSYS2 amb diverses opcions; normalment lopció 3 cobreix tot el necessari per a la majoria dusuaris.

Per comprovar que Ruby s'ha instal·lat correctament, obre Git Bash o qualsevol terminal i executa rubí-v. Si tot ha anat bé, veuràs a la pantalla la versió instal·lada.

Pas 3: Instal·lar Ruby DevKit i configurar l'entorn

El DevKit és essencial per compilar algunes gemmes que requereixen components nadius. Si heu instal·lat Ruby amb el paquet +Devkit, normalment ja tindreu tot el necessari. No obstant això, si cal instal·lar-lo manualment:

• Descarrega el paquet DevKit des de la web de RubyInstaller.
• Executeu l'instal·lador i extraieu els fitxers en una carpeta, per exemple «C:\DevKit».
• Obre una finestra d'ordres (cmd.exe), navega a la carpeta del DevKit i executa:

> chdir C:\DevKit > ruby ​​dk.rb init > ruby ​​dk.rb install

Pas 4: Instal·lar i configurar components addicionals (Node.js, Yarn i SQLite)

Quan planeges crear projectes web amb Ruby on Rails, necessitaràs a més NODE.JS y Yarn per gestionar els recursos JavaScript, així com SQLite si utilitzes la configuració per defecte de Rails.

• Node.js: Vés a nodejs.org, descarrega la versió LTS recomanada i segueix els passos. Durant la instal·lació, assegureu-vos de marcar l'opció per instal·lar les eines addicionals si us ho demana.
• Fil: Descarrega l'instal·lador des de la web oficial de Yarn i segueix els passos a la pantalla.
• SQLite: Descarrega els fitxers sqlite-dll-win64-x64-XXXXXX.zip y sqlite-tools-win32-x86-XXXXXX.zip des del web oficial, descomprimeix el contingut a la carpeta C: \ Windows \ System32 perquè siguin accessibles com a ordres globals.

Confirma que tot ha quedat bé executant a la terminal les comandes node -v, yarn -v y sqlite3 –versió. Hauries de veure les versions instal·lades sense problemes.

Pas 5: Verificant la instal·lació de Ruby

Per assegurar-te que Ruby està totalment operatiu, obre una terminal i escriu:

rubí-v

Hauries de veure la versió que has instal·lat. A més, pots provar la instal·lació de gemmes, per exemple amb:

gem install bundler

Si tot va bé, ja tens el teu entorn llest per avançar. Si rebeu algun missatge d'error, reviseu que heu afegit Ruby a la variable PATH i que vau completar la instal·lació de MSYS2.

Pas 6: Instal·lant Rails i les teves primeres gemmes

El següent pas habitual és instal·lar Riells, el framework més emblemàtic de l'ecosistema Ruby. Per fer-ho, només cal executar a la terminal:

gem install rails

La instal·lació pot trigar uns quants minuts, ja que es descarreguen i compilen moltes dependències. Un cop completada, verifica la instal·lació amb:

rails -v

A més de Rails, és molt recomanable instal·lar Empaquetador (tot i que normalment s'instal·la automàticament). Bundler és la gemma encarregada de gestionar la resta de dependències als teus projectes Ruby:

gem install bundler

Creant i arrencant el teu primer projecte Ruby on Rails

Si vols anar un pas més enllà i comprovar que tot funciona correctament, pots crear el teu primer projecte amb Rails:

rails new la meva_app_de_prova

Quan acabi el procés, accedeix al nou directori i arrenca el servidor:

cd el meu_app_de_prova rails server

Obre el teu navegador i accedeix a http://localhost:3000. Hauries de veure la pantalla de benvinguda de Rails, senyal que tens Ruby i tots els components correctament instal·lats i configurats al teu Windows.

No oblidis que pots tancar el servidor prement Ctrl + C a la terminal.

Gestors de versions: com manejar diverses instal·lacions de Ruby

Si necessites treballar en diferents projectes amb requisits diferents sobre la versió de Ruby (per exemple, una app antiga i una altra de recent creada), hi ha gestors de versions específics per a Windows, com ara rbenv per a Windows (adaptat a PowerShell) o gran, que permeten canviar entre versions fàcilment i estan dissenyats per integrar-se de forma nativa.

Altres gestors molt populars com asdf-vm y chruby solen estar més enfocats a entorns UNIX, però si tens experiència pots utilitzar-los també a Windows amb certes adaptacions.

Instal·lació manual i compilació de Ruby des del codi font

En la majoria dels casos, instal·lar Ruby a través de RubyInstaller és més que suficient i estalvia temps, però si tens necessitats molt concretes (per exemple, vols una versió específica, necessites personalitzar les opcions de compilació, o simplement vols aprendre com funciona el procés), pots instal·lar Ruby compilant el codi font.

1. Descarrega la versió desitjada del codi font des de la web oficial de Ruby (ruby-lang.org/ca/downloads/).
2. Descomprimeix el paquet i segueix les instruccions incloses per compilar-lo (pot requerir eines addicionals com Make, GCC, etc., que pots instal·lar a través de MSYS2).
3. Per defecte el binari s'instal·larà a C:\Ruby o la carpeta que escolliu durant la configuració.

Aquest mètode sol estar recomanat només per a usuaris avançats o entorns de desenvolupament molt especials, ja que requereix més coneixement tècnic i pot donar més problemes de compatibilitat.

Errors comuns i consells útils

Durant la instal·lació o l'ús de Ruby al Windows pots trobar algunes errades típiques:

• Problemes amb el PATH: Si "ruby" no es reconeix com a ordre, revisa que la carpeta d'instal·lació estigui afegida correctament a la variable d'entorn PATH.
• Errors en instal·lar gemmes natives: Assegureu-vos que teniu DevKit o MSYS2 correctament configurats i actualitzats.
• Conflictes entre versions: Si treballes en diversos projectes, utilitza un gestor de versions com rbenv per a Windows o uru per evitar embolics.
• Problemes amb dependències de Rails: Confirma que tens Node.js, Yarn i SQLite a les seves versions correctes abans de llançar un nou projecte Rails.

Si en algun punt et trobes encallat, recorda que la documentació oficial (ruby-lang.org) i fòrums especialitzats et poden ajudar ràpidament. A més, podeu trobar ajuda de la comunitat tant en espanyol com en anglès.

¿ I si vull instal·lar diverses eines i gestors?

Molts usuaris avançats utilitzen eines de tercers per gestionar diverses versions de Ruby segons el projecte. Aquests gestors, encara que no estan suportats oficialment a Windows, poden ser útils:

• rbenv per a Windows: Adaptació de rbenv, compatible des de línia d'ordres a PowerShell.
• uru: Gestor multiplataforma lleuger, fàcil de configurar.

Si treballes principalment en entorn UNIX, gestors com asdf-vm o chruby poden ser preferibles, però a Windows el més pràctic sol ser mantenir-se amb RubyInstaller i, si de cas, uru.