Compiler depuis les sources
Prisme est un workspace Rust (le moteur et l’application) avec une interface Angular, assemblés par Tauri. Les mêmes commandes le compilent sous Windows, macOS et Linux ; le paquet Android est produit par la CI du projet.
Ce qu’il vous faut
Section intitulée « Ce qu’il vous faut »Sur tous les systèmes :
- Rust, via rustup. Le dépôt fixe sa version dans
rust-toolchain.toml: rustup installe celle-là tout seul à la première compilation. - Node.js 24 et pnpm, pour l’interface.
- Python 3 : le script d’installation s’en sert pour récupérer la libclang avec laquelle sont générés les bindings des bibliothèques C++.
- La ligne de commande Tauri, version 2 :
cargo install tauri-cli --version "^2", ou lancez-la avecnpx @tauri-apps/cli@2à la place decargo taurici-dessous.
Puis, selon le système :
Windows 10 ou 11, avec les outils de compilation Microsoft C++ que Rust utilise sous Windows. Le SDK ASIO est téléchargé par la compilation elle-même.
macOS 13.3 ou plus récent, avec les outils en ligne de commande de Xcode (xcode-select --install).
Un compilateur C++ et les bibliothèques de la web view, d’ALSA et de JACK. Sous Debian et Ubuntu :
sudo apt install build-essential libwebkit2gtk-4.1-dev libgtk-3-dev libxdo-dev \ libssl-dev libayatana-appindicator3-dev librsvg2-dev libasound2-dev \ libjack-jackd2-dev libudev-devCompiler et lancer
Section intitulée « Compiler et lancer »-
Récupérez le code :
Fenêtre de terminal git clone https://github.com/Shawiizz/prisme.gitcd prisme -
Installez les outils de développement qui ne sont pas des crates Rust :
Fenêtre de terminal scripts\setup-dev.ps1Fenêtre de terminal scripts/setup-dev.shLe script place libclang dans
.tools/libclang, à l’intérieur du dépôt, là où.cargo/config.tomldirige la compilation, puis installe les paquets de l’interface (pnpm installdansfrontend). -
Lancez les tests :
Fenêtre de terminal cargo test --workspace -
Démarrez l’application :
Fenêtre de terminal cd apps/prisme-desktopcargo tauri devTauri démarre le serveur de développement de l’interface (
pnpm startdansfrontend, sur le port 4200), compile l’application et l’ouvre. Une modification de l’interface s’affiche aussitôt ; une modification du code Rust recompile et redémarre l’application.
Démarrer dans un état connu
Section intitulée « Démarrer dans un état connu »Pendant le développement, quelques variables d’environnement démarrent Prisme sans avoir à cliquer :
| Variable | |
|---|---|
PRISME_DECK1 … PRISME_DECK4 |
Un fichier audio à charger sur ce deck au démarrage. |
PRISME_SIMULATE=1 |
Démarrer avec la platine simulée sur le deck 1 : le contrôle vinyle sans platine. |
PRISME_MASTER_GAIN |
Le gain du master au démarrage, par exemple 0.2 pour essayer des choses sans faire de bruit. |
PRISME_DATA_DIR |
Un dossier pour les réglages et la bibliothèque, à la place des vôtres. |
PRISME_MUSIC_DIR |
Un dossier de musique, à la place du vôtre. |
PRISME_FAKE_SPLIT |
Faire comme s’il y avait un second écran sous la fenêtre, son bord haut à autant de pixels plus bas (560, ou 560@0.8 avec son échelle) : pour essayer la disposition sur deux écrans avec un seul. |
Vérifier vos modifications
Section intitulée « Vérifier vos modifications »La CI lance ces commandes sous Windows, Linux et macOS pour chaque pull request ; lancez-les avant de pousser :
cd frontendpnpm exec prettier --check srcpnpm exec ng test --watch=falsepnpm buildcd ..cargo fmt --all --checkcargo clippy --workspace --all-targets -- -D warningscargo test --workspaceModifier les actions de l’interface, ou un profil de contrôleur, modifie aussi des fichiers que les tests comparent : voir Les fichiers à côté des profils.
Produire les paquets
Section intitulée « Produire les paquets »cd apps/prisme-desktopcargo tauri buildLes paquets arrivent dans target/release/bundle :
| Système | Paquet |
|---|---|
| Windows | Un installeur (NSIS), installé pour l’utilisateur courant. |
| Linux | Un .deb et une AppImage. |
| macOS | L’.app et un .dmg. |
Pour une version Mac qui tourne à la fois sur les processeurs Apple et Intel, ajoutez les deux cibles et compilez la version universelle :
rustup target add aarch64-apple-darwin x86_64-apple-darwincargo tauri build --target universal-apple-darwinUne version compilée tourne sur des systèmes aussi anciens que celui sur lequel elle a été produite : c’est pour cela que le projet compile ses paquets Linux sous Ubuntu 22.04.
Sous Linux, Prisme joue via ALSA, ou via JACK (y compris celui de PipeWire) pour la latence la plus basse.
Android et iOS
Section intitulée « Android et iOS »Le paquet Android est produit par le workflow Mobile sur GitHub, pour un tag comme mobile-1.2.3 ou à la demande : un APK signé pour les téléphones ARM 64 bits, joint à une release en brouillon. Pour le produire vous-même, suivez ce workflow (.github/workflows/mobile.yml) : Java 21, le SDK Android et son NDK, la cible Rust aarch64-linux-android, les en-têtes du NDK fournis aux bindings, puis :
cd apps/prisme-desktopcargo tauri android build --apk --target aarch64Un APK de release est signé avec la clé indiquée dans apps/prisme-desktop/gen/android/keystore.properties, qui reste hors du dépôt.
La version iOS est seulement vérifiée : le même workflow la compile et la démarre dans le simulateur d’iPhone. Il n’y a pas de release iOS.
Publier une version
Section intitulée « Publier une version »-
Indiquez la nouvelle version dans le
Cargo.tomldu workspace ([workspace.package] version). -
Poussez un tag avec cette version, par exemple
0.2.0. La CI produit les paquets des trois systèmes et leurs paquets de mise à jour signés, et les joint à une release en brouillon. -
Publiez le brouillon : les copies installées proposent alors la mise à jour.
Le workflow Package, lancé à la demande, produit les mêmes paquets sans les paquets de mise à jour, démarre une fois chaque version et en garde une capture d’écran et les logs : un moyen de voir une version démarrer sur un système que vous n’avez pas sous la main.