Aller au contenu

Installation (FR)

Guide pratique2 min de lecture
Modifier cette page

Ce guide intègre Quoin dans un projet Cargo existant et explique chaque drapeau de fonctionnalité que vous pouvez activer. Quoin supporte Rust 1.88 et plus récent (l’espace de travail déclare rust-version = "1.88").

  • Rust stable 1.88+ (rustup update stable).
  • Pour l’adaptateur GPUI sous Linux : libxkbcommon-dev, libx11-dev, libxcb1-dev, libwayland-dev et libfontconfig1-dev.
  • Les autres adaptateurs (Leptos, Dioxus, Xilem, Floem) n’ont aucune exigence de bibliothèque système au-delà de Rust lui-même.

Activez exactement une fonctionnalité de framework — ce choix sélectionne l’adaptateur compilé dans votre binaire :

Terminal
cargo add quoin --features gpui

C’est équivalent à éditer Cargo.toml :

Cargo.toml
[dependencies]
quoin = { version = "0.1", features = ["gpui"] }

Si vous écrivez une crate de hook ou de store partagée qui doit rester sans framework, dépendez de quoin-core au lieu de quoin. Elle contient les traits et la machinerie portable sans aucun adaptateur compilé :

Cargo.toml
[dependencies]
quoin-core = "0.1"

Les consommateurs de votre crate choisissent alors le framework en activant une fonctionnalité sur leur dépendance quoin et en passant à votre hook n’importe quel contexte qui implémente ReactiveContext.

Fonctionnalité Ce qu’elle active
gpui Adaptateur GPUI + implémentation UCP GPUI + macros ; implique rsx et gpui-rsx-classes
leptos Adaptateur Leptos + macros
dioxus Adaptateur Dioxus + macros
xilem Adaptateur Xilem + macros
floem Adaptateur Floem + macros
macros component!, quoin_render!, effect!, run_app!, quoin_element! sans framework
ui Traits du Universal Component Protocol depuis quoin-ui
rsx Échappatoire gpui-rsx (rsx!, #[component], …) pour les sous-arbres GPUI-seulement
gpui-rsx-classes Moteur Tailwind étendu pour GPUI (palette complète, plus de variantes, class: dynamique)
testkit Ré-exporte quoin-testkit pour les tests sans tête
devtools Ré-exporte quoin-devtools pour le traçage de signaux
leptos-shadcn Support de composant shadcn pour l’émetteur Leptos (nécessite leptos)
dioxus-shadcn Support de composant shadcn pour l’émetteur Dioxus (nécessite dioxus)
floem-shadcn Support de composant shadcn pour l’émetteur Floem (nécessite floem)

La référence complète avec les dépendances entre drapeaux vit dans Drapeaux de fonctionnalité.

Créez un signal et relisez-le dans un test unitaire avec quoin-testkit — pas de fenêtre, pas de navigateur :

tests/integration.rs
use quoin::prelude::*;
use quoin::testkit::{TestContext, ImmediateExecutor};
#[test]
fn signal_round_trip() {
let cx = TestContext::with_executor(ImmediateExecutor);
let count = cx.create_signal(0u32);
count.set(42);
assert_eq!(count.get(), 42);
}
Terminal
cargo test

Sortie attendue : le test passe, confirmant que l’adaptateur a compilé et que le contexte fonctionne.