BeeWare Toga对Android主题的支持及组件适配问题

用户问题描述 #

我使用BeeWare启动了一个Android应用项目，希望以<style name="AppTheme" parent="Theme.MaterialComponents.DayNight">为基础，在/res/values/styles.xml中自定义应用主题。有以下疑问：

• BeeWare Toga会使用我构建的主题，还是有自身的色彩系统？
• 我了解可为创建的组件指定样式，但如果不指定，组件会使用主题样式吗？
• Toga组件是Android原生组件的包装还是Toga专属组件？
• 我进行了测试，但并非所有属性设置的颜色都生效，例如我将colorPrimaryText设为蓝色，但所有toga.Label文本仍为黑色。

补充说明：我已了解到Toga在Android平台使用原生Android组件，这意味着它应该支持Android主题。但我想进一步确认，它仅支持旧版AppCompat主题组件，还是也支持新版MaterialComponents组件？

附上主题配置代码 #

<resources>

    <style name="AppTheme" parent="Theme.MaterialComponents.DayNight">
        <item name="colorPrimary">@color/colorPrimary</item>
        <item name="colorOnPrimary">@color/colorPrimaryText</item>
        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
        <item name="colorAccent">@color/colorAccent</item>
        <item name="android:colorBackground">@color/backgroundColor</item>
        <item name="android:textColor">@color/textColor</item>     
        
        <item name="colorSurface">@color/colorPrimary</item>
        <item name="colorOnSurface">@color/colorPrimaryText</item>
        <item name="android:textColorPrimary">@color/colorPrimaryText</item>
    </style>

    <style name="AppTheme.Launcher">
        <item name="android:windowBackground">@drawable/splash_screen_background</item>
    </style>
    
</resources>

问题解答 #

1. Toga的主题与色彩系统逻辑 #

Toga在Android端完全基于原生Android组件包装，并非自研专属组件。它会加载你定义的AppTheme，但同时存在一套跨平台的样式抽象层：

• 当你显式指定组件样式时，Toga会优先使用你设置的样式；
• 未指定样式时，部分组件会默认应用Toga的跨平台默认样式（而非完全继承Android主题属性），这就是你遇到Label文本颜色不生效的核心原因。

2. MaterialComponents主题兼容性 #

Toga支持新版MaterialComponents主题，你的Theme.MaterialComponents.DayNight配置是有效的。Toga的Android适配器会优先使用Material Components库中的组件（如MaterialTextView），只要主题继承自MaterialComponents，这些组件就能正确识别并应用主题中的Material属性。

3. Label文本颜色不生效的解决办法 #

Toga在初始化Label组件时，会显式设置文本颜色为跨平台默认值，覆盖了主题中的android:textColorPrimary等属性。解决方式有三种：

• 代码中显式指定颜色：

  from toga import Label
  
  label = Label("示例文本", style={"color": "#0000FF"})
  

• 通过主题覆盖组件默认样式：在styles.xml中针对MaterialTextView设置全局样式：

  <style name="AppTheme" parent="Theme.MaterialComponents.DayNight">
      <!-- 已有的主题属性 -->
      <item name="materialTextViewStyle">@style/CustomLabelStyle</item>
  </style>
  
  <style name="CustomLabelStyle" parent="Widget.MaterialComponents.TextView">
      <item name="android:textColor">@color/colorPrimaryText</item>
  </style>
  

• 修改Toga适配器代码：找到Label的Android实现类（toga_android.widget.label.Label），移除其中默认设置文本颜色的代码，让组件完全继承主题样式。

4. 未指定样式时的组件行为 #

未显式指定样式时，部分组件会继承主题属性，但Toga的跨平台样式层会对部分属性做默认覆盖（比如文本颜色、padding等），以保证跨平台UI的一致性。如果希望组件完全遵循Android主题，需要显式禁用Toga的默认样式或通过主题覆盖组件样式。

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