Composantsmodifier
- Application de bureau : Tauri v2 avec le WebView du système.
- Backend : Rust sur Tokio, avec un workspace de crates internes.
- Interface : Svelte 5 + SvelteKit + TypeScript, compilée en site statique.
Le frontend envoie des commandes au backend via l'IPC de Tauri. Le backend répond avec des événements app-event et des flux de logs ; l'interface les consomme pour mettre à jour les téléchargements, les instances, l'état de lancement et la console.
Crates du workspacemodifier
| Crate | Responsabilité |
|---|---|
aqua | Téléchargement des versions de Minecraft, des loaders et des JRE ; manifestes, assets, bibliothèques et fournisseurs de téléchargement. |
zellkern | Modèles du manifeste, résolution des versions, utilitaires Forge, construction des arguments et LaunchConfig. |
launchwerk | Préparation et lancement du processus Java, extraction des natives et gestion du cycle de vie. |
cubrinth | Installation des modpacks .mrpack et utilitaires associés. |
communicator | Client Discord RPC. |
ablage | Dépôt local avec cache versionné pour les données sérialisées. |
src-tauri | Application Tauri : commandes, services d'instances, paramètres, authentification, file de téléchargements et événements. |
Structure du dépôtmodifier
src/ # Interface, état et services du frontend
src-tauri/ # Application Tauri, commandes et services natifs
src/tests/ # Tests du backend de l'application
src/services/ # Instances, téléchargements, Java, launcher, authentification
crates/ # Bibliothèques internes du workspace Rust
<crate>/src/tests/ # Tests unitaires par crate
tests/frontend/ # Tests du frontend
static/ # Ressources statiques
dist/ # Empaquetage pour les distributions
.github/ # CI et workflows de publicationFlux de lancementmodifier
- L'interface invoque la commande
launch. - Le service
Launcherverrouille les fichiers de l'instance et marque l'état commeStarting. - Les dépendances de version sont vérifiées ; s'il en manque, elles sont mises en file dans
DownloadQueueetVersionNotFoundest renvoyé. aquatélécharge la version, le loader et le JRE selon les besoins.zellkernrésout l'héritage du manifeste (Vanilla → loader) et construit les arguments.- Le jeton du compte est actualisé et
LaunchConfigest assemblé avec la RAM, les arguments JVM, les variables d'environnement, l'authentification et Quick Play. launchwerkextrait les natives et lance le processus Java ; stdout/stderr est envoyé aux logs et à l'interface.- À la fin, l'état revient à
Off. Si le processus se termine avec un code non nul sans avoir été arrêté depuis le launcher, un crash est détecté et un instantané des logs est conservé pendant une heure.
Événements et IPCmodifier
- Les commandes sont exposées depuis
src-tauri/src/commands/. - Les événements sont publiés sur le bus de l'application sous
app-eventet consommés depuis le frontend. - Les téléchargements émettent séparément la progression, la fin et l'erreur.
- La console combine les lignes en direct, l'historique par instance et les instantanés de crash.
Données sur disquemodifier
Par défaut, tout se trouve sous ~/.cubic/ :
instances/<nom>/— données de chaque instance et son fichierinstance.cub.shared/—versions,libraries,assets,nativesetruntimes.settings/settings.cub— paramètres, comptes et préférences.themes/— thèmes installés par l'utilisateur.skins/— vestiaire de skins.
Les chemins instances et shared peuvent être modifiés depuis Paramètres → Stockage. La configuration de ces chemins est stockée dans settings.cub.
Mises à jourmodifier
L'updater de Tauri interroge les points de terminaison du projet selon le canal configuré :
- Stable — releases publiées.
- Pré-version — versions alpha, beta ou rc.
Chaque push sur develop génère des artefacts de CI, mais pas de release publique. La publication suit le flux Versionnement et publications.