.NET MAUI多品牌构建配置下Firebase日志统一流向主项目问题排查

问题描述 #

我有一个.NET 8 MAUI项目，为不同品牌配置了独立的构建方案，每个配置对应专属的Android Manifest、google-services.json文件，使用不同应用ID连接各自的Firebase项目。Android端构建时，专属清单、密钥库、图片等资源都正常加载，但所有品牌的构建日志（分析、崩溃日志）都流向主品牌的Firebase项目，推测是对应品牌的google-services.json未被正确加载。

csproj中的相关配置如下（以某品牌为例）：

<!-- 同时配置了Release版本的对应项 -->
<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='[Brand]Debug|net8.0-android|AnyCPU'">
    <AndroidSigningKeyStore>Platforms\Android\Keystores\[brand].keystore</AndroidSigningKeyStore>
    <AndroidManifest>Platforms\Android\[Brand]\AndroidManifest.xml</AndroidManifest>
    ...
</PropertyGroup>

...

<ItemGroup Condition="(('$(Configuration)' == '[Brand]Debug' Or '$(Configuration)' == '[Brand]Release') And '$(TargetFramework)' == 'net8.0-android')">
    <None Remove="Platforms\Android\[MainBrand]\google-services.json" />
    <GoogleServicesJson Include="Platforms\Android\[Brand]\google-services.json" />
</ItemGroup>

所有google-services.json均从对应Firebase项目下载，内容正确，路径无误，且项目中无其他google-services相关配置。

问题原因与解决方案 #

核心原因 #

MAUI中GoogleServicesJson的处理逻辑依赖构建阶段的属性优先级，且默认会优先识别根目录或默认路径下的配置文件。当前配置存在两个关键问题：

• 条件判断的优先级不足：ItemGroup的条件可能未覆盖所有构建场景，或者被默认的隐式包含规则覆盖；
• 未完全清除主品牌配置的残留：仅用<None Remove>无法彻底移除主品牌google-services.json在构建过程中的影响，因为Firebase插件可能在更早阶段就读取了该文件。

分步解决 #

1. 调整GoogleServicesJson的包含逻辑，提升条件优先级
   把每个品牌的GoogleServicesJson配置放在对应品牌的PropertyGroup之后，确保条件判断更精准，同时显式排除所有其他品牌的配置文件：

   <!-- Debug版本配置 -->
   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='[Brand]Debug|net8.0-android|AnyCPU'">
       <AndroidSigningKeyStore>Platforms\Android\Keystores\[brand].keystore</AndroidSigningKeyStore>
       <AndroidManifest>Platforms\Android\[Brand]\AndroidManifest.xml</AndroidManifest>
       <!-- 强制指定当前品牌的google-services.json路径 -->
       <GoogleServicesJsonPath>Platforms\Android\[Brand]\google-services.json</GoogleServicesJsonPath>
   </PropertyGroup>
   
   <ItemGroup Condition="'$(Configuration)' == '[Brand]Debug' And '$(TargetFramework)' == 'net8.0-android'">
       <!-- 移除所有其他品牌的google-services.json -->
       <GoogleServicesJson Remove="Platforms\Android\*\google-services.json" />
       <!-- 包含当前品牌的配置 -->
       <GoogleServicesJson Include="Platforms\Android\[Brand]\google-services.json" />
   </ItemGroup>
   
   <!-- Release版本配置 -->
   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='[Brand]Release|net8.0-android|AnyCPU'">
       <AndroidSigningKeyStore>Platforms\Android\Keystores\[brand].keystore</AndroidSigningKeyStore>
       <AndroidManifest>Platforms\Android\[Brand]\AndroidManifest.xml</AndroidManifest>
       <GoogleServicesJsonPath>Platforms\Android\[Brand]\google-services.json</GoogleServicesJsonPath>
   </PropertyGroup>
   
   <ItemGroup Condition="'$(Configuration)' == '[Brand]Release' And '$(TargetFramework)' == 'net8.0-android'">
       <GoogleServicesJson Remove="Platforms\Android\*\google-services.json" />
       <GoogleServicesJson Include="Platforms\Android\[Brand]\google-services.json" />
   </ItemGroup>
   

2. 清理构建缓存
   MAUI构建会缓存中间文件，残留的主品牌配置可能仍在生效，执行以下操作：
   • 删除项目根目录下的bin和obj文件夹；
   • 在Visual Studio中选择生成 > 清理解决方案；
   • 重启Visual Studio后重新构建。
3. 验证构建过程
   构建时查看输出日志，搜索google-services相关条目，确认是否加载了对应品牌的google-services.json路径。

额外验证点 #

• 检查每个品牌的AndroidManifest.xml中的package属性是否与对应Firebase项目的应用ID完全一致；
• 确认每个品牌的签名密钥库的SHA-1指纹已添加到对应Firebase项目的应用配置中。

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