Xamarin应用安卓真机Label不显示但模拟器正常的解决方法求助

问题原因 #

该问题绝大多数情况由FontSize="Title"这个Xamarin.Forms命名字体大小的适配异常导致：部分安卓真机的系统字体缩放规则、AppCompat依赖库版本、全局主题配置不匹配时，会无法正确解析Title对应的字体尺寸，最终把Label渲染为宽高为0的不可见状态，少数情况是文本色与背景色重合、编译缓存异常导致。

解决方案 #

按优先级逐个测试即可：

• 方案1：替换命名字体大小为固定/适配后的数值
  直接替换原有代码为固定字号版本：

  <Label Text="Start developing now" FontSize="24"/>
  

  需要保留多端自适应效果的话，显式定义字体尺寸资源：
  首先在App.xaml的资源字典中添加适配规则：

  <Application.Resources>
      <OnPlatform x:Key="TitleFontSize" x:TypeArguments="x:Double">
          <On Platform="Android" Value="24" />
          <On Platform="iOS" Value="28" />
      </OnPlatform>
  </Application.Resources>
  

  再修改Label引用该资源：

  <Label Text="Start developing now" FontSize="{StaticResource TitleFontSize}"/>
  

• 方案2：检查安卓项目主题配置
  确认MainActivity使用的是Xamarin.Forms兼容的AppCompat主题，Activity头部配置示例：

  [Activity(Label = "应用名称", Icon = "@mipmap/icon", Theme = "@style/MainTheme", MainLauncher = true, 
      ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode)]
  public class MainActivity : global::Xamarin.Forms.Platform.Android.FormsAppCompatActivity
  

  同时检查安卓项目Resources/values/styles.xml中的MainTheme继承自Theme.MaterialComponents.Light.DarkActionBar或Theme.AppCompat.Light.DarkActionBar，不要使用安卓原生旧版主题。
• 方案3：显式指定文本颜色
  部分安卓系统默认文本颜色与页面背景色重合会导致视觉上不可见，添加TextColor属性即可：

  <Label Text="Start developing now" FontSize="Title" TextColor="Black"/>
  

• 方案4：清理缓存重新编译
  删掉安卓项目的bin、obj文件夹后重新部署，排除旧编译缓存导致的渲染异常。
• 补充排查：如果以上方案都不生效，给Label添加BackgroundColor="Red"属性后测试，如果红色背景都没有显示，说明是布局层级问题，调整Label所在父布局的宽高约束、子控件顺序即可。

内容的提问来源于stack exchange，提问作者Shalahudin Al Ayyuby