MakoIoT.Device.Services.Configuration 1.0.59.12833

Mako-IoT.Device.Services.Configuration

Provides easy way of reading and updating configuration settings with strongly-typed objects. Settings are stored in persistent storage via IStorageService.

Usage

Create class for your settings. You may use multiple classes, one for every component. Provide section name as static/const string.

public class MyAppConfig
{
    public string ApiUrl { get; set; }
    public string SslCertificate { get; set; }
    public string Timezone { get; set; }
    public static string SectionName => "MyAppConfig";
}

Use IConfigurationService to read and/or update settings.

public class MyAppService : IMyAppService
{
    private readonly MyAppConfig _config;

    public MyAppService(IConfigurationService configService)
    {
        _config = (MyAppService)configService.GetConfigSection(MyAppService.SectionName, typeof(MyAppService));
    }
//[...]
}

Add Configuration and FileStorage components in your device builder. You can specify default settings, which will be written on startup.

public class Program
{
    public static void Main()
    {
        DeviceBuilder.Create()
          .AddConfiguration(c =>
          {
              c.WriteDefault(MyAppConfig.SectionName, new MyAppConfig
              {
                  ApiUrl = "http://my-app.my-company.com/api"
              });
          })
          .AddFileStorage()
          .Build()
          .Start();

        Thread.Sleep(Timeout.InfiniteTimeSpan);
    }
}

Note: setting overwrite = true in the WriteDefault will overwrite settings with the defaults every time (even if settings already exist).