Lea esto en otros idiomas: Francés | Alemán | Hindi | Portugués | Ruso | Chino Simplificado | Español
AppState es una biblioteca de Swift 6 para gestionar el estado de la aplicación de una manera segura para hilos, segura para tipos y compatible con SwiftUI. Centralice y sincronice el estado en toda su aplicación; inyecte dependencias en cualquier lugar.
- iOS: 17.0+
- watchOS: 10.0+
- macOS: 14.0+
- tvOS: 17.0+
- visionOS: 1.0+
- Swift: 6.0+
- Xcode: 16.0+
Soporte para plataformas no Apple: Linux y Windows
🍎 Las características marcadas con este símbolo son específicas de las plataformas de Apple, ya que dependen de tecnologías de Apple como iCloud y el Llavero.
AppState incluye:
- State: Gestión centralizada del estado que le permite encapsular y transmitir cambios en toda la aplicación.
- StoredState: Estado persistente utilizando
UserDefaults, ideal para guardar pequeñas cantidades de datos entre lanzamientos de la aplicación. - FileState: Estado persistente almacenado usando
FileManager, útil para almacenar grandes cantidades de datos de forma segura en el disco. - 🍎 SwiftData (ModelState): Gestione objetos
@Modelde SwiftData a través de AppState inyectando unModelContainercompartido y leyendo/escribiendo modelos conModelState. - 🍎 SyncState: Sincronice el estado en múltiples dispositivos usando iCloud, asegurando la coherencia en las preferencias y configuraciones del usuario.
- 🍎 SecureState: Almacene datos sensibles de forma segura usando el Llavero, protegiendo información del usuario como tokens o contraseñas.
- Gestión de Dependencias: Inyecte dependencias como servicios de red o clientes de bases de datos en toda su aplicación para una mejor modularidad y pruebas.
- Slicing: Acceda a partes específicas de un estado o dependencia para un control granular sin necesidad de gestionar todo el estado de la aplicación.
- Constants: Acceda a porciones de solo lectura de su estado cuando necesite valores inmutables.
- Observed Dependencies: Observe las dependencias de
ObservableObjectpara que sus vistas se actualicen cuando cambien.
Agregue AppState mediante Swift Package Manager — consulte la Guía de Instalación. Luego revise la Descripción General del Uso para una introducción rápida.
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 }
}
}
}Aquí hay un desglose detallado de la documentación de AppState:
- Guía de Instalación: Cómo agregar AppState a su proyecto usando Swift Package Manager.
- Descripción General del Uso: Una descripción general de las características clave con implementaciones de ejemplo.
- Gestión de Estado y Dependencias: Centralice el estado e inyecte dependencias en toda su aplicación.
- Slicing de Estado: Acceda y modifique partes específicas del estado.
- Guía de Uso de StoredState: Cómo persistir datos ligeros usando
StoredState. - Guía de Uso de FileState: Aprenda a persistir grandes cantidades de datos de forma segura en el disco.
- 🍎 Guía de Uso de ModelState: Gestione objetos
@Modelde SwiftData a través de unModelContainercompartido. - Uso de SecureState con Llavero: Almacene datos sensibles de forma segura usando el Llavero.
- Sincronización con iCloud usando SyncState: Mantenga el estado sincronizado en todos los dispositivos usando iCloud.
- Actualización a AppState 3.0: Cambios importantes y cómo migrar desde la línea de versiones 2.x.
- Preguntas Frecuentes: Respuestas a preguntas comunes al usar AppState.
- Guía de Uso de Constantes: Acceda a valores de solo lectura de su estado.
- Guía de Uso de ObservedDependency: Trabaje con dependencias de
ObservableObjecten sus vistas. - Uso Avanzado: Técnicas como la creación justo a tiempo y la precarga de dependencias.
- Mejores Prácticas: Consejos para estructurar el estado de su aplicación de manera efectiva.
- Consideraciones sobre la Migración: Orientación al actualizar modelos persistentes.
¡Aceptamos contribuciones! Consulte nuestra Guía de Contribuciones para saber cómo participar.
Comience con la Descripción General del Uso. Para la creación Justo a Tiempo y la precarga, consulte la Guía de Uso Avanzado. Las guías de Constantes y ObservedDependency cubren características adicionales.
Esta traducción fue generada automáticamente y puede contener errores. Si eres un hablante nativo, te agradecemos que contribuyas con correcciones a través de un Pull Request.