gsd_utilities library

Classes

DOCUframeAccount
Repräsentiert eine DOCUframe-Konto-Konfiguration mit Verbindungsdetails. Behandelt Kontoinformationen, Datenbankeinstellungen und Änderungsbenachrichtigungen.
DOCUframeUploadManager
GSDBaseConfig
Abstrakte Basisklasse für Konfigurationsverwaltung. Stellt die Grundlage für die Implementierung von Konfigurationsklassen bereit, die zu/von JSON serialisiert werden können und in anderen Projekten erweitert werden können.
GSDBaseLocalStorageManager
Abstrakte Basis-Klasse für LocalStorage-Manager-Implementierungen
GSDBaseNotificationsHelper
Abstrakte Basis-Klasse für NotificationsHelper-Implementierungen Definiert die Schnittstelle für Benachrichtigungsfunktionen und Browser-Erkennung
GSDBaseUriManager
Abstrakte Basis-Klasse für UriManager-Implementierungen
GSDConfig
Wurzel einer Konfiguration. Apps leiten davon ab und deklarieren Felder und Collections:
GSDConfigAppLegacySource
Liest die JSON-Blöcke des bisherigen GSDConfigManager auf Mobile und Desktop: öffentlich aus SharedPreferences unter key (bis 0.0.34 aus dem Secure Storage unter key), Secrets aus dem Secure Storage unter <key>_secure.
GSDConfigChangedEventArgs
Event-Argumente für Konfigurationsänderungs-Benachrichtigungen. Wird verwendet, wenn Konfigurationsdaten geändert werden und persistiert werden müssen.
GSDConfigCodec<T extends Object>
Wandelt einen Feldwert in den gespeicherten String und zurück.
GSDConfigCollection<T extends GSDConfigItem>
Geordnete Liste von GSDConfigItems, z.B. Accounts.
GSDConfigField<T extends Object>
Ein einzelnes Konfigurationsfeld, das unter genau einem Key gespeichert wird.
GSDConfigFileLock
Prozessübergreifender Lock über RandomAccessFile.lock (Windows: LockFileEx, POSIX: fcntl).
GSDConfigInProcessLock
Lock, der nur innerhalb eines Prozesses serialisiert.
GSDConfigItem
Ein Eintrag einer GSDConfigCollection, z.B. ein Account. Deklariert seine Felder wie eine GSDConfig; die Keys tragen Collection-Name und id.
GSDConfigKeyValueStore
Gemeinsame Form von GSDConfigValueStore und GSDConfigSecretStore.
GSDConfigLegacyData
Die alten JSON-Blöcke des GSDConfigManager, wie sie dem Migrations-Hook übergeben werden.
GSDConfigLegacySource
Liefert die alten JSON-Blöcke des bisherigen GSDConfigManager für die einmalige Migration.
GSDConfigLoadResult
Ergebnis von GSDConfigStore.load und GSDConfigStore.reload.
GSDConfigLock
Prozessübergreifender, exklusiver Lock pro Namespace.
GSDConfigLockHandle
Ein gehaltener Lock. release gibt ihn frei; ein Prozess-Ende gibt ihn bei den Plattform-Implementierungen automatisch frei.
GSDConfigManager
Abstrakte Basisklasse für Konfigurationsverwaltung auf verschiedenen Plattformen. Wählt automatisch die entsprechende Implementierung basierend auf der aktuellen Plattform aus:
GSDConfigMemorySecretStore
GSDConfigMemoryStore
Gemeinsame In-Memory-Implementierung für Wert- und Secret-Store.
GSDConfigMemoryValueStore
GSDConfigNode
Gemeinsame Basis von GSDConfig (Wurzel) und GSDConfigItem (Eintrag einer GSDConfigCollection). Hält die deklarierten Felder.
GSDConfigOptionalValue<T extends Object>
Feld ohne Default: value ist null, solange nichts gespeichert ist.
GSDConfigPrefsValueStore
Öffentliche Werte in SharedPreferencesAsync (alle Plattformen außer Web).
GSDConfigResult<T extends GSDBaseConfig>
Ergebnis-Container für Konfigurationslade-Operationen. Stellt umfassende Informationen über Erfolg oder Fehlschlag von Konfigurationsoperationen bereit.
GSDConfigSecretStore
Speicher für sensible Werte (Keychain, DPAPI, WebCrypto). Gleiche Form wie GSDConfigValueStore, aber ein eigener Typ, damit beide nicht vertauscht werden können.
GSDConfigSecureStorageSecretStore
Sensible Werte in FlutterSecureStorage (Keychain, Keystore, libsecret, unter Windows DPAPI pro Eintrag in SQLite, auf Web WebCrypto AES-GCM im localStorage).
GSDConfigStore
Lädt und schreibt eine GSDConfig Feld für Feld.
GSDConfigStoreChangedEventArgs
Argument von GSDConfig.changed: welcher Key geschrieben wurde.
GSDConfigStoreFactory
Baut den GSDConfigStore mit den Backends der aktuellen Plattform.
GSDConfigValue<T extends Object>
Feld mit Pflicht-Default: value ist nie null.
GSDConfigValueStore
Speicher für öffentliche Werte (SharedPreferences, localStorage).
GSDConfigWebLegacySource
Liest die AES-verschlüsselten Blöcke des bisherigen Web-Managers aus dem localStorage unter key und <key>_secure. Einzige Stelle im ConfigStore, die den EncryptionManager noch braucht.
GSDConfigWebValueStore
Öffentliche Werte im Browser-localStorage, im Klartext.
GSDDpapiSecretCipher
Windows DPAPI (CryptProtectData) im Benutzerkontext: nur derselbe Windows-Benutzer auf demselben Rechner kann entschlüsseln. Dasselbe Verfahren wie flutter_secure_storage_windows, aber pro Eintrag statt für eine Datei mit allen Einträgen.
GSDLanguage
Repräsentiert eine Sprache mit ihren Metadaten
GSDLocalStorageManager
Plattformübergreifender LocalStorage-Manager, der automatisch die entsprechende Implementierung auswählt. Stellt eine einheitliche Schnittstelle für Web- und Mobile/Desktop-LocalStorage-Operationen bereit.
GSDMultiLanguageProvider
Multi-Sprachen Provider mit Dependency Injection Unterstützung
GSDNotificationsHelper
Plattformübergreifender NotificationsHelper, der automatisch die entsprechende Implementierung auswählt. Stellt eine einheitliche Schnittstelle für Web- und Mobile/Desktop-Benachrichtigungsoperationen bereit.
GSDSecretCipher
Ver- und Entschlüsselt einzelne Secrets für GSDSqliteSecretStorage.
GSDSqlitePreferencesStorage
Key-Value-Tabelle in einer SQLite-Datei, typisiert wie SharedPreferencesAsync (String, bool, int, double, List<String>).
GSDSqliteSecretStorage
Secrets in einer SQLite-Datei, jeder Wert einzeln per GSDSecretCipher verschlüsselt (Default DPAPI).
GSDSqliteSecureStoragePlatform
SQLite-Backend für flutter_secure_storage (Windows).
GSDSqliteSharedPreferencesPlatform
SQLite-Backend für SharedPreferencesAsync (Windows, macOS, Linux).
GSDUploadFile
Repräsentiert eine für den Upload vorbereitete Datei mit Metadaten und Plattformkompatibilität. Unterstützt sowohl lokale Dateien (Mobile/Desktop) als auch Web-Dateien (Browser-Uploads). Stellt Bildverarbeitungsfunktionen und Fortschrittsverfolgung bereit.
GSDUploadFileProgress
Fortschrittsverfolgung für einzelne Datei-Uploads. Stellt Echtzeit-Informationen über Upload-Status und Byte-Transfer-Fortschritt bereit.
GSDUploadFileResult
Ergebnis-Container für einzelne Datei-Upload-Operationen. Enthält den Upload-Status, Fehlerinformationen und Server-Antwortdaten.
GSDUploadImageResolution
Konfiguration der Bildauflösung für Upload-Optimierung. Definiert den Prozentsatz der ursprünglichen Bildgröße für die Komprimierung.
GSDUploadProgress
Gesamtfortschrittsverfolgung für mehrere Datei-Uploads. Aggregiert Fortschrittsinformationen von einzelnen Datei-Uploads.
GSDUploadResult
Gesamtergebnis für Multi-Datei-Upload-Operationen. Aggregiert die Ergebnisse aller einzelnen Datei-Uploads.
GSDUriManager
Plattformübergreifender UriManager, der automatisch die entsprechende Implementierung auswählt. Stellt eine einheitliche Schnittstelle für Web- und Mobile/Desktop-URI-Operationen bereit.
GSDWebLocalStorageEventArgs
Event-Argumente für Web-localStorage-Änderungs-Benachrichtigungen. Wird ausgelöst, wenn localStorage von anderen Tabs oder Fenstern geändert wird. Nur auf Web-Plattformen verfügbar.
IGSDMultiLanguageAnalyticsProvider
Abstrakte Schnittstelle für Analytics/Logging
IGSDMultiLanguageConfigProvider
Abstrakte Schnittstelle für Konfigurations-Persistierung
IGSDMultiLanguageDataProvider
Abstrakte Schnittstelle für Sprachdaten-Speicher

Enums

GSDUploadFileStatus
Aufzählung der möglichen Upload-Datei-Status. Repräsentiert den aktuellen Zustand einer einzelnen Datei-Upload-Operation.

Extensions

GSDMultiLanguageContext on BuildContext
GSDUint8ListExtention on Uint8List
Extension-Methoden für Uint8List zur Hinzufügung von Bilderkennungsfunktionen. Stellt Hilfsfunktionen für die Arbeit mit Binärdaten und Bildformaten bereit.
IntExtensions on int
StringExtensions on String

Typedefs

GSDConfigLegacyMapper<C extends GSDConfig> = FutureOr<void> Function(C config, GSDConfigLegacyData legacy)
App-Hook der Migration: überträgt legacy in die Felder von config.

Exceptions / Errors

GSDConfigStoreException
Mehrere Fehler aus einem Vorgang, z.B. nicht löschbare Keys beim Entfernen eines Items.
GSDSecretUnreadableException
Ein Secret, das vorhanden ist, aber nicht entschlüsselt werden kann.