Digita almeno due lettere per cercare in ogni pagina della documentazione.

↑ ↓ per navigare ↵ per aprire esc per chiudere

Usare rdev

Linguaggi e pacchetti di sistema

PHP e Node.js sono pronti in ogni ambiente. Python, Ruby, Go, .NET, Java e Flutter ci sono quando un progetto ne ha bisogno: installa le versioni che vuoi, affiancate, e scegline una per ogni progetto. I pacchetti di sistema aggiungono le librerie e gli strumenti con cui vengono compilati alcuni pacchetti e test.

Quale versione ottiene un progetto

python, ruby, go, dotnet e i loro strumenti (pip, gem, bundle e così via) scelgono la versione in quest'ordine:

  1. il file di versione del progetto, come .python-version, .ruby-version o global.json;
  2. la versione scelta per il progetto nel pannello;
  3. la versione predefinita.

Nel pannello

Apri il server da Server nella barra laterale, poi Runtime. La scheda Python, Ruby, Go, .NET, Java e Flutter, dopo la scheda Node.js, ha una sezione per ogni linguaggio:

  • Aggiungi versione installa un'altra linea di versione: Python da 3.11 a 3.14, Ruby da 3.2 a 3.4, Go da 1.25 a 1.27, .NET da 8 a 10, Java 17, 21 e 25, nonché Flutter 3.44 e 3.47. Viene installata l'ultima release di quella linea; può richiedere qualche minuto.
  • Il menu ⋯ di una versione la rende predefinita o la rimuove. La versione predefinita e una versione a cui è fissato un progetto non possono essere rimosse.
  • Versione del progetto fissa un progetto a una versione o lo riporta a quella predefinita.

Serve rdev 0.2.0-beta.36 o successivo; finché il server non lo esegue, la scheda ti chiede di aggiornare. .NET compare quando il server esegue rdev 1.0.6 o successivo, Flutter quando il rdev del server viene aggiornato a una versione che lo include.

Progetti Python

Ogni progetto Python ha il proprio ambiente virtuale in .venv, quindi due progetti possono fissare versioni diverse dello stesso pacchetto. Quando aggiungi un progetto, rdev lo crea e installa le dipendenze: uv sync quando il progetto ha un uv.lock, altrimenti pip con il suo requirements.txt o pyproject.toml. Il server di sviluppo e i processi del progetto girano con .venv per primo nel PATH. Se l'installazione non riesce, il progetto viene aggiunto comunque e rdev mostra il comando da eseguire nella sua cartella.

.NET

.NET 8, 9 e 10 si installano affiancati, e un progetto sceglie il proprio SDK con global.json; senza questo file riceve l'SDK installato più recente. Fissare un progetto a una versione, nel pannello o con rdev lang use, scrive quel file per te. Un progetto con un file .csproj, .fsproj, .sln o .slnx viene riconosciuto come .NET e il suo server di sviluppo parte con dotnet watch run, quindi si ricarica quando salvi. Ogni SDK occupa circa 600 MB di disco.

Il tuo sito è servito in HTTPS davanti all'app, quindi l'app stessa ascolta in HTTP semplice. Se reindirizza a HTTPS o costruisce link assoluti, attiva gli header inoltrati (app.UseForwardedHeaders() con X-Forwarded-Proto) così sa che la richiesta è arrivata in HTTPS.

SQL Server non è ancora disponibile come servizio. Usa PostgreSQL o MySQL con Entity Framework Core (il provider Npgsql o Pomelo), oppure collegati a un SQL Server che gestisci altrove. Puoi anche usare un SQL Server sul tuo portatile tramite Tailscale: attiva TCP/IP in SQL Server, apri la porta 1433 nel firewall del portatile alla tua rete Tailscale e inserisci l'indirizzo Tailscale del portatile nella stringa di connessione (Server=100.x.y.z,1433). La connessione si interrompe mentre il portatile è in sospensione.

Java

Java 25, 21 e 17 si installano affiancate. Sono le linee con supporto a lungo termine, e la 25 è quella predefinita. Installane una con rdev lang install java 25. Un progetto sceglie la versione con un file .java-version o .tool-versions; fissare un progetto a una versione, dal pannello o con rdev lang use java 21, scrive quel file al posto tuo. JAVA_HOME è impostato per ogni progetto. Un progetto con un pom.xml (Maven) o un build.gradle (Gradle) viene riconosciuto come Java.

Un progetto Spring Boot con il wrapper mvnw ricarica il codice modificato in circa 8 secondi: rdev ricompila quando cambiano i file sotto src. Quarkus gira in modalità dev, che si ricarica da sola.

