Digite pelo menos duas letras para buscar em todas as páginas da documentação.

↑ ↓ para navegar ↵ para abrir esc para fechar

Usando o rdev

Linguagens e pacotes do sistema

O PHP e o Node.js vêm prontos em todos os ambientes. Python, Ruby, Go, .NET, Java e Flutter estão disponíveis quando um projeto precisa deles: instale as versões que quiser, lado a lado, e escolha uma para cada projeto. Os pacotes do sistema adicionam as bibliotecas e ferramentas contra as quais alguns pacotes e testes fazem build.

Qual versão um projeto recebe

python, ruby, go, dotnet e as ferramentas deles (pip, gem, bundle e assim por diante) escolhem a versão nesta ordem:

  1. o arquivo de versão do próprio projeto, como .python-version, .ruby-version ou global.json;
  2. a versão escolhida para o projeto no painel;
  3. a versão padrão.

No painel

Abra o servidor em Servidores na barra lateral e depois em Runtime. O card Python, Ruby, Go, .NET, Java e Flutter, depois do card do Node.js, tem uma seção para cada linguagem:

  • Adicionar versão instala outra linha de versão: Python 3.11 a 3.14, Ruby 3.2 a 3.4, Go 1.25 a 1.27, .NET 8 a 10, Java 17, 21 e 25, além de Flutter 3.44 e 3.47. A versão mais recente dessa linha é instalada; isso pode levar alguns minutos.
  • O menu ⋯ de uma versão a define como padrão ou a remove. A versão padrão e uma versão à qual um projeto está fixado não podem ser removidas.
  • Versão do projeto fixa um projeto em uma versão ou o devolve ao padrão.

Isso exige o rdev 0.2.0-beta.36 ou posterior; até o servidor executá-lo, o card pede que você atualize. O .NET aparece quando o servidor executa o rdev 1.0.6 ou posterior, e o Flutter quando o rdev do servidor é atualizado para uma versão que o inclui.

Projetos Python

Cada projeto Python ganha o próprio ambiente virtual em .venv, então dois projetos podem fixar versões diferentes do mesmo pacote. Quando você adiciona um projeto, o rdev cria esse ambiente e instala as dependências: uv sync quando o projeto tem um uv.lock, senão pip com o requirements.txt ou o pyproject.toml dele. O servidor de desenvolvimento e os processos do projeto rodam com .venv primeiro no PATH. Se a instalação falhar, o projeto é adicionado mesmo assim e o rdev mostra o comando a executar na pasta dele.

.NET

O .NET 8, 9 e 10 são instalados lado a lado, e um projeto escolhe seu SDK com global.json; sem esse arquivo, ele recebe o SDK instalado mais recente. Fixar um projeto em uma versão, no painel ou com rdev lang use, grava esse arquivo para você. Um projeto com um arquivo .csproj, .fsproj, .sln ou .slnx é reconhecido como .NET, e seu servidor de desenvolvimento inicia com dotnet watch run, então recarrega quando você salva. Cada SDK ocupa cerca de 600 MB de disco.

Seu site é servido por HTTPS na frente do app, então o próprio app escuta em HTTP simples. Se ele redireciona para HTTPS ou gera links absolutos, ative os cabeçalhos encaminhados (app.UseForwardedHeaders() com X-Forwarded-Proto) para que ele saiba que a requisição chegou por HTTPS.

O SQL Server ainda não está disponível como serviço. Use PostgreSQL ou MySQL com Entity Framework Core (o provedor Npgsql ou Pomelo) ou conecte-se a um SQL Server que você executa em outro lugar. Você também pode usar um SQL Server do seu próprio notebook pelo Tailscale: ative o TCP/IP no SQL Server, libere a porta 1433 no firewall do notebook para a sua rede Tailscale e use o endereço Tailscale do notebook na string de conexão (Server=100.x.y.z,1433). A conexão cai enquanto o notebook está em repouso.

Java

Java 25, 21 e 17 são instalados lado a lado. São as linhas com suporte de longo prazo, e a 25 é a padrão. Instale uma com rdev lang install java 25. Um projeto escolhe sua versão com um arquivo .java-version ou .tool-versions; fixar um projeto em uma versão, no painel ou com rdev lang use java 21, grava esse arquivo para você. JAVA_HOME é definido para cada projeto. Um projeto com pom.xml (Maven) ou build.gradle (Gradle) é reconhecido como Java.

