ASP.NET Core jako první integroval náhradu tradiční XML konfigurace v .NETu přes App.config a Web.config, kterou jsme používali od… prakticky odjakživa. Moderní konfigurační systém Microsoft.Extensions.Configuration.* je snadno rozšiřitelný a flexibilní. A protože nemá žádnou závislost na ASP.NET Core, lze jej snadno použít v jakékoliv .NET aplikaci! V tomto článku si ukážeme, jak zprovoznit JSON konfiguraci přes appsettings.json v UWP.
Instalace NuGet balíčků
Všechny knihovny pro novou konfiguraci jsou k dispozici na NuGetu. Pro naše potřeby stačí následující dva balíčky:
Verze 3.x těchto balíčků popdoruje .NET Standard 2.0.
Nastavení konfigurace
Abychom měli konfigurační logiku pohromadě, vytvoříme si třídu AppConfig. V jejím konstruktoru potřebujeme nastavit konfigurační pipeline. Protože je JSON soubor dodáván spolu s aplikací, nastavíme výchozí cestu pro vyhledávání na Package.Current.InstalledLocation.Path. Do pipeline pak přidáme appsettings.json:
https://gist.github.com/MartinZikmund/f5e66e49a1532e35b26155c6a9e93587
Nyní do našeho projektu přidáme soubor appsettings.json. Pro ilustraci do něj přidáme jedno ukázkové nastavení:
https://gist.github.com/MartinZikmund/5b42ac35c9a4e5f8cc1ad8eef205ac6b
Důležitá poznámka – ujistěte se, že soubor appsettings.json má svou Build Action nastavenu na Content a Copy to Output Directory na Copy Always, aby byl opravdu nakopírován do výstupu. Změny lze provést v okně Properties po výběru souboru v Solution Exploreru:
Načtení konfiguračních sekcí
Aby bylo načítání silně-typových konfiguračních sekcí jednoduché, připravíme si následující pomocnou metodu:
https://gist.github.com/MartinZikmund/0d2a3c94eeec2b9fa07dc3921bc4ba95
Nyní naši ukázkovou sekci pokryjeme jednoduchou třídou:
https://gist.github.com/MartinZikmund/0b90ab3abd4a87efee41d1194493634b
A vytvoříme vlastnost, kterou konfigurační sekci můžeme přečíst:
https://gist.github.com/MartinZikmund/1915bde780a735d57205fd69c3b338e9
A to je vše! Nyní můžeme snadno použít třídu AppConfig kdekoliv, kde ji potřebujeme:
https://gist.github.com/MartinZikmund/4735c24a7f998cacad79ac43ccde15e7
A je to, naše zpráva z konfigurace je zobrazena!
Pokud používáte nějaký MVVM framework s podporou dependency injection, nejlepším způsobem pro použití konfigurace je extrahovat z naší třídy rozhraní a následně používat jeho singleton instanci namísto jejího manuálního vytváření.
Tip navíc
Skvělým plusem moderní konfigurace je možnost mít více zdrojů konfigurace, například soubor appsettings.production.json , který není uložen v Gitu a který se používá pouze pro Release buildy:
https://gist.github.com/MartinZikmund/9a3d579d297016eee72f44de46bf20c2
Nastavení pipeline by v tomto případě vypadalo takto:
https://gist.github.com/MartinZikmund/b929bf7763007ea221a2ffc8671f66b9
Bohužel, UWP projekty nemohou v tuto chvíli používat nový SDK-styl csproj a Visual Studio má problém tento “podmíněný” soubor správně zobrazovat/skrývat při přepnutí build konfigurace. I tak lze funkci bez problémů používat.
Zdrojový kód
Ukázkový zdrojový kód k tomuto článku je k dispozici na mém GitHubu.
Shrnutí
Je snadné přidat Microsoft.Extensions.Configuration do UWP projektu, či obecně – do kteréhokoliv .NET projektu. Viděli jsme, jak lze použít konfiguraci přes JSON ale díky rozšířitelnosti nic nebrání možnosti použít pro konfiguraci i jiné zdroje.
