Gõ ít nhất hai chữ cái để tìm trong mọi trang tài liệu.

↑ ↓ để di chuyển ↵ để mở esc để đóng

Sử dụng rdev

Ngôn ngữ và gói hệ thống

PHP và Node.js có sẵn trong mọi môi trường. Python, Ruby, Go, .NET, Java và Flutter có mặt khi một dự án cần: hãy cài các phiên bản bạn muốn, song song với nhau, và chọn một phiên bản cho từng dự án. Các gói hệ thống bổ sung những thư viện và công cụ mà một số gói và bài kiểm thử dựa vào để build.

Dự án nhận phiên bản nào

python, ruby, go, dotnet và các công cụ của chúng (pip, gem, bundle, v.v.) chọn phiên bản theo thứ tự sau:

  1. tệp phiên bản riêng của dự án, như .python-version, .ruby-version hoặc global.json;
  2. phiên bản được chọn cho dự án trên bảng điều khiển;
  3. phiên bản mặc định.

Trên bảng điều khiển

Mở máy chủ từ Máy chủ trên thanh bên, rồi chọn Runtime. Thẻ Python, Ruby, Go, .NET, Java và Flutter, nằm sau thẻ Node.js, có một phần cho mỗi ngôn ngữ:

  • Thêm phiên bản cài một dòng phiên bản khác: Python 3.11 đến 3.14, Ruby 3.2 đến 3.4, Go 1.25 đến 1.27, .NET 8 đến 10, Java 17, 21 và 25, cùng Flutter 3.44 và 3.47. Bản phát hành mới nhất của dòng đó được cài đặt; việc này có thể mất vài phút.
  • Menu ⋯ trên một phiên bản đặt nó làm mặc định hoặc xóa nó. Phiên bản mặc định và phiên bản mà một dự án đang gắn không thể bị xóa.
  • Phiên bản dự án gắn một dự án với một phiên bản hoặc đưa nó về mặc định.

Điều này cần rdev 0.2.0-beta.36 trở lên; cho đến khi máy chủ chạy bản đó, thẻ sẽ yêu cầu bạn cập nhật. .NET xuất hiện khi máy chủ chạy rdev 1.0.6 trở lên, còn Flutter xuất hiện khi rdev của máy chủ được cập nhật lên bản có hỗ trợ nó.

Dự án Python

Mỗi dự án Python có môi trường ảo riêng trong .venv, nên hai dự án có thể cố định các phiên bản khác nhau của cùng một gói. Khi bạn thêm một dự án, rdev tạo môi trường đó và cài các phụ thuộc: uv sync khi dự án có uv.lock, nếu không thì pip với requirements.txt hoặc pyproject.toml của nó. Máy chủ phát triển và các tiến trình của dự án chạy với .venv đứng đầu trong PATH. Nếu cài đặt thất bại, dự án vẫn được thêm và rdev hiển thị lệnh cần chạy trong thư mục của nó.

.NET

.NET 8, 9 và 10 được cài song song, và một dự án chọn SDK của mình bằng global.json; nếu không có tệp này, dự án nhận SDK mới nhất đã cài. Cố định một dự án vào một phiên bản, trên bảng điều khiển hoặc bằng rdev lang use, sẽ ghi tệp đó giúp bạn. Dự án có tệp .csproj, .fsproj, .sln hoặc .slnx được nhận diện là .NET, và máy chủ phát triển của nó khởi động bằng dotnet watch run, nên tự tải lại khi bạn lưu. Mỗi SDK chiếm khoảng 600 MB dung lượng ổ đĩa.

Trang web của bạn được phục vụ qua HTTPS phía trước ứng dụng, nên bản thân ứng dụng lắng nghe HTTP thuần. Nếu ứng dụng chuyển hướng sang HTTPS hoặc tạo liên kết tuyệt đối, hãy bật các header được chuyển tiếp (app.UseForwardedHeaders() với X-Forwarded-Proto) để nó biết yêu cầu đã đến qua HTTPS.

SQL Server hiện chưa có sẵn dưới dạng dịch vụ. Hãy dùng PostgreSQL hoặc MySQL với Entity Framework Core (nhà cung cấp Npgsql hoặc Pomelo), hoặc kết nối tới một SQL Server mà bạn chạy ở nơi khác. Bạn cũng có thể dùng SQL Server trên laptop của mình qua Tailscale: bật TCP/IP trong SQL Server, mở cổng 1433 trên tường lửa của laptop cho mạng Tailscale và ghi địa chỉ Tailscale của laptop vào chuỗi kết nối (Server=100.x.y.z,1433). Kết nối bị ngắt khi laptop ngủ.

Java

Java 25, 21 và 17 được cài song song. Đây là các dòng hỗ trợ dài hạn, và 25 là mặc định. Cài một phiên bản bằng rdev lang install java 25. Một dự án chọn phiên bản bằng tệp .java-version hoặc .tool-versions; khi bạn ghim dự án vào một phiên bản, trên bảng điều khiển hoặc bằng rdev lang use java 21, rdev sẽ ghi tệp đó giúp bạn. JAVA_HOME được đặt cho mọi dự án. Dự án có pom.xml (Maven) hoặc build.gradle (Gradle) được nhận diện là Java.

