Compilar RustMusic desde el código fuente

Las herramientas necesarias

RustMusic combina un núcleo en Rust (motor de audio, decodificadores, servidor DLNA, base SQLite) y una interfaz SvelteKit, unidos por Tauri 2. En los tres sistemas necesitas:

• Rust, en versión estable, instalado con rustup (rustup.rs).
• Node.js 20 o más reciente, con npm.
• CMake, que sirve para compilar libopus para la reproducción de archivos Opus.
• Git, para obtener el código.

Las dependencias de cada sistema

Windows: instala las Microsoft C++ Build Tools con la carga de trabajo «Desarrollo para el escritorio con C++» y después CMake. También necesitas WebView2, que ya viene incluido en Windows 10 y 11 actualizados.

macOS: instala las herramientas de línea de comandos de Xcode y después CMake, por ejemplo con Homebrew:

xcode-select --install
brew install cmake

Linux (Debian, Ubuntu): instala las herramientas de compilación y las bibliotecas de desarrollo de WebKitGTK, GTK, ALSA y PulseAudio:

sudo apt install -y \
  build-essential curl wget file git pkg-config cmake libssl-dev \
  libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev libxdo-dev \
  libwebkit2gtk-4.1-dev libsoup-3.0-dev libjavascriptcoregtk-4.1-dev patchelf \
  libasound2-dev libpulse-dev libdbus-1-dev

Obtener el código y compilar

git clone https://github.com/larevuegeek/rustmusic-desktop.git
cd rustmusic-desktop
npm install

La configuración oficial también firma los archivos de actualización con la clave privada del proyecto, que tú no tienes. Desactiva este paso con un pequeño archivo de configuración en la raíz del proyecto, llamado por ejemplo no-updater.json:

{ "bundle": { "createUpdaterArtifacts": false } }

Después lanza la compilación pasándole ese archivo:

npm run tauri build -- --config no-updater.json

La primera compilación tarda bastante: Cargo descarga y compila todas las dependencias de Rust. Las siguientes solo recompilan lo que ha cambiado. Los paquetes para tu sistema se generan en src-tauri/target/release/bundle/.

El modo desarrollo

npm run tauri dev

Este comando lanza RustMusic en modo desarrollo: un cambio en la interfaz se muestra al instante, y un cambio en el código Rust recompila y reinicia la aplicación. No necesita clave de firma.

Para orientarte en el código:

• src/: la interfaz (componentes, páginas, servicios), con las traducciones en src/lib/i18n/locales.
• src-tauri/src/core: el motor de audio, los decodificadores, el DSD y el DLNA.
• src-tauri/src/commands: los comandos que llama la interfaz.
• src-tauri/src/repository: el acceso a la base SQLite.

Proponer tu cambio

1. 1

   Abre un issue

   Para una función nueva o un cambio grande, descríbelo primero en un issue de GitHub. Las correcciones pequeñas (error, errata, traducción) pueden ir directamente en una pull request.

2. 2

   Trabaja en tu copia

   Crea una copia (fork) del repositorio en GitHub y después una rama para tu cambio.

3. 3

   Comprueba tu código

   En la parte de Rust, pasa cargo fmt y cargo clippy sin avisos nuevos; cargo check debe terminar sin errores. Todo texto visible pasa por las traducciones y debe existir en los cinco idiomas.

4. 4

   Abre la pull request

   Explica qué cambia la modificación y por qué. Los mensajes de commit en francés son bienvenidos.