.NET 9 MAUI客户端如何实现Wasm式多环境appsettings.json配置？

要让MAUI客户端实现类似Wasm的多环境配置加载能力，你可以复用.NET的Microsoft.Extensions.Configuration体系，结合环境配置文件、编译符号或动态环境变量来实现，具体步骤如下：

1. 添加环境配置文件 #

在MAUI项目的Resources/Raw目录下创建以下配置文件：

• appsettings.json：默认基础配置，存放所有环境共享的配置项
• appsettings.Development.json：开发环境专属配置
• appsettings.Staging.json：测试环境专属配置
• appsettings.Production.json：生产环境专属配置

注意：将每个配置文件的生成操作设置为MauiAsset，复制到输出目录设置为始终复制，确保文件能被打包到客户端应用中。

2. 集成Configuration系统 #

首先安装Microsoft.Extensions.Configuration.Json NuGet包，然后在MauiProgram.cs中构建配置加载逻辑：

using Microsoft.Extensions.Configuration;

namespace YourMauiAppNamespace;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });

        // 构建配置源
        var configBuilder = new ConfigurationBuilder()
            // 加载默认配置
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
            // 加载对应环境的配置（会覆盖默认配置中的同名项）
            .AddJsonFile($"appsettings.{GetEnvironmentName()}.json", optional: true, reloadOnChange: true);

        // 开发环境加载用户机密（避免提交敏感信息到代码库）
#if DEBUG
        configBuilder.AddUserSecrets<App>();
#endif

        var configuration = configBuilder.Build();
        builder.Configuration.AddConfiguration(configuration);

        // 示例：注册带有基础URL的HttpClient
        builder.Services.AddSingleton(sp =>
        {
            var apiBaseUrl = configuration["ApiSettings:BaseUrl"] 
                ?? throw new InvalidOperationException("API基础URL未配置");
            return new HttpClient { BaseAddress = new Uri(apiBaseUrl) };
        });

        return builder.Build();
    }

    private static string GetEnvironmentName()
    {
        // 优先读取环境变量（支持动态切换）
        var envVar = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT");
        if (!string.IsNullOrWhiteSpace(envVar))
            return envVar;

        // fallback到编译符号（静态环境区分）
#if DEBUG
        return "Development";
#elif STAGING
        return "Staging";
#else
        return "Production";
#endif
    }
}

3. 环境切换方式 #

静态切换（编译时确定） #

在项目属性的生成选项卡中，为不同的构建配置添加条件编译符号：

• Debug配置：保留默认的DEBUG符号，对应开发环境
• 新建Staging配置：添加STAGING符号，对应测试环境
• Release配置：无额外符号，对应生产环境

动态切换（运行时确定） #

针对不同平台，可以通过设置环境变量来动态指定环境：

• Windows：在启动应用前设置环境变量set ASPNETCORE_ENVIRONMENT=Staging
• Android：使用ADB命令设置：adb shell setprop debug.mono.env ASPNETCORE_ENVIRONMENT=Staging，或者在AndroidManifest.xml中添加<meta-data android:name="ASPNETCORE_ENVIRONMENT" android:value="Staging" />
• iOS：在Xcode的Scheme设置中添加环境变量，或修改Info.plist添加ASPNETCORE_ENVIRONMENT键值对

4. 使用配置项 #

在ViewModel或服务中通过依赖注入获取IConfiguration，直接读取配置：

public class HomeViewModel
{
    private readonly IConfiguration _config;

    public HomeViewModel(IConfiguration config)
    {
        _config = config;
        ApiBaseUrl = _config["ApiSettings:BaseUrl"];
    }

    public string ApiBaseUrl { get; }
}

关键注意事项 #

• 配置文件的reloadOnChange在MAUI中仅对Windows平台生效，移动平台需要重启应用才能加载更新后的配置
• 生产环境避免使用用户机密，敏感配置建议通过安全的配置中心或平台原生加密方式存储
• 环境配置文件中的同名项会覆盖默认配置，优先级为：用户机密 > 环境配置文件 > 默认配置文件

内容的提问来源于stack exchange，提问作者Neil W