ConstraintLayout登录界面软键盘上推视图问题求助

我之前在开发ConstraintLayout登录页时，完全碰到过和你一样的困扰！依赖参考线做响应式布局确实爽，但软键盘弹出时的适配简直是个玄学坑——AdjustNothing直接挡输入框，AdjustPan要么推得太狠把顶部Logo顶出屏幕，要么布局错位。给你几个亲测有效的解决方案，按优先级来试：

这是最稳定的原生适配方案，核心是让ConstraintLayout能感知窗口高度变化，同时通过约束让内容自动适配，步骤如下：

• 在Manifest里给当前Activity设置：

  <activity
      android:name=".LoginActivity"
      android:windowSoftInputMode="adjustResize"/>
  

• 给根布局ConstraintLayout加上android:fitsSystemWindows="true"，让它正确识别系统窗口（包括软键盘）的变化。
• 关键布局约束：把底部的操作元素（比如登录按钮）同时约束到上方输入框的底部和父布局的底部，并且设置合适的上下边距。这样软键盘弹出时，父布局高度缩小，底部按钮会被向上推，带动整个输入区域上移，同时参考线的百分比约束依然能保持响应式宽度。

举个完整的布局示例：

<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/login_root"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true">

    <!-- 顶部Logo，固定顶部间距 -->
    <ImageView
        android:id="@+id/iv_logo"
        android:layout_width="120dp"
        android:layout_height="120dp"
        android:src="@drawable/ic_logo"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        android:layout_marginTop="64dp"/>

    <!-- 响应式左右参考线 -->
    <androidx.constraintlayout.widget.Guideline
        android:id="@+id/guideline_left"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:orientation="vertical"
        app:layout_constraintGuide_percent="0.1"/>

    <androidx.constraintlayout.widget.Guideline
        android:id="@+id/guideline_right"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:orientation="vertical"
        app:layout_constraintGuide_percent="0.9"/>

    <!-- 用户名输入框 -->
    <EditText
        android:id="@+id/et_username"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:hint="请输入用户名"
        android:paddingHorizontal="16dp"
        android:paddingVertical="12dp"
        app:layout_constraintTop_toBottomOf="@id/iv_logo"
        app:layout_constraintStart_toStartOf="@id/guideline_left"
        app:layout_constraintEnd_toEndOf="@id/guideline_right"
        android:layout_marginTop="48dp"/>

    <!-- 密码输入框 -->
    <EditText
        android:id="@+id/et_password"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:hint="请输入密码"
        android:inputType="textPassword"
        android:paddingHorizontal="16dp"
        android:paddingVertical="12dp"
        app:layout_constraintTop_toBottomOf="@id/et_username"
        app:layout_constraintStart_toStartOf="@id/guideline_left"
        app:layout_constraintEnd_toEndOf="@id/guideline_right"
        android:layout_marginTop="16dp"/>

    <!-- 登录按钮：同时约束顶部和底部，关键！ -->
    <Button
        android:id="@+id/btn_login"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:text="登录"
        android:textSize="16sp"
        app:layout_constraintTop_toBottomOf="@id/et_password"
        app:layout_constraintStart_toStartOf="@id/guideline_left"
        app:layout_constraintEnd_toEndOf="@id/guideline_right"
        app:layout_constraintBottom_toBottomOf="parent"
        android:layout_marginTop="32dp"
        android:layout_marginBottom="32dp"/>

</androidx.constraintlayout.widget.ConstraintLayout>

如果某些机型上adjustResize不生效（比如部分全屏或沉浸式布局的场景），可以通过监听布局变化手动调整内容位置：

class LoginActivity : AppCompatActivity() {
    private lateinit var rootLayout: ConstraintLayout
    private lateinit var loginBtn: Button
    private val originalBottomMargin by lazy {
        (loginBtn.layoutParams as ConstraintLayout.LayoutParams).bottomMargin
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_login)
        rootLayout = findViewById(R.id.login_root)
        loginBtn = findViewById(R.id.btn_login)

        // 监听布局变化
        rootLayout.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
            override fun onGlobalLayout() {
                val visibleFrame = Rect()
                rootLayout.getWindowVisibleDisplayFrame(visibleFrame)
                val screenHeight = rootLayout.rootView.height
                val keyboardHeight = screenHeight - visibleFrame.bottom

                // 判断软键盘是否弹出（阈值设为屏幕高度的20%）
                val params = loginBtn.layoutParams as ConstraintLayout.LayoutParams
                if (keyboardHeight > screenHeight * 0.2) {
                    // 弹出时，把按钮底部边距设为键盘高度，让内容上移
                    params.bottomMargin = keyboardHeight
                } else {
                    // 收起时恢复原边距
                    params.bottomMargin = originalBottomMargin
                }
                loginBtn.layoutParams = params
            }
        })
    }

    override fun onDestroy() {
        super.onDestroy()
        // 移除监听避免内存泄漏
        rootLayout.viewTreeObserver.removeOnGlobalLayoutListener {}
    }
}

• 不要给ConstraintLayout或者输入框的父容器设置固定高度，一定要用约束让布局自适应。
• 如果用了沉浸式状态栏，记得在fitsSystemWindows的基础上，调整状态栏的padding，避免布局被状态栏遮挡。

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