Configuration des applications Swift : bibliothèque SwiftyConfiguration

Qu'est-ce que SwiftyConfiguration ?

SwiftyConfiguration est une bibliothèque légère pour gérer les configurations d'applications en Swift (iOS/macOS). Elle permet d'externaliser les paramètres (clés API, URLs, variables d'environnement) dans des fichiers séparés et de les charger à l'exécution. Contrairement à UserDefaults ou Info.plist standard, la bibliothèque prend en charge un typage strict, plusieurs environnements (dev/staging/prod) et la génération automatique de code.

Pourquoi en avez-vous besoin ?

Dans les projets réels, la configuration est souvent dispersée dans le code : certains paramètres se trouvent dans Constants.swift, d'autres dans UserDefaults, d'autres encore dans .xcconfig. Cela entraîne de la confusion, des erreurs lors des fusions et des difficultés à prendre en charge différents backends. SwiftyConfiguration résout le problème de la source unique de vérité (single source of truth) pour tous les paramètres de l'application.

Installation

Ajoutez la bibliothèque via Swift Package Manager dans Xcode : File → Add Packages → saisissez l'URL du dépôt. Ou via Package.swift :

dependencies: [    .package(url: "https://github.com/your-repo/SwiftyConfiguration.git", from: "1.0.0")]

Après l'installation, importez le module : import SwiftyConfiguration.

Fonctionnalités principales

• Prise en charge de YAML/JSON/TOML — des configurations dans un format lisible.
• Sécurité des types — désérialisation automatique en structures Swift.
• Environnements — basculement entre dev/staging/prod sans modifier le code.
• Mise à jour en direct — abonnement aux modifications de configuration à l'exécution.
• Mise en cache — mémoïsation pour accélérer l'accès.

Exemple de code

Créez un fichier config.yaml à la racine du projet :

api:  baseUrl: "https://api.example.com"  timeout: 30analytics:  enabled: true  appKey: "abc123"

Définissez le modèle en 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    }}

Chargez la configuration :

let config = try Configuration.load(file: "config", type: .yaml, environment: .development)print(config.api.baseUrl) // "https://api.example.com"

Pour basculer vers la production, modifiez simplement le paramètre environment ou ajoutez un fichier config.prod.yaml.

Quand l'utiliser ?

• Projets avec plusieurs backends (dev/staging/prod).
• Applications où la configuration change sans publication (tests A/B, feature toggles).
• Architecture de microservices en Swift (Vapor, Kitura).
• Développement en équipe — un standard unique pour tous les développeurs.

La bibliothèque est idéale pour les projets iOS et macOS où la propreté du code et la flexibilité de configuration sont importantes. Évitez de l'utiliser pour des applications très simples avec une seule constante — UserDefaults suffit. Mais pour tout ce qui est plus complexe que « Hello World », SwiftyConfiguration vous fera gagner des heures de débogage.