Wpisz co najmniej dwie litery, aby przeszukać każdą stronę dokumentacji.

↑ ↓ aby nawigować ↵ aby otworzyć esc aby zamknąć

Korzystanie z rdev

Języki i pakiety systemowe

PHP i Node.js są gotowe w każdym środowisku. Python, Ruby, Go, .NET, Java i Flutter są dostępne, gdy projekt ich potrzebuje: zainstaluj wersje, które chcesz, obok siebie i wybierz jedną dla każdego projektu. Pakiety systemowe dodają biblioteki i narzędzia, z którymi budują się niektóre pakiety i testy.

Którą wersję dostaje projekt

python, ruby, go, dotnet i ich narzędzia (pip, gem, bundle i tak dalej) wybierają wersję w tej kolejności:

  1. własny plik wersji projektu, taki jak .python-version, .ruby-version lub global.json;
  2. wersja wybrana dla projektu w panelu;
  3. wersja domyślna.

W panelu

Otwórz serwer z Serwery na pasku bocznym, a potem Środowisko uruchomieniowe. Karta Python, Ruby, Go, .NET, Java i Flutter, po karcie Node.js, ma sekcję dla każdego języka:

  • Dodaj wersję instaluje kolejną linię wersji: Python 3.11 do 3.14, Ruby 3.2 do 3.4, Go 1.25 do 1.27, .NET 8 do 10, Java 17, 21 i 25 oraz Flutter 3.44 i 3.47. Instalowane jest najnowsze wydanie tej linii; może to potrwać kilka minut.
  • Menu ⋯ przy wersji ustawia ją jako domyślną lub ją usuwa. Wersji domyślnej i wersji, do której przypięty jest projekt, nie można usunąć.
  • Wersja projektu przypina projekt do wersji lub przywraca go do domyślnej.

Wymaga to rdev 0.2.0-beta.36 lub nowszego; dopóki serwer go nie ma, karta prosi o aktualizację. .NET pojawia się, gdy serwer ma rdev 1.0.6 lub nowszy, a Flutter, gdy rdev na serwerze zostanie zaktualizowany do wydania, które go zawiera.

Projekty Python

Każdy projekt Python dostaje własne środowisko wirtualne w .venv, więc dwa projekty mogą przypiąć różne wersje tego samego pakietu. Gdy dodajesz projekt, rdev tworzy je i instaluje zależności: uv sync, gdy projekt ma uv.lock, w przeciwnym razie pip z jego requirements.txt lub pyproject.toml. Serwer deweloperski i procesy projektu działają z .venv na początku PATH. Jeśli instalacja się nie powiedzie, projekt i tak zostaje dodany, a rdev pokazuje polecenie do uruchomienia w jego folderze.

.NET

.NET 8, 9 i 10 instalują się obok siebie, a projekt wybiera swój SDK przez global.json; bez tego pliku dostaje najnowszy zainstalowany SDK. Przypięcie projektu do wersji, w panelu lub przez rdev lang use, zapisuje ten plik za ciebie. Projekt z plikiem .csproj, .fsproj, .sln lub .slnx jest rozpoznawany jako .NET, a jego serwer deweloperski startuje z dotnet watch run, więc przeładowuje się po zapisaniu. Każdy SDK zajmuje około 600 MB miejsca na dysku.

Twoja strona jest serwowana przez HTTPS przed aplikacją, więc sama aplikacja nasłuchuje na zwykłym HTTP. Jeśli przekierowuje na HTTPS lub buduje bezwzględne linki, włącz nagłówki przekazywane (app.UseForwardedHeaders() z X-Forwarded-Proto), aby wiedziała, że żądanie przyszło przez HTTPS.

SQL Server nie jest jeszcze dostępny jako usługa. Użyj PostgreSQL lub MySQL z Entity Framework Core (dostawca Npgsql lub Pomelo) albo połącz się z SQL Server, który uruchamiasz gdzie indziej. Możesz też korzystać z SQL Servera na własnym laptopie przez Tailscale: włącz TCP/IP w SQL Serverze, otwórz port 1433 w zaporze laptopa dla swojej sieci Tailscale i wpisz adres Tailscale laptopa w ciągu połączenia (Server=100.x.y.z,1433). Gdy laptop jest uśpiony, połączenie zostaje zerwane.

Java

Java 25, 21 i 17 instalują się obok siebie. To linie z długoterminowym wsparciem, a domyślna jest 25. Zainstaluj jedną poleceniem rdev lang install java 25. Projekt wybiera wersję za pomocą pliku .java-version lub .tool-versions; przypięcie projektu do wersji, w panelu lub poleceniem rdev lang use java 21, zapisuje ten plik za ciebie. JAVA_HOME jest ustawione dla każdego projektu. Projekt z plikiem pom.xml (Maven) lub build.gradle (Gradle) jest rozpoznawany jako Java.

