Instalación

TruckPaint funciona en Windows, macOS y Linux. Está en una fase temprana de desarrollo: aún no hay descargas ni instaladores listos para usar. Están previstos para una próxima versión. Hasta entonces, usted mismo compila la aplicación a partir de su código fuente. Basta con unos pocos comandos, y solo hay que hacerlo una vez por actualización.

Instalar los requisitos previos

Necesita Git para obtener el código fuente y mise, que instala la versión correcta de Rust y ejecuta la compilación por usted. Después, añada lo que su sistema necesita para compilar una aplicación de escritorio:

• Windows: la cadena de herramientas MSVC, de Visual Studio Build Tools con la carga de trabajo de C++.

• macOS: las Xcode Command Line Tools. Ejecute xcode-select --install en un terminal.

• Linux: las bibliotecas de ventanas y gráficos. En Debian o Ubuntu:

  sudo apt-get install libxkbcommon-dev libwayland-dev libx11-dev libxcursor-dev \
    libxrandr-dev libxi-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev \
    libgl1-mesa-dev

  Se admiten tanto sesiones X11 como Wayland.

Compilar TruckPaint

1. Obtenga el código fuente:

   git clone https://github.com/acesyde/truckpaint.git
   cd truckpaint

2. Instale la cadena de herramientas que fija el proyecto (Rust y sus herramientas):

   mise install

3. Compile la aplicación en modo release:

   mise run build

   La primera compilación descarga y compila todas las dependencias, así que tarda un rato. Las siguientes son mucho más rápidas.

4. Iníciela. El ejecutable es truckpaint (truckpaint.exe en Windows), en la carpeta target/release/:

   ./target/release/truckpaint

Puede copiar el ejecutable donde quiera, o crear un acceso directo a él.

Actualizar a una versión más reciente

Ejecute git pull en la carpeta del proyecto y, después, de nuevo mise install y mise run build. Sus preferencias, sus vehículos instalados y sus proyectos se conservan: no están en la carpeta de compilación.

Si la aplicación no se inicia

TruckPaint dibuja su ventana con Vulkan, DirectX 12 o Metal. Con controladores gráficos antiguos o en una máquina virtual, puede detenerse al iniciar con un error del adaptador gráfico. Fuerce otro backend gráfico con la variable WGPU_BACKEND:

WGPU_BACKEND=gl ./target/release/truckpaint      # OpenGL (Linux, Windows)
WGPU_BACKEND=vulkan ./target/release/truckpaint  # Vulkan

En Windows, en PowerShell, defina primero la variable: $env:WGPU_BACKEND="gl", y luego ejecute .\target\release\truckpaint.exe.

En Windows y Linux, si la ventana no se puede mover ni cambiar de tamaño correctamente, abra Preferencias y marque Usar la barra de título del sistema: la ventana usa entonces el marco de su sistema, con los menús en una fila debajo.

TruckPaint escribe un registro de lo que hace, en el terminal y en un archivo diario en su carpeta de datos (logs/). Adjúntelo cuando informe de un problema.

Siguiente paso

TruckPaint ya funciona: recorra la pantalla de inicio.