Um projeto Spring Boot com o wrapper mvnw recarrega o código alterado em cerca de 8 segundos: o rdev recompila quando arquivos em src mudam. O Quarkus roda em modo dev, que se recarrega sozinho.

Um servidor de desenvolvimento Java usa cerca de 350–700 MB de memória, então em servidores pequenos rode apenas alguns projetos Java ao mesmo tempo.

Flutter

Adicione um app Flutter como qualquer outro projeto: clone-o ou comece um a partir da recipe Flutter; o rdev o reconhece pelo pubspec.yaml. Quando o app tem alvo web (uma pasta web), a pré-visualização web roda em https://<project>.dev.test e recarrega quando você salva; o primeiro build leva cerca de meio minuto. Em um celular, emulador ou simulador, ele roda a partir do seu próprio computador: com a sincronização de arquivos ativada, abra a mesma pasta do projeto no seu laptop e rode flutter run lá. Builds para iOS exigem um Mac com Xcode. Um app sem alvo web é adicionado sem servidor de desenvolvimento. No servidor, flutter pub get, flutter analyze, flutter test e flutter build web funcionam para você e seus agentes. Adicionar projetos Flutter exige o rdev 1.4.3 ou posterior; a recipe Flutter funciona a partir da 1.4.2.

Instale uma versão com rdev lang install flutter 3.47; o Dart vem junto, então dart também funciona. Um projeto escolhe sua versão com um .fvmrc (como o FVM o escreve) ou um arquivo .tool-versions; caso contrário, vale a versão escolhida no painel ou a padrão. Cada versão ocupa cerca de 1 GB de disco.

O Flutter grava os caminhos próprios deste computador em alguns arquivos gerados (.dart_tool, .flutter-plugins-dependencies, ios/Flutter/Generated.xcconfig, android/local.properties), por isso a sincronização de arquivos os deixa de fora: o laptop e o servidor mantêm cada um os seus, e o flutter pub get os recria. Mantenha sua chave de assinatura do Android (key.properties e o keystore) fora do git.

Pacotes do sistema

O card Pacotes do sistema instala grupos de bibliotecas e ferramentas do sistema com um clique:

Grupo Para que serve
Ferramentas de build Um compilador e os headers com os quais as extensões nativas (wheels do Python, gems do Ruby, addons do npm) fazem build
Cliente PostgreSQL psql e a biblioteca à qual os drivers de banco de dados se vinculam
Cliente MySQL mysql e a biblioteca à qual os drivers de banco de dados se vinculam
Bibliotecas de imagem Processamento de imagens, como Pillow ou sharp
Bibliotecas de canvas Desenho e renderização de PDF, como node-canvas
Bibliotecas XML Análise de XML, como lxml ou Nokogiri
FFmpeg Conversão de vídeo e áudio
Chromium Um navegador headless para testes de navegador e geração de PDF
GitHub CLI O comando gh para o GitHub: pull requests, issues, releases e Actions. Entre uma vez com gh auth login
Bibliotecas ICU Dados Unicode e de idioma de que o .NET precisa; instalados automaticamente com a primeira versão do .NET

Remover um grupo pergunta antes: os projetos que fazem build ou rodam com ele podem deixar de funcionar até que ele seja instalado novamente. Os grupos escolhidos voltam sozinhos depois que o rdev atualiza o ambiente. O Chromium roda dentro do container do ambiente, então inicie-o com --no-sandbox (Puppeteer: args: ['--no-sandbox']).

No servidor

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 seguem primeiro o arquivo de versão do próprio projeto (.tool-versions, mise.toml, .python-version, .ruby-version, a linha go do go.mod, global.json, .fvmrc), depois a versão escolhida para o projeto, depois a padrão; uma versão que não está instalada para com uma mensagem pedindo que você a instale. Os agentes usam os mesmos comandos, e por MCP rdev_lang_list, rdev_lang_install, rdev_lang_project e rdev_system_install (um agente que vê um build nativo falhar, como "pg_config not found", instala o grupo certo). Os comandos que pip install ou gem install adicionam são executados com python -m, um ambiente virtual, bundle exec ou gem exec.