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").
Prérequis
Section intitulée « Prérequis »- Rust stable 1.88+ (
rustup update stable). - Pour l’adaptateur GPUI sous Linux :
libxkbcommon-dev,libx11-dev,libxcb1-dev,libwayland-devetlibfontconfig1-dev. - Les autres adaptateurs (Leptos, Dioxus, Xilem, Floem) n’ont aucune exigence de bibliothèque système au-delà de Rust lui-même.
Ajouter la dépendance
Section intitulée « Ajouter la dépendance »Activez exactement une fonctionnalité de framework — ce choix sélectionne l’adaptateur compilé dans votre binaire :
cargo add quoin --features gpuicargo add quoin --features leptoscargo add quoin --features dioxuscargo add quoin --features xilemcargo add quoin --features floemC’est équivalent à éditer Cargo.toml :
[dependencies]quoin = { version = "0.1", features = ["gpui"] }Dépendances pour bibliothèque seule
Section intitulée « Dépendances pour bibliothèque seule »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é :
[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.
Matrice des drapeaux de fonctionnalité
Section intitulée « Matrice des drapeaux de fonctionnalité »| 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é.
Vérifier l’installation
Section intitulée « Vérifier l’installation »Créez un signal et relisez-le dans un test unitaire avec quoin-testkit — pas de fenêtre, pas de navigateur :
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);}cargo testSortie attendue : le test passe, confirmant que l’adaptateur a compilé et que le contexte fonctionne.
Étapes suivantes
Section intitulée « Étapes suivantes »-
Construire un compteur inter-frameworksLe tutoriel du chemin doré de zéro à une application en cours d'exécution.
-
Référence des drapeaux de fonctionnalitéChaque drapeau, ses dépendances et quand l'activer.
