Lacking details for how to use App Settings

[MShekow]

Description

The manual for App settings (this one) contains obvious errors and also lacks instructions on how to actually use app settings. You have internalized your library so much that you no longer realize what other people (who encounter Mobile.BuildTools for the first time) don't yet know ;).

From reading the (incomplete) docs, this is what I've tried to use App settings (without success - no Helper class is generated, and I cannot use it from my code):

1. Create a appsettings.json file in the root of my shared netstandard project (I'm assuming this location, because the sentence here just stops... "The Mobile.BuildTools is smart, we look for the appsettings.json in the p" ... what is a "p"? ;)
2. Create a buildtools.json file in the same project's root (again, assuming...) with some content. The manual sometimes uses "appSettings" and sometimes "projectSecrets" as root key, I'm not sure which one I should use.
3. Add Mobile.BuildTools and Mobile.BuildTools.Configuration nuget packages to my shared project

For testing, my buildtools.json file has this as content (where I am not sure if the AwesomeApp part is an arbitrary string, or if it relates to something in my code base):

{
  "$schema": "https://mobilebuildtools.com/schemas/v2/buildtools.schema.json",
  "appSettings": {
    "AwesomeApp": [
      {
        "properties": [
          {
            "name": "AppCenterAppId",
            "type": "String"
          }
        ]
      }
    ]
  }
}

I reckon I need to create additional files to tell MSBuild to actually generate something.

Disclaimer: I'm rather new to the C# and Xamarin world.

[dansiegel]

You have internalized your library so much that you no longer realize what other people

Your condescending attitude is unacceptable, this is your one and only warning. If it continues you will be banned.

From reading the (incomplete) docs, this is what I've tried to use App settings (without success - no Helper class is generated, and I cannot use it from my code):

Docs is most open source repos tend to be lacking. While I am very much aware that the docs will need some updating and some refinement to be clearer, I can only do so with:

1. Constructive feedback
2. The help of those who are using the library

Keep in mind that the docs are open source and part of this repo. If there is something you've figured out that you think could be clearer, then you have the ability to be proactive and submit a PR to help clarify docs. Also remember that I do this in my spare time.

[MShekow]

I apologize for being condescending. If I would know how to improve the docs, I had done so. But I have not even got a basic example to work, and I've written this ticket while being frustrated about it.

Rephrasing my ticket:
Could anyone who already has successfully been able to generate a App Config class provide a section in the manual that explains how to do it? So far, the manual is mostly written as a reference style (which is hard to understand for beginners). Usage instructions could be in the form of a step-by-step mini tutorial that explains:

• Which files have to be created, and where (in the project's file system tree)
• What to add to .gitignore

[dansiegel]

After installing the Mobile.BuildTools, it should automatically add a buildtools.json configuration file to the solution root (next to the .sln file... this is usually also the root of your git repo.

In order to use the Application Settings, you need to update the buildtools.json adding the name of the project you want the generated class(es) to be in. In the docs we use the project AwesomeApp. What you pasted previously from the docs site is an example of the minimum configuration you need in order to get the class to generate. There are several additional options that will pop up in intellisense some of which are documented, but each of which can assist you to further refine how you want the generation to work.

Currently as of 2.0 this is generated in the MSBuild Intermediate Output Directory (something like {projectDirectory}/obj/netstandard2.0 directory). In the future we will be converting this to a Roslyn based generator which won't write to disk unless you specifically opt into that.

Note that a long standing bug with MSBuild, after you build (it may build successfully) it will not necessarily give you the intellisense that the class is there... you may need to close the project and reopen it in Visual Studio in order to get the intellisense for the generated class.

You can place the values you need in an appsettings.json which should be ignored by source control. In CI you can simply add these values as environment variables.

[MShekow]

Thank you for elaborating on the process. The App Settings class is now generated, yay! The new information you just provided helped me realize the following (which I did not yet understand from reading just the manual):

• The buildtools.json file is being automatically generated, but it can only found in the Visual Studio Files view - it's not shown in the Solution explorer, which is why I missed the file at first (and attempted to create it inside a project, where it didn't have any effect). buildtools.json is backed by a JSON schema that developers should study separately (e.g. in the browser) to understand what the options are and what they mean.
• I need to update the generated buildtools.json, adding the name of the project(!) inside the appSettings block, that I want the generated class(es) to be in. This is not obvious from the schema, which just suggests that appSettings allows additional properties - it might make sense to add a description to properties.appSettings.additionalProperties in the schema file that elaborates on that.

I'll try to make a suggestion (in the form of a PR) on how to improve the docs in the coming days.

[amkuchta]

@MShekow @dansiegel I have a follow on to this - I can see the .g.cs file genertaed in my obj directory... but how do I use it? It does not show up via a standard using call for the namespace that the file resides in...

[dansiegel]

There is a known issue with Code Gen that you need to close and reopen the project for intellisense to pick it up

[amkuchta]

@dansiegel thank you! This library is exactly what I've been looking for!

[maikoly1]

@dansiegel thank you! This library is exactly what I've been looking for!

Still not able to get the .cs file on the project. I can see the .g.cs file genertaed in my obj directory. I have restarted VsStudio serveral. Any help.

[dansiegel]

Still not able to get the .cs file on the project. I can see the .g.cs file genertaed in my obj directory. I have restarted VsStudio serveral. Any help.

Well for starters, I'm not sure what you mean by you cannot get the .cs file on the project. By design you will not see the generated class in the Solution Explorer.

[Phenek]

Yeah I just update to 2.0.2, and I am in the same situation about the doc,
I don't understand how to access secret/appsettings properties inside my code.

I used to have Build.Tools 1.4.0 in my project, and was able to generate secrets.cs file easily. (namespace .Helpers)
But this class seems to not be generated anymore

Can we access properties like in ASP.Net by dependency injection?

 interface Microsoft.Extensions.Configuration.IConfiguration

Also you are using the term "secrets" do you mean the secrets from dotnet, or just our own json file call secrets.json?

dotnet user-secrets

windows  => %APPDATA%\Microsoft\UserSecrets\<user_secrets_id>\secrets.json
Mac      => ~/.microsoft/usersecrets/<user_secrets_id>/secrets.json

I did not find any information inside the doc about migration from 1.4.0 => 2.0.0

Do we need extra configuration for AppCenter?

Hope you can help
I will stay ti 1.2.1 until more informations

[TrueGeek]

I have the same question as @Phenek. Is v2 still compatible with AppCenter like v1 was? I'm happy to help update the docs and write up a migration guide, but I wasn't able to figure out what needs to be done to get it working after updating.

[delaney31]

I'm having the same issue as @Phenek and @TrueGeek. I see the generated AppSettings file but how do I use this in my code?
Thanks for your help.

[delaney31]

I'm having the same issue as @Phenek and @TrueGeek. I see the generated AppSettings file but how do I use this in my code? Thanks for your help.

Ok @dansiegel NVM I figured it out. @Phenek @TrueGeek The Mobile.BuildTools.Configuration and Mobile.BuildTools nugets gets installed in XF and Platform specific projects. This page explains how to init these and use them in code:
https://mobilebuildtools.com/config/app.config/in-code/

@dansiegel Thanks!
Great tool!!

[delaney31]

One issue I'm having now is that my ConfigurationManager is null in my FinishedLaunching method so it's not initializing. Please help.

Thanks
Tim