Android实现软键盘弹出时仅上推内容视图不移动背景

核心思路是拆分背景层与内容层，手动监听软键盘高度，仅对内容层做位置偏移，背景层始终固定铺满全屏，避开系统默认的整体窗口平移/压缩逻辑。 #

步骤1：调整布局层级 #

将原本设置在根布局上的背景抽离为独立的View，放在内容层下方，不随软键盘做任何偏移：

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <!-- 固定不动的背景层，始终铺满全屏 -->
    <View
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="@mipmap/img" />

    <!-- 内容层，响应软键盘高度做偏移 -->
    <androidx.constraintlayout.widget.ConstraintLayout
        android:id="@+id/rootLayout"
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <LinearLayout
            android:layout_width="200dp"
            android:layout_height="wrap_content"
            android:background="#00ff00"
            android:orientation="vertical"
            android:padding="12dp"
            app:layout_constraintBottom_toTopOf="@+id/bottomLayout"
            app:layout_constraintLeft_toLeftOf="parent">

            <TextView
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:background="#2196F3"
                android:text="1111" />

            <TextView
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_marginTop="4dp"
                android:background="#2196F3"
                android:text="2222" />

            <TextView
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_marginTop="4dp"
                android:background="#2196F3"
                android:text="3333" />

            <TextView
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_marginTop="4dp"
                android:background="#2196F3"
                android:text="4444" />
        </LinearLayout>

        <LinearLayout
            android:id="@+id/bottomLayout"
            android:layout_width="match_parent"
            android:layout_height="100dp"
            android:background="@color/purple_200"
            android:gravity="center"
            android:orientation="vertical"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintLeft_toLeftOf="parent"
            app:layout_constraintRight_toRightOf="parent">

            <EditText
                android:id="@+id/edittext"
                android:layout_width="match_parent"
                android:layout_height="wrap_content" />
        </LinearLayout>
    </androidx.constraintlayout.widget.ConstraintLayout>
</FrameLayout>

步骤2：配置Activity软键盘模式 #

在AndroidManifest.xml中给对应Activity配置软键盘模式，不要使用adjustPan：

<activity
    android:name=".MainActivity"
    android:windowSoftInputMode="adjustResize|stateHidden"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

依赖提示：后续软键盘监听使用AndroidX官方的WindowInsetsCompat实现，需要在模块级build.gradle中引入核心依赖：
implementation "androidx.core:core-ktx:1.12.0"（可替换为当前最新稳定版）

步骤3：添加软键盘高度监听，仅调整内容层边距 #

在Activity中监听窗口Insets变化，获取软键盘高度后只给内容层设置底部边距，背景层完全不受影响：

Kotlin 实现 #

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        val contentLayout = findViewById<ConstraintLayout>(R.id.rootLayout)
        
        ViewCompat.setOnApplyWindowInsetsListener(contentLayout) { view, insets ->
            // 获取软键盘占用的高度
            val imeHeight = insets.getInsets(WindowInsetsCompat.Type.ime()).bottom
            // 获取系统导航栏默认高度，避免内容偏移过多
            val navBarHeight = insets.getInsets(WindowInsetsCompat.Type.systemBars()).bottom
            // 仅给内容层设置底部padding，实现上移效果
            view.updatePadding(bottom = imeHeight - navBarHeight)
            insets
        }
    }
}

Java 实现 #

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ConstraintLayout contentLayout = findViewById(R.id.rootLayout);

        ViewCompat.setOnApplyWindowInsetsListener(contentLayout, (view, insets) -> {
            int imeHeight = insets.getInsets(WindowInsetsCompat.Type.ime()).bottom;
            int navBarHeight = insets.getInsets(WindowInsetsCompat.Type.systemBars()).bottom;
            view.setPadding(
                    view.getPaddingLeft(),
                    view.getPaddingTop(),
                    view.getPaddingRight(),
                    imeHeight - navBarHeight
            );
            return insets;
        });
    }
}

效果说明 #

• 初始布局效果和原有逻辑完全一致：
  
• 软键盘弹出时，仅内容层随键盘高度上移，输入框不会被遮挡，背景始终固定不发生裁切：
  

adjustPan模式无法满足需求的核心原因：该模式下系统会直接对整个应用窗口做全局平移，窗口内所有View（包括根布局上设置的背景）都会同步移动，自然无法实现背景固定的效果。

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