Installation

Installation

Télécharger

La dernière préversion est 0.1.0-beta.9 :

• Release GitHub
• Site public — accueil et téléchargements par système.

Windows

Deux formats sont produits :

• Installateur Sapphire3-0.1.0-beta.9-windows-setup.exe — installation par utilisateur dans %LOCALAPPDATA%\Programs\Sapphire 3, sans droit administrateur, avec raccourcis et désinstallation.
• ZIP portable Sapphire3-0.1.0-beta.9-windows.zip — à décompresser dans un dossier accessible en écriture, puis lancer Sapphire3.exe.

Prérequis : Windows 10/11 avec Microsoft Edge WebView2. Node.js n’est pas nécessaire pour exécuter l’application.

Le paquet actuel est non signé : Windows SmartScreen peut afficher un avertissement. La signature Authenticode est préparée dans le dépôt, mais aucun certificat n’est fourni. Voir Distribution.

Linux

• x64 : Sapphire3-0.1.0-beta.9-linux-x64.tar.gz.
• ARM64 : Sapphire3-0.1.0-beta.9-linux-arm64.tar.gz.

Décompressez l’archive, puis lancez ./Sapphire3. WebKitGTK 4.1 et les bibliothèques système de la distribution sont requis. Aucun paquet .deb, .rpm, AppImage ou Flatpak n’est fourni.

macOS

Téléchargez Sapphire3-0.1.0-beta.9-macos-universal.zip et ouvrez Sapphire 3.app. macOS 11 ou ultérieur est requis. Le bundle est non signé et non notarié ; Gatekeeper peut demander une confirmation au premier lancement.

Les paquets Linux et macOS sont compilés depuis l’environnement Windows, mais ne sont pas testés à l’exécution sur leur système cible. Le paquet Windows est le seul validé au lancement pour cette bêta.

Développement

Prérequis : Node.js compatible Vite 8 (22.12+ ou 24+), pnpm 11.5, Windows avec WebView2. La construction du sidecar Discord demande aussi CMake, Zig et Ninja ; Inno Setup 6 ou 7 est requis uniquement pour l’installateur Windows.

pnpm install
pnpm desktop:setup
pnpm dev

desktop:setup télécharge le runtime Neutralinojs épinglé dans bin/ (ignoré par Git). pnpm dev démarre Vite et ouvre la fenêtre native avec rechargement à chaud.

Commandes utiles

Commande	Effet
pnpm dev:web	Frontend seul dans le navigateur, http://127.0.0.1:5173
pnpm test	Tests Node et Python du moteur, du workspace et de la transpilation
pnpm build	Compilation Vite dans dist/
pnpm desktop:start	Build puis lancement natif sans Vite
pnpm dist:win	Paquet portable Windows + ZIP
pnpm dist:installer	ZIP + installateur Inno Setup
pnpm dist:linux	Archives Linux x64 et ARM64
pnpm dist:mac	Bundle macOS universel
pnpm dist:all	ZIP Windows, Linux x64/ARM64 et macOS universel
pnpm docs:ast	Recompile abstract/ARCHITECTURE_AST.pdf

Premier lancement

1. Ouvrir un exemple depuis Examples, ou créer un module par clic droit sur le canvas.
2. Poser une fonction, cocher Entry point si elle doit être exécutée par Run.
3. Utiliser Run pour le Run live par défaut, ou choisir une exécution bornée dans le menu.
4. Enregistrer le workspace via Settings → Save.

Où sont mes données ?

L’application n’impose aucun dossier de projets. Un workspace est un dossier choisi par l’utilisateur, contenant workspace.sp3, images/ et backups/. Les préférences (langue, thème, chemins récents, raccourcis) et la copie de récupération vivent dans le répertoire de données persistant de l’application, jamais dans le dossier d’installation. Voir Fichiers .sp3.