基于FragmentActivity的应用ActionBar部分设备不显示问题求助

我开发的基于FragmentActivity的Android应用使用了ActionBar，但显示情况因设备而异：

• Android 13/14的Android Studio模拟器：ActionBar和自定义MenuItem正常显示
• Android 12的Galaxy Tab S6+真机：一切正常
• Android 14的Galaxy S24+手机、Galaxy Tab S6平板：ActionBar无法显示

编译参数 #

• compile SDK版本：34
• build tool版本：35.0.0
• java版本：17
• min SDK：26
• target SDK：34
• Gradle版本：8.9
• Android Gradle插件版本：8.7.2

各版本styles.xml内容 #

v11版本 #

<!--
    Base application theme for API 11+. This theme completely replaces
    AppBaseTheme from res/values/styles.xml on API 11+ devices.
-->
<style name="AppBaseTheme" parent="android:Theme.Holo.Light">
    <!-- API 11 theme customizations can go here. -->
</style>

v14版本 #

<!--
    Base application theme for API 14+. This theme completely replaces
    AppBaseTheme from BOTH res/values/styles.xml and
    res/values-v11/styles.xml on API 14+ devices.
-->
<style name="AppBaseTheme" parent="android:Theme.Holo.Light.DarkActionBar">
    <!-- API 14 theme customizations can go here. -->
</style>

v21版本 #

<style name="AppBaseTheme" parent="android:Theme.Holo.Light.DarkActionBar">
    <!-- API 14 theme customizations can go here. -->
</style>

<style name="Widget.Memo.AppWidget.Container" parent="android:Widget">
    <item name="android:padding">?attr/appWidgetPadding</item>
    <item name="android:background">@drawable/app_widget_background</item>
</style>

<style name="Widget.Memo.AppWidget.InnerView" parent="android:Widget">
    <item name="android:padding">?attr/appWidgetPadding</item>
    <item name="android:background">@drawable/app_widget_inner_view_background</item>
</style>

v31版本 #

<style name="AppBaseTheme" parent="android:Theme.Holo.Light.DarkActionBar">
    <!-- API 14 theme customizations can go here. -->
</style>

<style name="Widget.Memo.AppWidget.Container" parent="android:Widget">
    <item name="android:padding">?attr/appWidgetPadding</item>
    <item name="android:background">@drawable/app_widget_background</item>
<!--    <item name="android:clipToOutline">true</item> -->
</style>

<style name="Widget.Memo.AppWidget.InnerView" parent="android:Widget">
    <item name="android:padding">?attr/appWidgetPadding</item>
    <item name="android:background">@drawable/app_widget_inner_view_background</item>
<!--    <item name="android:clipToOutline">true</item> -->
</style>

sw720dp版本 #

<!--
    Base application theme, dependent on API level. This theme is replaced
    by AppBaseTheme from res/values-vXX/styles.xml on newer devices.
-->
<style name="AppBaseTheme" parent="android:Theme.Light">
    <!--
        Theme customizations available in newer API levels can go in
        res/values-vXX/styles.xml, while customizations related to
        backward-compatibility can go here.
    -->
</style>

<!-- Application theme. -->
<style name="AppTheme" parent="AppBaseTheme">
    <!-- All customizations that are NOT specific to a particular API-level can go here. -->
</style>

<!-- 未选中条目文本样式 -->
<style name="TexteNonCoche" parent="@android:style/TextAppearance.Large">
    <item name="android:typeface">sans</item>
    <item name="android:textSize">30sp</item>
    <item name="android:textColor">#000000</item>
</style>  

<!-- 已选中条目文本样式 -->
<style name="TexteCoche" parent="@android:style/TextAppearance.Large">
    <item name="android:typeface">sans</item>
    <item name="android:textSize">30sp</item>
    <item name="android:textColor">#7F7F7F</item>
</style>    

核心原因 #

1. Holo主题高版本兼容性失效：你所有高版本styles.xml都沿用了Android 4.x时代的android:Theme.Holo.Light.DarkActionBar主题，而Android 14对旧主题的兼容性进一步收紧，三星定制系统（如S24+搭载的One UI）会主动屏蔽旧主题的ActionBar渲染逻辑。
2. 高版本主题配置缺失：你的styles.xml最高仅适配到API 31，但target SDK为34（Android 14），缺少针对Android 13/14的主题声明，导致系统无法正确识别ActionBar配置。
3. FragmentActivity依赖的主题不匹配：FragmentActivity需要主题明确声明支持ActionBar，旧Holo主题在高版本系统中无法被正确映射到现代ActionBar组件。

解决步骤 #

1. 迁移到Material/AppCompat主题 #

针对API 21+（Android 5.x及以上），将主题父类替换为官方推荐的主题，修改res/values-v21/styles.xml：

<style name="AppBaseTheme" parent="Theme.MaterialComponents.Light.DarkActionBar">
    <item name="windowActionBar">true</item>
    <item name="windowNoTitle">false</item>
    <!-- 保留原有自定义属性 -->
</style>

若不想使用Material Components，可改用AppCompat兼容主题：

<style name="AppBaseTheme" parent="Theme.AppCompat.Light.DarkActionBar">
    <item name="windowActionBar">true</item>
    <item name="windowNoTitle">false</item>
</style>

2. 补充API 33+主题配置 #

新建res/values-v33/styles.xml，明确声明ActionBar属性：

<style name="AppBaseTheme" parent="Theme.MaterialComponents.Light.DarkActionBar">
    <item name="windowActionBar">true</item>
    <item name="windowNoTitle">false</item>
    <!-- 可选：自定义ActionBar样式 -->
    <item name="actionBarStyle">@style/CustomActionBar</item>
</style>

<style name="CustomActionBar" parent="Widget.MaterialComponents.ActionBar.Solid">
    <item name="background">?attr/colorPrimary</item>
</style>

3. 确认Activity主题引用 #

检查AndroidManifest.xml中FragmentActivity的主题配置：

<activity
    android:name=".YourMainActivity"
    android:theme="@style/AppTheme">
</activity>

4. 修正ActionBar初始化代码 #

若使用AppCompat主题，需将getActionBar()替换为getSupportActionBar()：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    ActionBar actionBar = getSupportActionBar();
    if (actionBar != null) {
        actionBar.setDisplayHomeAsUpEnabled(true);
    }
}

5. 清理缓存并重构项目 #

• 执行Build -> Clean Project清理缓存
• 执行Build -> Rebuild Project重新构建
• 在目标设备上卸载旧应用后重新安装

额外说明 #

三星定制系统对旧主题的兼容性比模拟器更严格，迁移到官方推荐的Material/AppCompat主题是解决此类问题的根本方案，同时能提升应用在高版本系统上的视觉一致性。

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