Android启动页全屏高度显示异常问题求助

问题场景 #

启动页通过layer-list加载位图实现，水平方向显示正常，但垂直方向内容被截断。即使设置android:gravity="fill_horizontal|fill_vertical"，问题仍未解决。

设计稿效果：

实际显示效果：

当前使用的splashscreen.xml代码：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
  <item>
    <bitmap
            android:gravity="fill_horizontal|fill_vertical"
            android:src="@drawable/ic_splash_screen_bg_xx"/>
  </item>
</layer-list>

解决方案 #

1. 简化layer-list配置

去掉嵌套的bitmap标签，直接在item中绑定drawable并设置gravity，这种方式更兼容不同屏幕：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:gravity="fill"
        android:drawable="@drawable/ic_splash_screen_bg_xx"/>
</layer-list>

2. 强制item占满容器

给item明确设置宽高为match_parent，确保位图能填充整个屏幕区域：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:width="match_parent"
        android:height="match_parent">
        <bitmap
            android:gravity="fill"
            android:src="@drawable/ic_splash_screen_bg_xx"/>
    </item>
</layer-list>

3. 检查位图资源适配

确认你的位图放在了对应屏幕密度的drawable目录（如drawable-xhdpi、drawable-xxhdpi），且位图的宽高比与目标屏幕宽高比一致。如果宽高比不匹配，可根据需求调整设计稿，或改用ImageView配合启动页布局实现裁剪/拉伸适配。

4. 排查启动页主题配置

确保启动页主题是全屏且无额外边距：
在styles.xml中配置：

<style name="SplashTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <item name="android:windowBackground">@drawable/splashscreen</item>
    <item name="android:windowFullscreen">true</item>
    <item name="android:windowContentOverlay">@null</item>
</style>

内容的提问来源于stack exchange，提问作者Ngoe Kelson Tchinda