Dự án Spring Boot có trình bao mvnw tải lại mã đã thay đổi trong khoảng 8 giây: rdev biên dịch lại khi các tệp trong src thay đổi. Quarkus chạy ở chế độ dev, tự tải lại.

Máy chủ phát triển Java dùng khoảng 350–700 MB bộ nhớ, nên trên máy chủ nhỏ hãy chỉ chạy một vài dự án Java cùng lúc.

Flutter

Thêm một ứng dụng Flutter như mọi dự án khác: clone nó, hoặc bắt đầu một ứng dụng từ recipe Flutter; rdev nhận ra nó qua pubspec.yaml. Khi ứng dụng có đích web (thư mục web), bản xem trước web chạy tại https://<project>.dev.test và tải lại khi bạn lưu; lần build đầu tiên mất khoảng nửa phút. Trên điện thoại, trình giả lập hoặc trình mô phỏng, nó chạy từ máy tính của bạn: khi bật đồng bộ tệp, hãy mở cùng thư mục dự án trên laptop và chạy flutter run ở đó. Bản build iOS cần một chiếc Mac có Xcode. Một ứng dụng không có đích web được thêm vào mà không có máy chủ dev. Trên máy chủ, flutter pub get, flutter analyze, flutter test và flutter build web hoạt động cho bạn và các agent của bạn. Việc thêm dự án Flutter cần rdev 1.4.3 trở lên; recipe Flutter hoạt động từ 1.4.2.

Cài một phiên bản bằng rdev lang install flutter 3.47; Dart đi kèm, nên dart cũng dùng được. Một dự án chọn phiên bản bằng tệp .fvmrc (theo cách FVM ghi) hoặc tệp .tool-versions; nếu không thì dùng phiên bản được chọn trên bảng điều khiển hoặc mặc định. Mỗi phiên bản chiếm khoảng 1 GB ổ đĩa.

Flutter ghi đường dẫn riêng của máy tính này vào một số tệp được tạo ra (.dart_tool, .flutter-plugins-dependencies, ios/Flutter/Generated.xcconfig, android/local.properties), nên đồng bộ tệp bỏ qua chúng: laptop và máy chủ mỗi bên giữ bản của mình, và flutter pub get tạo lại chúng. Hãy giữ khóa ký Android của bạn (key.properties và keystore) ngoài git.

Gói hệ thống

Thẻ Gói hệ thống cài các nhóm thư viện và công cụ hệ thống chỉ bằng một cú nhấp:

Nhóm Dùng để làm gì
Công cụ build Một trình biên dịch và các header mà phần mở rộng gốc (wheel Python, gem Ruby, addon npm) dùng để build
Client PostgreSQL psql và thư viện mà driver cơ sở dữ liệu liên kết tới
Client MySQL mysql và thư viện mà driver cơ sở dữ liệu liên kết tới
Thư viện hình ảnh Xử lý hình ảnh, như Pillow hoặc sharp
Thư viện canvas Vẽ và kết xuất PDF, như node-canvas
Thư viện XML Phân tích XML, như lxml hoặc Nokogiri
FFmpeg Chuyển đổi video và âm thanh
Chromium Một trình duyệt headless cho kiểm thử trình duyệt và tạo PDF
GitHub CLI Lệnh gh cho GitHub: pull request, issue, bản phát hành và Actions. Đăng nhập một lần bằng gh auth login
Thư viện ICU Dữ liệu Unicode và ngôn ngữ mà .NET cần; tự cài cùng phiên bản .NET đầu tiên

Xóa một nhóm sẽ hỏi trước: các dự án build hoặc chạy dựa trên nó có thể ngừng hoạt động cho đến khi nó được cài đặt lại. Các nhóm đã chọn tự quay lại sau khi rdev cập nhật môi trường. Chromium chạy bên trong container của môi trường, nên hãy khởi động nó với --no-sandbox (Puppeteer: args: ['--no-sandbox']).

Trên máy chủ

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 và dart ưu tiên tệp phiên bản riêng của dự án (.tool-versions, mise.toml, .python-version, .ruby-version, dòng go của go.mod, global.json, .fvmrc), rồi đến phiên bản được chọn cho dự án, rồi đến mặc định; một phiên bản chưa được cài đặt sẽ dừng lại với thông báo yêu cầu bạn cài đặt nó. Các agent dùng cùng các lệnh này, và qua MCP là rdev_lang_list, rdev_lang_install, rdev_lang_project và rdev_system_install (một agent thấy bản build gốc thất bại, như "pg_config not found", sẽ cài đúng nhóm). Các lệnh mà pip install hoặc gem install thêm vào được chạy bằng python -m, một môi trường ảo, bundle exec hoặc gem exec.