DE
RU
EN
ES
ZH
FR
PT
AR
HI
Was ist SwiftyConfiguration?
SwiftyConfiguration ist eine leichtgewichtige Bibliothek zur Verwaltung von App-Konfigurationen in Swift (iOS/macOS). Sie ermöglicht es, Einstellungen (API-Schlüssel, URLs, Umgebungsparameter) in separate Dateien auszulagern und zur Laufzeit zu laden. Im Gegensatz zu standardmäßigem UserDefaults oder Info.plist unterstützt die Bibliothek strenge Typisierung, mehrere Umgebungen (dev/staging/prod) und automatische Codegenerierung.
Wozu wird das benötigt?
In realen Projekten ist die Konfiguration oft über den Code verteilt: Manche Parameter liegen in Constants.swift, andere in UserDefaults, wieder andere in .xcconfig. Dies führt zu Verwirrung, Fehlern beim Mergen und Schwierigkeiten bei der Unterstützung verschiedener Backends. SwiftyConfiguration löst das Problem einer einzigen Quelle der Wahrheit (single source of truth) für alle App-Einstellungen.
Installation
Fügen Sie die Bibliothek über den Swift Package Manager in Xcode hinzu: File → Add Packages → geben Sie die Repository-URL ein. Oder über Package.swift:
dependencies: [ .package(url: "https://github.com/your-repo/SwiftyConfiguration.git", from: "1.0.0")]Nach der Installation importieren Sie das Modul: import SwiftyConfiguration.
Hauptfunktionen
- Unterstützung für YAML/JSON/TOML — Konfigurationen in lesbarem Format.
- Typsicherheit — automatische Deserialisierung in Swift-Strukturen.
- Umgebungen — Wechsel zwischen dev/staging/prod ohne Codeänderung.
- Live-Update — Abonnement von Konfigurationsänderungen zur Laufzeit.
- Caching — Memoisierung zur Beschleunigung des Zugriffs.
Codebeispiel
Erstellen Sie eine Datei config.yaml im Projektstammverzeichnis:
api: baseUrl: "https://api.example.com" timeout: 30analytics: enabled: true appKey: "abc123"Definieren Sie das Modell in Swift:
import SwiftyConfiguration
struct AppConfig: Codable { let api: API let analytics: Analytics
struct API: Codable { let baseUrl: String let timeout: Int }
struct Analytics: Codable { let enabled: Bool let appKey: String }}Laden Sie die Konfiguration:
let config = try Configuration.load(file: "config", type: .yaml, environment: .development)print(config.api.baseUrl) // "https://api.example.com" Zum Wechseln auf production ändern Sie einfach den Parameter environment oder fügen eine Datei config.prod.yaml hinzu.
Wann verwenden?
- Projekte mit mehreren Backends (dev/staging/prod).
- Apps, bei denen sich die Konfiguration ohne Release ändert (A/B-Tests, feature toggles).
- Microservice-Architektur in Swift (Vapor, Kitura).
- Team-Entwicklung — einheitlicher Standard für alle Entwickler.
Die Bibliothek eignet sich ideal für iOS- und macOS-Projekte, bei denen Code-Sauberkeit und Konfigurationsflexibilität wichtig sind. Vermeiden Sie die Verwendung für extrem einfache Apps mit einer einzigen Konstante – dort reicht UserDefaults aus. Aber für alles, was komplexer als „Hello World“ ist, spart SwiftyConfiguration Stunden beim Debuggen.