Un server di sviluppo Java usa circa 350–700 MB di memoria, quindi sui server piccoli esegui solo pochi progetti Java alla volta.

Flutter

Aggiungi un'app Flutter come qualsiasi altro progetto: clonala, oppure creane una dalla ricetta Flutter; rdev la riconosce dal suo pubspec.yaml. Quando l'app ha un target web (una cartella web), la sua anteprima web gira su https://<project>.dev.test e si ricarica quando salvi; la prima build richiede circa mezzo minuto. Su un telefono, un emulatore o un simulatore gira dal tuo computer: con la sincronizzazione dei file attiva, apri la stessa cartella del progetto sul tuo laptop ed esegui lì flutter run. Le build per iOS richiedono un Mac con Xcode. Un'app senza target web viene aggiunta senza un server di sviluppo. Sul server, flutter pub get, flutter analyze, flutter test e flutter build web funzionano per te e per i tuoi agenti. Aggiungere progetti Flutter richiede rdev 1.4.3 o successivo; la ricetta Flutter funziona dalla 1.4.2.

Installa una versione con rdev lang install flutter 3.47; Dart viene incluso, quindi funziona anche dart. Un progetto sceglie la propria versione con un .fvmrc (come lo scrive FVM) o un file .tool-versions, altrimenti usa la versione scelta nel pannello o quella predefinita. Ogni versione occupa circa 1 GB di disco.

Flutter scrive i percorsi propri di questo computer in alcuni file generati (.dart_tool, .flutter-plugins-dependencies, ios/Flutter/Generated.xcconfig, android/local.properties), perciò la sincronizzazione dei file li lascia fuori: il laptop e il server tengono ciascuno i propri, e flutter pub get li ricrea. Tieni la tua chiave di firma Android (key.properties e il keystore) fuori da git.

Pacchetti di sistema

La scheda Pacchetti di sistema installa con un clic gruppi di librerie e strumenti di sistema:

Gruppo A cosa serve
Strumenti di build Un compilatore e gli header con cui vengono compilate le estensioni native (wheel Python, gem Ruby, addon npm)
Client PostgreSQL psql e la libreria a cui si collegano i driver dei database
Client MySQL mysql e la libreria a cui si collegano i driver dei database
Librerie per immagini Elaborazione di immagini, come Pillow o sharp
Librerie canvas Disegno e rendering di PDF, come node-canvas
Librerie XML Analisi XML, come lxml o Nokogiri
FFmpeg Conversione di video e audio
Chromium Un browser headless per i test nel browser e la generazione di PDF
GitHub CLI Il comando gh per GitHub: pull request, issue, release e Actions. Accedi una volta con gh auth login
Librerie ICU Dati Unicode e di lingua di cui .NET ha bisogno; installati da soli con la prima versione di .NET

La rimozione di un gruppo chiede prima conferma: i progetti che vengono compilati o eseguiti con esso potrebbero smettere di funzionare finché non viene reinstallato. I gruppi scelti ritornano da soli dopo che rdev aggiorna l'ambiente. Chromium gira all'interno del container dell'ambiente, quindi avvialo con --no-sandbox (Puppeteer: args: ['--no-sandbox']).

Sul server

rdev lang list                       # installed and available versions, defaults and project choices
rdev lang install python 3.13        # the newest 3.13 release
rdev lang default python 3.13
rdev lang use shop python 3.12       # pin a project; rdev lang use shop python default undoes it
rdev lang remove python 3.12
rdev lang install dotnet 10
rdev lang install flutter 3.47        # Flutter with its Dart
rdev system list
rdev system install postgres         # build tools, postgres, mysql, images, canvas, xml, ffmpeg, chromium, gh, tauri
rdev system remove postgres

python, pip, ruby, gem, bundle, go, gofmt, dotnet, flutter e dart seguono prima il file di versione del progetto (.tool-versions, mise.toml, .python-version, .ruby-version, la riga go di go.mod, global.json, .fvmrc), poi la versione scelta per il progetto, poi quella predefinita; una versione non installata si ferma con un messaggio che ti dice di installarla. Gli agenti usano gli stessi comandi, e tramite MCP rdev_lang_list, rdev_lang_install, rdev_lang_project e rdev_system_install (un agente che vede fallire una build nativa, come "pg_config not found", installa il gruppo giusto). I comandi che pip install o gem install aggiungono vengono eseguiti con python -m, un ambiente virtuale, bundle exec o gem exec.