Solucion de Problemas | vasak-desktop
Problemas Comunes de Setup
Aqui tienes la solucion de de errores comunes durante el setup del proyecto
1
2
3
4
5
|
# Asegúrate de que Rust está en tu PATH
source $HOME/.cargo/env
# Verifica nuevamente
rustc --version
|
Error: “GTK development libraries not found”
1
2
3
4
5
6
7
8
|
# Fedora
sudo dnf install gtk3-devel
# Ubuntu/Debian
sudo apt-get install libgtk-3-dev
# Arch
sudo pacman -S gtk3
|
Error: “D-Bus development libraries not found”
1
2
3
4
5
6
7
8
|
# Fedora
sudo dnf install dbus-devel
# Ubuntu/Debian
sudo apt-get install libdbus-1-dev
# Arch
sudo pacman -S dbus
|
Bun/npm no instala paquetes
1
2
3
4
5
6
|
# Limpia caché
bun pm cache rm --all # Para Bun
npm cache clean --force # Para npm
# Intenta nuevamente
bun install # o npm install
|
Cargo tarda mucho en compilar
Esto es normal la primera vez (puede tomar 10-30 minutos).
1
2
3
4
5
6
7
8
|
# Para compilaciones más rápidas, usa mold si está disponible
# Fedora
sudo dnf install mold
# Configura Cargo para usar mold
# Edita ~/.cargo/config.toml
[build]
rustflags = ["-C", "link-arg=-fuse-ld=mold"]
|
Configuración Recomendada del IDE
Ver
Iniciar Proyecto
en la sección de IDE.
Verificación Final
Ejecuta esto para confirmar que todo está correcto:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
cat << 'EOF' > verify-setup.sh
#!/bin/bash
echo "=== Verificando Setup de Vasak Desktop ==="
echo
echo "✓ Node/Bun:"
bun --version 2>/dev/null || npm --version
echo "✓ Rust:"
rustc --version
echo "✓ Cargo:"
cargo --version
echo "✓ Tauri CLI:"
cargo tauri --version
echo "✓ TypeScript:"
npx tsc --version
echo
echo "=== Verificando compilación ==="
echo "Frontend..."
bun run build --dry-run 2>&1 | grep -q "error" && echo "❌ Error en Frontend" || echo "✓ Frontend OK"
echo "Backend..."
cargo check 2>&1 | grep -q "error" && echo "❌ Error en Backend" || echo "✓ Backend OK"
echo
echo "=== Setup completado ==="
EOF
chmod +x verify-setup.sh
./verify-setup.sh
|
Compilacion
Solucion de errores comunes durante la compilacion del proyecto
Problemas Comunes de Compilación
Error: “linking with cc failed”
1
2
3
4
5
|
# Asegúrate de tener gcc instalado
sudo dnf install gcc # Fedora
sudo apt install build-essential # Ubuntu
# O intenta usar mold (ver sección de optimización)
|
Error: “gtk3-devel not found” o similar
1
2
3
|
# Instala las librerías faltantes (ver Setup del Proyecto)
sudo dnf install gtk3-devel dbus-devel # Fedora
sudo apt install libgtk-3-dev libdbus-1-dev # Ubuntu
|
Error: “Could not find OpenSSL”
1
2
3
4
5
6
7
|
# Instala OpenSSL
sudo dnf install openssl-devel # Fedora
sudo apt install libssl-dev # Ubuntu
# O especifica ubicación
export OPENSSL_DIR=/usr/lib/openssl-1.0
cargo build
|
La compilación toma muy tiempo
1
2
3
4
5
6
|
# Usa compilación paralela (por defecto)
# Pero puedes limitar
cargo build -j 4 # Usar 4 cores en lugar de todos
# O usar compilador más rápido (mold)
# Ver sección de optimización
|
Error: “Binary already exists”
1
2
3
4
5
|
# El binario está en uso, termina los procesos
pkill -f vasak-desktop
# Luego intenta compilar de nuevo
cargo build
|
Problemas Comunes de Dependencias
Error: “Dependency conflict”
1
2
3
4
5
6
7
|
# Frontend - Resuelve conflictos
bun install --latest # Actualiza todo
# Backend
cd src-tauri
cargo update
cargo check
|
Error: “Network timeout downloading package”
1
2
3
4
5
6
7
8
|
# Frontend
bun config set registry https://registry.npmjs.org/
# Backend
cargo install --registry-default
# O especifica timeout
bun install --timeout 300000
|
Paquete no encontrado
1
2
3
4
5
|
# Verifica que existe
npm search nombre-paquete
# Verifica sintaxis en package.json
bun install
|
Compilación falla después de actualizar
1
2
3
4
5
6
7
8
9
|
# Limpia todo y recompila
rm -rf node_modules/ bun.lock src-tauri/target/ Cargo.lock
bun install
cargo check
# Si falla, revierte cambios
git checkout package.json Cargo.toml
bun install
cargo check
|