Projekt Spring Boot z wrapperem mvnw przeładowuje zmieniony kod w około 8 sekund: rdev kompiluje go ponownie, gdy zmienią się pliki w src. Quarkus działa w trybie dev, który sam się przeładowuje.

Serwer deweloperski Javy zużywa około 350–700 MB pamięci, więc na małych serwerach uruchamiaj naraz tylko kilka projektów Java.

Flutter

Dodaj aplikację Flutter jak każdy inny projekt: sklonuj ją albo zacznij od przepisu Flutter; rdev rozpoznaje ją po pliku pubspec.yaml. Gdy aplikacja ma cel web (folder web), jej podgląd webowy działa pod adresem https://<project>.dev.test i przeładowuje się po zapisaniu; pierwsza kompilacja trwa około pół minuty. Na telefonie, w emulatorze lub w symulatorze działa z Twojego własnego komputera: przy włączonej synchronizacji plików otwórz ten sam folder projektu na laptopie i uruchom tam flutter run. Kompilacje na iOS wymagają Maca z Xcode. Aplikacja bez celu web jest dodawana bez serwera deweloperskiego. Na serwerze flutter pub get, flutter analyze, flutter test i flutter build web działają dla Ciebie i Twoich agentów. Dodawanie projektów Flutter wymaga rdev 1.4.3 lub nowszego; przepis Flutter działa od 1.4.2.

Zainstaluj wersję poleceniem rdev lang install flutter 3.47; Dart jest w zestawie, więc dart też działa. Projekt wybiera swoją wersję przez plik .fvmrc (w formie, jaką zapisuje FVM) lub .tool-versions, a w przeciwnym razie przez wersję wybraną w panelu albo domyślną. Każda wersja zajmuje około 1 GB miejsca na dysku.

Flutter zapisuje ścieżki właściwe dla danego komputera w niektórych generowanych plikach (.dart_tool, .flutter-plugins-dependencies, ios/Flutter/Generated.xcconfig, android/local.properties), dlatego synchronizacja plików je pomija: laptop i serwer mają każdy własne, a flutter pub get tworzy je od nowa. Nie trzymaj klucza podpisywania Androida (key.properties i keystore) w git.

Pakiety systemowe

Karta Pakiety systemowe instaluje grupy bibliotek i narzędzi systemowych jednym kliknięciem:

Grupa Do czego służy
Narzędzia budowania Kompilator i nagłówki, z którymi budują się rozszerzenia natywne (wheels Pythona, gemy Ruby, dodatki npm)
Klient PostgreSQL psql i biblioteka, z którą łączą się sterowniki baz danych
Klient MySQL mysql i biblioteka, z którą łączą się sterowniki baz danych
Biblioteki obrazów Przetwarzanie obrazów, na przykład Pillow lub sharp
Biblioteki canvas Rysowanie i renderowanie PDF, na przykład node-canvas
Biblioteki XML Parsowanie XML, na przykład lxml lub Nokogiri
FFmpeg Konwersja wideo i dźwięku
Chromium Przeglądarka headless do testów przeglądarkowych i generowania PDF
GitHub CLI Polecenie gh dla GitHuba: pull requesty, zgłoszenia, wydania i Actions. Zaloguj się raz przez gh auth login
Biblioteki ICU Dane Unicode i językowe potrzebne .NET; instalowane samoczynnie z pierwszą wersją .NET

Usunięcie grupy najpierw pyta o potwierdzenie: projekty, które się z nią budują lub na niej działają, mogą przestać działać, dopóki nie zostanie zainstalowana ponownie. Wybrane grupy wracają same po tym, jak rdev zaktualizuje środowisko. Chromium działa wewnątrz kontenera środowiska, więc uruchamiaj go z --no-sandbox (Puppeteer: args: ['--no-sandbox']).

Na serwerze

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 i dart stosują najpierw własny plik wersji projektu (.tool-versions, mise.toml, .python-version, .ruby-version, linię go z go.mod, global.json, .fvmrc), potem wersję wybraną dla projektu, a na końcu domyślną; wersja, która nie jest zainstalowana, zatrzymuje się z komunikatem, że trzeba ją zainstalować. Agenci używają tych samych poleceń, a przez MCP rdev_lang_list, rdev_lang_install, rdev_lang_project i rdev_system_install (agent, który widzi niepowodzenie natywnego budowania, na przykład „pg_config not found”, instaluje właściwą grupę). Polecenia, które dodają pip install lub gem install, uruchamia się przez python -m, środowisko wirtualne, bundle exec lub gem exec.