Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

feat: comprobar prerequisitos de toolchain antes de app:dev

Đang mở
  • Có gì không ổn?
#89 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
55/100
Loại issue
Tính năng
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
node.js, rust, tauri, typescript
Lĩnh vực
build-system, developer-experience

Hướng nghiên cứu

Start by reading package.json to see how app:dev and app:build are defined, then review the documented Tauri prerequisites in README.md, README.es.md, and CONTRIBUTING.md. Implement the proposed checks in scripts/preflight.mjs for Windows and wire them into both commands. Done means each missing prerequisite produces a nonzero exit with an actionable message and installation links.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Pre-flight checks
  • Busqué en las issues existentes (estado all) y no encontré duplicados.
  • Entiendo que esta propuesta requiere revisión de producto antes de implementarse.
Problem to solve

Un clon fresco en Windows sin toolchain de Rust hace fallar npm run app:dev con un error crudo del CLI de Tauri:

failed to run 'cargo metadata' command to get workspace directory:
failed to run command cargo metadata --no-deps --format-version 1: program not found

Los prerequisitos están documentados (README.md, README.es.md, CONTRIBUTING.md, todos con link a los prereqs de Tauri), pero nada los verifica antes de correr el comando. El error nunca menciona Rust ni el link de instalación, así que un contribuidor nuevo queda en un dead-end diagnosticando un problema de entorno solo.

Proposed solution

Un preflight liviano y sin dependencias (scripts/preflight.mjs) enganchado a app:dev/app:build que verifique en Windows:

  • Node >= 22
  • cargo y rustc resolvibles en PATH (toolchain stable-msvc)
  • MSVC linker / VS Build Tools presentes
  • WebView2 runtime disponible

Si falta algo: exit non-zero con un mensaje accionable por pieza, con los links de instalación (https://v2.tauri.app/start/prerequisites/ y https://rustup.rs).

Affected area

Build or tooling

Scope and non-goals
  • Scope: solo detectar y reportar; envolver app:dev y app:build.
  • Non-goals: auto-instalar Rust/VS Build Tools, modificar el PATH del usuario, cubrir CI (ya instala su propia toolchain) ni detección macOS/Linux (el target actual es Windows).
Alternatives considered
  • Solo docs: ya está documentado en 3 lugares; quien se los salta igual muere en el mismo error críptico.
  • Detectar tras el fallo del CLI de Tauri: string-matching frágil contra salida upstream, en vez de verificar los prerequisitos directo.
  • engines en package.json: npm solo advierte por defecto y no puede expresar cargo/MSVC/WebView2.
Ngôn ngữ chính
TypeScript
Star
10
Fork
2
Merge trung bình
16 phút
Pull request đã merge (30 ngày)
51

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của egdev6/quorb

Tất cả issue của egdev6/quorb

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.