MAUI应用多环境配置最佳方案：一次打包适配多部署环境

一、创建分层配置文件 #

在项目根目录添加以下配置文件，确保所有文件的生成操作设置为MauiAsset（会被打包进应用）：

• appsettings.json：存放所有环境共用的基础配置（如通用API前缀、基础UI设置）
• appsettings.Development.json：开发机器/内部测试环境配置（如测试API地址、调试日志开关）
• appsettings.Staging.json：预发布（UAT）环境配置（如预发布API地址、灰度功能开关）
• appsettings.Production.json：生产环境配置（如正式API地址、日志禁用）

二、实现配置加载逻辑 #

修改App.xaml.cs的CreateMauiApp方法，实现基于环境的配置合并：

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: false);

    // 根据当前环境加载对应配置文件
    var environment = GetCurrentEnvironment();
    configBuilder.AddJsonFile($"appsettings.{environment}.json", optional: true, reloadOnChange: false);

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

    // 注册配置供全局使用
    builder.Services.AddSingleton(config);

    return builder.Build();
}

三、运行时环境判断核心实现 #

针对Android和iOS平台分别实现环境判断逻辑，匹配你需要的渠道-环境映射：

Android平台（Platforms/Android/MainActivity.cs） #

public static string GetCurrentEnvironment()
{
    var packageManager = Android.App.Application.Context.PackageManager;
    var installerPackage = packageManager.GetInstallerPackageName(Android.App.Application.Context.PackageName);
    var appMetadata = packageManager.GetApplicationInfo(Android.App.Application.Context.PackageName, PackageInfoFlags.MetaData).MetaData;
    
    // 内部测试环境（ADB安装、内部测试轨道）
    if (installerPackage == null || (installerPackage == "com.android.vending" && appMetadata.GetString("TEST_TRACK") == "Internal"))
    {
        return "Development";
    }
    // 公开测试环境（Google Play Beta轨道）
    else if (installerPackage == "com.android.vending" && appMetadata.GetString("TEST_TRACK") == "Beta")
    {
        return "Staging";
    }
    // 生产环境
    else
    {
        return "Production";
    }
}

iOS平台（Platforms/iOS/AppDelegate.cs） #

public static string GetCurrentEnvironment()
{
    var infoDict = NSBundle.MainBundle.InfoDictionary;
    var testTrack = infoDict["TEST_TRACK"] as NSString;
    
    if (testTrack == "Internal")
    {
        return "Development";
    }
    else if (testTrack == "Beta")
    {
        return "Staging";
    }
    else
    {
        return "Production";
    }
}

四、一次打包适配多渠道的配置注入 #

通过MSBuild参数在打包时注入环境标识，无需重复编译：

Android打包配置（修改项目.csproj） #

<PropertyGroup Condition="'$(Configuration)' == 'Release'">
    <AndroidManifestProperties>
        <MetaData Name="TEST_TRACK" Value="$(TestTrack)" />
    </AndroidManifestProperties>
</PropertyGroup>

打包命令示例：

# 内部测试包
dotnet publish -f net8.0-android -c Release /p:TestTrack=Internal
# 公开测试包
dotnet publish -f net8.0-android -c Release /p:TestTrack=Beta
# 生产包
dotnet publish -f net8.0-android -c Release /p:TestTrack=Production

iOS打包配置（修改项目.csproj） #

<PropertyGroup Condition="'$(Configuration)' == 'Release'">
    <InfoPlistPreprocessorDefinitions>TEST_TRACK=$(TestTrack)</InfoPlistPreprocessorDefinitions>
</PropertyGroup>

同时在Info.plist中添加字段：

<key>TEST_TRACK</key>
<string>$(TEST_TRACK)</string>

打包命令示例：

# 内部测试包
dotnet publish -f net8.0-ios -c Release /p:TestTrack=Internal
# 公开测试包
dotnet publish -f net8.0-ios -c Release /p:TestTrack=Beta
# 生产包
dotnet publish -f net8.0-ios -c Release /p:TestTrack=Production

五、在应用中使用配置 #

通过依赖注入获取配置，例如在ViewModel中：

public class MainViewModel
{
    private readonly IConfiguration _config;

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

    public string ApiBaseUrl { get; }
}

内容的提问来源于stack exchange，提问作者Steve Parry