{"id":3268,"date":"2023-03-23T08:28:29","date_gmt":"2023-03-23T07:28:29","guid":{"rendered":"https:\/\/blogs.encamina.com\/por-una-nube-sostenible\/?p=3268"},"modified":"2023-03-23T08:28:29","modified_gmt":"2023-03-23T07:28:29","slug":"settings-por-entorno-en-dotnet-maui","status":"publish","type":"post","link":"https:\/\/blogs.encamina.com\/por-una-nube-sostenible\/settings-por-entorno-en-dotnet-maui\/","title":{"rendered":"Settings por entorno en dotNet\u00a0MAUI"},"content":{"rendered":"
\n

\"\"<\/h1>\n<\/header>\n

<\/p>\n

Una de las primeras cosas que siempre hago en mis aplicaciones m\u00f3viles, creadas con dotNet MAUI, es definir los entornos que voy a utilizar (para este ejemplo, desarrollo, preproducci\u00f3n, y producci\u00f3n) y gestionar las configuraciones propias de cada entorno con archivos <\/span>json<\/em>, de una manera an\u00e1loga a como se hace en\u00a0<\/span>asp.net<\/em>.<\/span><\/div>\n
\n

Los pasos que sigo para conseguirlo, son los siguientes.<\/p>\n

<\/span>1. Crear configuraciones de soluci\u00f3n<\/span><\/h3>\n

Desde el editor de configuraci\u00f3n, a\u00f1ado una configuraci\u00f3n por cada entorno, para\u00a0Debug y Release<\/em>, por lo que en el ejemplo, tendr\u00e9 6 configuraciones:\u00a0DebugDevelopment, ReleaseDevelopment, DebugPreproduction, ReleasePreproduction, Debug y Release<\/em>, siendo\u00a0Debug y Release<\/em>\u00a0los que utilizo como configuraciones de producci\u00f3n.<\/p>\n

\n
\"\"<\/figure>\n<\/div>\n
\n
\"\"<\/figure>\n<\/div>\n

<\/span>2. Crear configuraciones en los proyectos<\/span><\/h3>\n

En el ejemplo que estoy creando, solamente tengo un proyecto, pero si tuviese m\u00e1s, habr\u00eda que repetir estos pasos para cada uno de los proyectos, siempre y cuando tengan funcionalidades que dependan del entorno en el que se est\u00e1n ejecutando. Si no es as\u00ed, en esos proyecto no ser\u00eda necesario a\u00f1adir todas las configuraciones, con mantener\u00a0Debug y Release<\/em>, que son las creadas por defecto, ser\u00eda suficiente.<\/p>\n

Este ejemplo lo estoy creando con\u00a0Rider<\/em>, y este IDE crea autom\u00e1ticamente las configuraciones en todos los proyectos al crear las configuraciones de la soluci\u00f3n. No obstante, desde cualquier IDE se pueden crear manualmente, incluso se pueden a\u00f1adir editando el\u00a0.csproj<\/em>\u00a0de cada proyecto, como se mostrar\u00e1 a continuaci\u00f3n.<\/p>\n

Una vez creadas estas configuraciones, el siguiente paso ser\u00eda a\u00f1adir una constante a cada una de las configuraciones. En mi ejemplo, he a\u00f1adido las constantes\u00a0DEVELOPMENT<\/em>\u00a0y\u00a0PREPRODUCTION<\/em>\u00a0a sus respectivas configuraciones. N\u00f3tese que a las configuraciones de producci\u00f3n no les a\u00f1ado ninguna constante.<\/p>\n

El\u00a0.csproj<\/em>\u00a0del proyecto quedar\u00eda de la siguiente manera.<\/p>\n

...\r\n<PropertyGroup>\r\n    ...\r\n    <Configurations>Debug;Release;DebugDevelopment;DebugPreproduction;ReleaseDevelopment;ReleasePreproduction<\/Configurations>\r\n    ...\r\n<\/PropertyGroup>\r\n\r\n<PropertyGroup Condition=\" '$(Configuration)' == 'DebugDevelopment' \">\r\n  <DefineConstants>TRACE;DEVELOPMENT<\/DefineConstants>\r\n<\/PropertyGroup>\r\n\r\n<PropertyGroup Condition=\" '$(Configuration)' == 'DebugPreproduction' \">\r\n  <DefineConstants>TRACE;PREPRODUCTION<\/DefineConstants>\r\n<\/PropertyGroup>\r\n\r\n<PropertyGroup Condition=\" '$(Configuration)' == 'ReleaseDevelopment' \">\r\n  <DefineConstants>TRACE;DEVELOPMENT<\/DefineConstants>\r\n<\/PropertyGroup>\r\n\r\n<PropertyGroup Condition=\" '$(Configuration)' == 'ReleasePreproduction' \">\r\n  <DefineConstants>TRACE;PREPRODUCTION<\/DefineConstants>\r\n<\/PropertyGroup>\r\n...<\/code><\/pre>\n
<\/div>\n
Una vez creadas las configuraciones a nivel de soluci\u00f3n y a nivel de proyecto, queda vincularlas. Tanto en\u00a0Rider<\/em>\u00a0como en\u00a0Visual Studio<\/em>, se puede hacer de una forma sencilla con un editor visual.<\/p>\n
\n
\"\"<\/figure>\n<\/div>\n
\n
\"\"<\/figure>\n<\/div>\n
<\/span>3. Crear json de configuraci\u00f3n<\/span><\/h3>\n
De forma an\u00e1loga a lo que tenemos en\u00a0asp.net<\/em>, me gusta crear un\u00a0json<\/em>\u00a0por cada entorno. Siguiendo con el ejemplo, mi proyecto quedar\u00eda de la manera que se muestra a continuaci\u00f3n.<\/p>\n
\n
\"\"<\/figure>\n<\/div>\n
Adem\u00e1s, para poder acceder a estos\u00a0json<\/em>\u00a0en tiempo de ejecuci\u00f3n, es importante que modifiquemos las propiedades de estos archivos para que sus\u00a0build<\/em>\u00a0actions<\/em>\u00a0sean\u00a0EmbeddedResource<\/em>\u00a0y sus\u00a0copy to output directory<\/em>\u00a0sean\u00a0Copy if newer<\/em>.<\/p>\n
\n
\"\"<\/figure>\n<\/div>\n
<\/span>4. A\u00f1adir informaci\u00f3n de los json a la configuraci\u00f3n del proyecto<\/span><\/h3>\n
Desde la llegada de\u00a0dotNet MAUI<\/em>, podemos disfrutar del\u00a0MauiAppBuilder<\/em>, en el que definir fuentes, servicios y configuraciones, entre otros\u2026 Lo que vamos a conseguir con este paso, es a\u00f1adir al\u00a0Configuration<\/em>\u00a0de este\u00a0builder<\/em>, la informaci\u00f3n del\u00a0json<\/em>\u00a0a\u00f1adido en el paso anterior, dependiendo del entorno que estemos ejecutando. Para conseguirlo, a\u00f1adimos la siguiente funcionalidad a la clase\u00a0MauiProgram<\/em><\/p>\n
public static class MauiProgram\r\n{\r\n    public static MauiApp CreateMauiApp()\r\n    {\r\n        var builder = MauiApp.CreateBuilder();\r\n        builder\r\n            .UseMauiApp<App>()\r\n            .AddCustomConfiguration()\r\n            ...\r\n\r\n        return builder.Build();\r\n    }\r\n\r\n    private static MauiAppBuilder AddCustomConfiguration(this MauiAppBuilder builder)\r\n    {\r\n        var executingAssembly = Assembly.GetExecutingAssembly();\r\n        using var stream = executingAssembly.GetManifestResourceStream(GetEnvironmentSettings());\r\n        var configuration = new ConfigurationBuilder()\r\n            .AddJsonStream(stream)\r\n            .Build();\r\n        \r\n        builder.Configuration.AddConfiguration(configuration);\r\n        return builder;\r\n    }\r\n\r\n    private static string GetEnvironmentSettings()\r\n    {\r\n#if DEVELOPMENT\r\n        return \"MauiSettings.Settings.appsettings.Development.json\";\r\n#elif PREPRODUCTION\r\n        return \"MauiSettings.Settings.appsettings.Preproduction.json\";\r\n#else\r\n        return \"MauiSettings.Settings.appsettings.json\";\r\n#endif\r\n    }\r\n}<\/code><\/pre>\n
Es importante destacar que, para a\u00f1adir la funcionalidad anterior, tenemos que a\u00f1adir los siguientes paquetes\u00a0nugets<\/em>\u00a0a nuestro proyecto.<\/p>\n