如何在.NET MAUI项目中实现白标化？（原Xamarin Forms迁移）

原有Xamarin Forms方案的适配调整 #

你在Xamarin里用的配置常量+替换Info.plist/Android Manifest的思路可以在MAUI里调整后使用，但MAUI的构建系统逻辑和Xamarin不同，直接沿用原有生成操作设置会失效，需要修改项目文件(.csproj)来实现条件加载：

iOS平台调整 #

1. 按品牌创建独立的Info.plist文件，比如放在Platforms/iOS/WhiteLabels/BrandA/Info.plist、Platforms/iOS/WhiteLabels/BrandB/Info.plist
2. 在项目文件中添加条件编译逻辑，替换默认的Info.plist：

<ItemGroup Condition="'$(Configuration)' == 'BrandA'">
  <Plist Include="Platforms/iOS/WhiteLabels/BrandA/Info.plist" />
  <None Remove="Platforms/iOS/Info.plist" />
</ItemGroup>
<ItemGroup Condition="'$(Configuration)' == 'BrandB'">
  <Plist Include="Platforms/iOS/WhiteLabels/BrandB/Info.plist" />
  <None Remove="Platforms/iOS/Info.plist" />
</ItemGroup>

Android平台调整 #

1. 同理，将不同品牌的AndroidManifest.xml放在Platforms/Android/WhiteLabels/BrandA/AndroidManifest.xml等路径
2. 在项目文件中添加条件配置：

<ItemGroup Condition="'$(Configuration)' == 'BrandA'">
  <AndroidManifest Include="Platforms/Android/WhiteLabels/BrandA/AndroidManifest.xml" />
  <None Remove="Platforms/Android/AndroidManifest.xml" />
</ItemGroup>

3. 品牌专属的资源（图标、字符串等）可以放在Platforms/Android/Resources/BrandA下，通过条件ItemGroup包含：

<ItemGroup Condition="'$(Configuration)' == 'BrandA'">
  <AndroidResource Include="Platforms/Android/Resources/BrandA/**/*" />
  <AndroidResource Remove="Platforms/Android/Resources/drawable/**/*" />
</ItemGroup>

配置常量定义 #

在项目文件中针对不同构建配置定义常量，比如：

<PropertyGroup Condition="'$(Configuration)' == 'BrandA'">
  <DefineConstants>$(DefineConstants);BRAND_A</DefineConstants>
</PropertyGroup>

之后就可以在代码中用#if BRAND_A来加载对应品牌的逻辑或资源。

其他MAUI专属白标化方案 #

1. 基于资源字典的UI白标 #

在共享项目中为每个品牌创建独立的资源字典（如BrandAResources.xaml、BrandBResources.xaml），包含品牌专属的颜色、字体、样式等：

<!-- BrandAResources.xaml -->
<ResourceDictionary xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
                    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">
    <Color x:Key="PrimaryColor">#FF0000</Color>
    <Style x:Key="HeaderLabelStyle" TargetType="Label">
        <Setter Property="FontSize" Value="24"/>
        <Setter Property="TextColor" Value="{StaticResource PrimaryColor}"/>
    </Style>
</ResourceDictionary>

然后在App.xaml.cs中根据配置动态加载：

public App()
{
    InitializeComponent();
    var resources = new ResourceDictionary();
#if BRAND_A
    resources.MergedDictionaries.Add(new BrandAResources());
#else
    resources.MergedDictionaries.Add(new BrandBResources());
#endif
    Resources = resources;
    MainPage = new MainPage();
}

2. 利用MAUI配置系统加载品牌配置 #

创建品牌专属的配置文件，如appsettings.BrandA.json、appsettings.BrandB.json：

{
  "Brand": "BrandA",
  "ApiUrl": "https://api.branda.com",
  "Theme": {
    "PrimaryColor": "#FF0000"
  }
}

在MauiProgram.cs中根据构建配置加载对应文件：

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .ConfigureAppConfiguration((ctx, config) =>
        {
#if BRAND_A
            config.AddJsonFile("appsettings.BrandA.json", optional: false, reloadOnChange: true);
#else
            config.AddJsonFile("appsettings.BrandB.json", optional: false, reloadOnChange: true);
#endif
        });

    return builder.Build();
}

之后可以通过依赖注入获取配置，动态应用到UI或业务逻辑中。

3. 自定义MSBuild目标实现资源替换 #

如果需要更灵活的资源替换（比如启动图、图标等），可以自定义MSBuild目标，在构建阶段复制品牌专属资源到目标目录：

<Target Name="CopyWhiteLabelAssets" BeforeTargets="PrepareForBuild">
  <Copy SourceFiles="Platforms/iOS/WhiteLabels/$(Configuration)/Assets.xcassets"
        DestinationFolder="Platforms/iOS/Assets.xcassets"
        OverwriteReadOnlyFiles="true"
        SkipUnchangedFiles="false" />
</Target>

这里$(Configuration)对应你的品牌构建配置（如BrandA、BrandB），确保每个配置下的资源路径正确。

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