AppState

June 11, 2026 · View on GitHub

macOS Build Ubuntu Build Windows Build License Version

AppState est une bibliothèque Swift 6 pour gérer l'état de l'application de manière thread-safe, type-safe et compatible avec SwiftUI. Centralisez et synchronisez l'état à travers votre application ; injectez des dépendances n'importe où.

Exigences

  • iOS: 17.0+
  • watchOS: 10.0+
  • macOS: 14.0+
  • tvOS: 17.0+
  • visionOS: 1.0+
  • Swift: 6.0+
  • Xcode: 16.0+

Prise en charge des plates-formes non-Apple: Linux et Windows

🍎 Les fonctionnalités marquées de ce symbole sont spécifiques aux plates-formes Apple, car elles reposent sur des technologies Apple telles qu'iCloud et le Trousseau.

Fonctionnalités Clés

AppState inclut plusieurs fonctionnalités puissantes pour aider à gérer l'état et les dépendances :

  • State: Gestion centralisée de l'état qui vous permet d'encapsuler et de diffuser les changements à travers l'application.
  • StoredState: État persistant utilisant UserDefaults, idéal pour sauvegarder de petites quantités de données entre les lancements de l'application.
  • FileState: État persistant stocké à l'aide de FileManager, utile pour stocker de plus grandes quantités de données en toute sécurité sur le disque.
  • 🍎 SwiftData (ModelState): Gérez les objets SwiftData @Model à travers AppState en injectant un ModelContainer partagé et en lisant/écrivant les modèles avec ModelState.
  • 🍎 SyncState: Synchronisez l'état sur plusieurs appareils à l'aide d'iCloud, garantissant la cohérence des préférences et des paramètres de l'utilisateur.
  • 🍎 SecureState: Stockez les données sensibles en toute sécurité à l'aide du Trousseau, protégeant les informations de l'utilisateur telles que les jetons ou les mots de passe.
  • Gestion des Dépendances: Injectez des dépendances comme des services réseau ou des clients de base de données à travers votre application pour une meilleure modularité et des tests facilités.
  • Slicing: Accédez à des parties spécifiques d'un état ou d'une dépendance pour un contrôle granulaire sans avoir à gérer l'état complet de l'application.
  • Constants: Accédez à des tranches en lecture seule de votre état lorsque vous avez besoin de valeurs immuables.
  • Observed Dependencies: Observez les dépendances ObservableObject pour que vos vues se mettent à jour lorsqu'elles changent.

Pour Commencer

Ajoutez AppState via le Swift Package Manager — consultez le Guide d'Installation. Consultez ensuite l'Aperçu de l'Utilisation pour une introduction rapide.

Exemple Rapide

import AppState
import SwiftUI

private extension Application {
    var counter: State<Int> {
        state(initial: 0)
    }
}

struct ContentView: View {
    @AppState(\.counter) var counter: Int

    var body: some View {
        VStack {
            Text("Count: \(counter)")
            Button("Increment") { counter += 1 }
        }
    }
}

Documentation

Voici une ventilation détaillée de la documentation de AppState :

Guides d'Utilisation Détaillés :

Contributions

Nous accueillons les contributions ! Veuillez consulter notre Guide de Contribution pour savoir comment vous impliquer.

Prochaines Étapes

Une fois AppState installé, vous pouvez commencer à explorer ses fonctionnalités clés en consultant l'Aperçu de l'Utilisation et des guides plus détaillés. Commencez à gérer efficacement l'état et les dépendances dans vos projets Swift ! Pour des techniques d'utilisation plus avancées, comme la création Juste-à-Temps et le préchargement des dépendances, consultez le Guide d'Utilisation Avancée. Vous pouvez également consulter les guides Constant et ObservedDependency pour des fonctionnalités supplémentaires.

Cette traduction a été générée automatiquement et peut contenir des erreurs. Si vous êtes un locuteur natif, nous vous serions reconnaissants de contribuer avec des corrections via une Pull Request.