Android 12设备上DialogFragment弹窗裁剪截断问题求助

问题表现 #

• 基于AppCompatDialogFragment实现的弹窗在三星TAB S7等部分机型上出现底部截断，底部提示内容、操作按钮无法正常显示
• 完全相同的复现代码嵌入正式上线应用运行会触发截断，放入新建的空白测试工程、在同一台设备上运行则显示正常，两边主题、AndroidManifest配置表面看没有明显差异
• 已尝试多种常规修复方案，无法做到全设备兼容生效

复现代码 #

Dialog核心逻辑 #

package com.example.dialogclipping;

import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatDialogFragment;
import androidx.fragment.app.DialogFragment;

public class DlgTest extends AppCompatDialogFragment {
    static DlgTest newInstance() {
        return new DlgTest();
    }

    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setStyle(DialogFragment.STYLE_NO_TITLE, R.style.DialogStyle);
    }

    @Override
    public void onStart() {
        super.onStart();
        int targetWidth = 1000;
        int targetHeight = 0;

        if (targetWidth != 0 || targetHeight != 0) {
            var dialog = getDialog();
            if (dialog == null) return;
            var window = dialog.getWindow();
            if (window == null) return;

            var lp = window.getAttributes();
            if (targetWidth > 0) lp.width = targetWidth;
            if (targetHeight > 0) lp.height = targetHeight;
            window.setAttributes(lp);
        }
    }

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        return inflater.inflate(R.layout.dlg_test_layout, container, false);
    }

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        view.setBackgroundColor(0xFF92580C);
        final var closeButton = view.findViewById(R.id.yesButton);
        closeButton.setOnClickListener(v -> {
            // 点击逻辑
        });
    }
}

Dialog布局文件 #

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout android:id="@+id/SettingsDialog"
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:gravity="center_horizontal"
    android:paddingLeft="20dp"
    android:paddingRight="20dp"
    android:paddingTop="8dp"
    android:paddingBottom="8dp"
    android:orientation="vertical">

    <TextView
        android:id="@+id/header"
        style="@style/DialogText.Heading"
        android:minEms="16"
        android:layout_gravity="left"
        android:text="Header line"/>

    <View
        android:layout_width="match_parent"
        android:layout_height="120dp"
        android:background="@color/blue"/>

    <View
        android:id="@+id/middleView"
        android:layout_width="match_parent"
        android:layout_height="3dp"
        android:layout_marginTop="10dp"
        android:background="@color/black">
    </View>
    <LinearLayout
        android:id="@+id/ButtonBar"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:layout_gravity="right">

        <Button
            android:id="@+id/yesButton"
            style="@style/DialogButton.Large"
            android:textSize="20dp"
            android:layout_width="0dip"
            android:layout_weight="2"
            android:text="Close"
            android:visibility="visible"/>
    </LinearLayout>

    <View
        android:id="@+id/bottomView"
        android:layout_width="match_parent"
        android:layout_height="3dp"
        android:background="@color/blue">
    </View>
</LinearLayout>

AndroidManifest配置 #

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.example.dialogclipping">

    <supports-screens
        android:anyDensity="true"
        android:largeScreens="true"
        android:normalScreens="true"
        android:smallScreens="false"
        android:xlargeScreens="true"/>

    <application
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:resizeableActivity="false"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppBaseTheme"
        tools:targetApi="31">
        <activity
            android:name=".MainActivity"
            android:screenOrientation="sensorLandscape"
            android:configChanges="orientation|keyboardHidden|screenSize|smallestScreenSize"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

主题配置 #

<resources xmlns:tools="http://schemas.android.com/tools">
    <style name="AppBaseTheme" parent="Theme.AppCompat.NoActionBar">
    </style>

    <style name="DialogStyle" parent="Theme.AppCompat.Dialog">
    </style>
</resources>

效果对比 #

问题根因 #

这是三星OneUI系统的经典兼容问题，正式应用和测试工程的表现差异来自隐式配置不同，核心触发点有三个：

1. Manifest中配置了android:resizeableActivity="false"，三星对声明为不可调整大小的应用，Dialog窗口尺寸计算逻辑和原生AOSP存在差异，设置固定宽度后不会主动触发wrap_content高度的二次测量，直接使用偏小的缓存高度值
2. onStart中设置窗口参数时仅指定了固定宽度1000px，没有显式把高度设置为WRAP_CONTENT，给了系统使用错误缓存高度的机会
3. 正式应用大概率全局开启了边缘到边缘（Edge-to-Edge/沉浸式）显示，空白测试工程默认没有该配置；Dialog窗口会默认继承宿主Activity的沉浸式属性，如果没有单独给Dialog做系统栏边距适配，底部导航栏的占位就会直接裁切弹窗底部内容。

修复方案 #

按优先级依次验证即可覆盖所有机型：

• 修正onStart中的窗口参数设置逻辑，显式指定高度为自适应，强制窗口居中、重新布局：

@Override
public void onStart() {
    super.onStart();
    Dialog dialog = getDialog();
    if (dialog == null) return;
    Window window = dialog.getWindow();
    if (window == null) return;
    
    WindowManager.LayoutParams lp = window.getAttributes();
    lp.width = 1000;
    // 显式指定高度自适应，不要留空使用默认值
    lp.height = WindowManager.LayoutParams.WRAP_CONTENT;
    lp.gravity = Gravity.CENTER;
    window.setAttributes(lp);

    // 强制内容根布局重新测量
    View contentView = getView();
    if (contentView != null) {
        contentView.requestLayout();
    }
}

• 给Dialog主题补充边距适配属性，避免被全局窗口配置影响：

<style name="DialogStyle" parent="Theme.AppCompat.Dialog">
    <item name="android:fitsSystemWindows">true</item>
    <item name="android:clipToPadding">false</item>
    <item name="android:clipChildren">false</item>
    <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
</style>

• 如果应用全局开启了沉浸式，在Dialog的onStart中单独给Dialog窗口关闭沉浸式继承，让Dialog自行处理系统栏边距：

WindowCompat.setDecorFitsSystemWindows(window, true);

• 快速验证方法：临时把Manifest中的android:resizeableActivity="false"改为true运行，如果弹窗不再截断，即可确认是三星ROM对非resizeable应用的窗口计算bug，上述修复方案可完全规避该问题，不需要修改resizeableActivity配置。

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