[Android] 키보드가 화면 레이아웃에 영향 주지 않게 하는 방법 (완벽 가이드)

Android 개발: 키보드가 화면 레이아웃에 영향을 주지 않게 하는 방법

안녕하세요.
이번 포스팅은 Android 개발을 하면서 화면 하단에 있던 소프트 키보드가 화면 위로 올라오면서 화면 레이아웃이 밀어올리거나 가리는 현상이 발생하여, 해당 원인이 무엇이며 해결방법이 무엇인지 쉽고 자세하게 알아보도록 하겠습니다.

---

#1. Android 앱에서 키보드 문제가 발생하는 이유

Android 앱을 개발하다 보면 가장 흔하게 마주치는 문제 중 하나가 바로 소프트 키보드가 화면 레이아웃을 밀어올리거나 가리는 현상입니다. 특히 로그인 화면이나 채팅 앱처럼 사용자 입력이 많은 화면에서 이 문제는 더욱 두드러집니다.

키보드가 나타나면 다음과 같은 문제가 발생할 수 있습니다:

• 화면 하단의 중요한 버튼이나 컨텐츠가 키보드에 가려짐
• 전체 레이아웃이 위로 밀려 올라가 UI가 망가짐
• 입력 필드가 키보드에 가려져 사용자가 자신이 무엇을 입력하는지 볼 수 없음

이런 문제를 해결하기 위한 방법을 단계별로 알아보겠습니다.

1. 안드로이드 매니페스트 설정으로 키보드 제어하기

가장 먼저 시도해볼 수 있는 방법은 AndroidManifest.xml 파일에서 액티비티의 windowSoftInputMode 속성을 설정하는 것입니다.

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

주요 windowSoftInputMode 옵션

옵션	설명	효과
adjustResize	키보드가 표시될 때 레이아웃의 크기를 조정	키보드가 나타나면 화면 크기가 줄어들고 모든 요소가 재배치됨
adjustPan	키보드가 표시될 때 레이아웃을 위로 밀어올림	현재 포커스된 요소가 항상 보이도록 화면을 이동시킴
adjustNothing	키보드가 표시될 때 레이아웃 변경 없음	키보드가 화면의 일부를 가릴 수 있음
stateHidden	액티비티 시작 시 키보드를 숨김	처음에 키보드가 표시되지 않음
stateAlwaysHidden	항상 키보드를 숨김	입력 필드 터치해도 자동으로 키보드가 나타나지 않음
stateVisible	액티비티 시작 시 키보드를 표시	처음부터 키보드가 나타남
stateAlwaysVisible	항상 키보드를 표시	키보드가 계속 표시됨

여러 옵션을 조합할 수도 있습니다:

android:windowSoftInputMode="adjustPan|stateHidden"

2. ConstraintLayout으로 키보드 문제 해결하기

안드로이드 개발에서 ConstraintLayout을 사용하면 레이아웃의 복잡한 배치를 쉽게 제어할 수 있습니다. 키보드 문제 해결에도 효과적입니다.

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 상단 컨텐츠 -->
    <TextView
        android:id="@+id/header_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="로그인"
        android:textSize="24sp"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        android:layout_marginTop="50dp" />

    <!-- 중간 입력 필드 -->
    <EditText
        android:id="@+id/username_input"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:hint="사용자 이름"
        android:layout_marginTop="20dp"
        android:layout_marginStart="20dp"
        android:layout_marginEnd="20dp"
        app:layout_constraintTop_toBottomOf="@id/header_text"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent" />

    <EditText
        android:id="@+id/password_input"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:hint="비밀번호"
        android:inputType="textPassword"
        android:layout_marginTop="12dp"
        android:layout_marginStart="20dp"
        android:layout_marginEnd="20dp"
        app:layout_constraintTop_toBottomOf="@id/username_input"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent" />

    <!-- 하단 버튼 (키보드에 가려질 수 있는 부분) -->
    <Button
        android:id="@+id/login_button"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:text="로그인"
        android:layout_marginStart="20dp"
        android:layout_marginEnd="20dp"
        android:layout_marginBottom="30dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

3. ScrollView로 키보드 문제 해결하기

긴 폼이나 많은 입력 필드가 있는 화면에서는 ScrollView를 활용하는 것이 좋습니다.

<?xml version="1.0" encoding="utf-8"?>
<ScrollView 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fillViewport="true">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical"
        android:padding="16dp">

        <!-- 여러 입력 필드들 -->
        <EditText
            android:id="@+id/name_input"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:hint="이름"
            android:layout_marginBottom="12dp" />

        <EditText
            android:id="@+id/email_input"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:hint="이메일"
            android:inputType="textEmailAddress"
            android:layout_marginBottom="12dp" />

        <!-- 더 많은 입력 필드 추가 가능 -->

        <Button
            android:id="@+id/submit_button"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="제출하기"
            android:layout_marginTop="24dp" />

    </LinearLayout>
</ScrollView>

ScrollView를 사용할 때 주의할 점:

• android:fillViewport="true"를 설정하여 스크롤 뷰가 전체 화면을 채우도록 합니다.
• ScrollView 안에는 하나의 직접적인 자식 뷰만 가능합니다 (보통 LinearLayout이나 ConstraintLayout).

4. 프로그래밍 방식으로 키보드 제어하기

코드에서 직접 키보드를 제어하고 싶다면 다음과 같은 방법을 사용할 수 있습니다:

키보드 표시하기

// Java
private void showKeyboard(View view) {
    InputMethodManager imm = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
    if (imm != null) {
        view.requestFocus();
        imm.showSoftInput(view, InputMethodManager.SHOW_IMPLICIT);
    }
}

// Kotlin
private fun showKeyboard(view: View) {
    val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as? InputMethodManager
    imm?.let {
        view.requestFocus()
        it.showSoftInput(view, InputMethodManager.SHOW_IMPLICIT)
    }
}

키보드 숨기기

// Java
private void hideKeyboard() {
    View view = getCurrentFocus();
    if (view != null) {
        InputMethodManager imm = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
        if (imm != null) {
            imm.hideSoftInputFromWindow(view.getWindowToken(), 0);
        }
    }
}

// Kotlin
private fun hideKeyboard() {
    currentFocus?.let { view ->
        val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as? InputMethodManager
        imm?.hideSoftInputFromWindow(view.windowToken, 0)
    }
}

특정 이벤트에서 키보드 제어하기

예를 들어, 버튼 클릭 시 키보드를 숨기려면:

// Kotlin
submitButton.setOnClickListener {
    hideKeyboard()
    // 다른 로직 수행
}

5. 키보드 높이 측정하여 UI 조정하기

때로는 키보드 높이를 정확히 알고 그에 맞게 UI를 조정해야 할 필요가 있습니다.

// Kotlin
private fun setupKeyboardHeightObserver() {
    val rootView = findViewById<View>(android.R.id.content)
    rootView.viewTreeObserver.addOnGlobalLayoutListener {
        val rect = Rect()
        rootView.getWindowVisibleDisplayFrame(rect)

        val screenHeight = rootView.height
        val keyboardHeight = screenHeight - rect.bottom

        if (keyboardHeight > screenHeight * 0.15) { // 키보드가 표시됨
            // 키보드 높이에 따라 UI 조정
            bottomContainer.translationY = -keyboardHeight.toFloat()
        } else { // 키보드가 숨겨짐
            bottomContainer.translationY = 0f
        }
    }
}

6. 실전 예제: 채팅 앱 UI 구현하기

채팅 앱은 키보드 관련 문제가 가장 흔히 발생하는 앱 중 하나입니다. 다음은 키보드가 표시되어도 메시지 입력창이 항상 보이도록 하는 레이아웃입니다:

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 채팅 메시지 목록 -->
    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recycler_chat"
        android:layout_width="0dp"
        android:layout_height="0dp"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintBottom_toTopOf="@id/layout_chat_input"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent" />

    <!-- 메시지 입력 영역 -->
    <LinearLayout
        android:id="@+id/layout_chat_input"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:padding="8dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent">

        <EditText
            android:id="@+id/edit_message"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:hint="메시지 입력..."
            android:padding="12dp"
            android:background="@drawable/bg_rounded_edittext" />

        <ImageButton
            android:id="@+id/button_send"
            android:layout_width="48dp"
            android:layout_height="48dp"
            android:layout_marginStart="8dp"
            android:src="@drawable/ic_send"
            android:background="?attr/selectableItemBackgroundBorderless"
            android:contentDescription="메시지 보내기" />
    </LinearLayout>
</androidx.constraintlayout.widget.ConstraintLayout>

이 레이아웃에서 메시지 입력 영역은 항상 화면 하단에 고정되어 있고, 키보드가 나타나면 RecyclerView의 크기가 조정됩니다. AndroidManifest.xml에서는 android:windowSoftInputMode="adjustResize"를 설정해 주어야 합니다.

// 키보드가 나타날 때 자동으로 스크롤을 최신 메시지로 이동
private fun setupKeyboardVisibilityListener() {
    val rootView = findViewById<View>(android.R.id.content)
    rootView.viewTreeObserver.addOnGlobalLayoutListener {
        val rect = Rect()
        rootView.getWindowVisibleDisplayFrame(rect)

        val screenHeight = rootView.height
        val keyboardHeight = screenHeight - rect.bottom

        if (keyboardHeight > screenHeight * 0.15) { // 키보드가 표시됨
            // 마지막 메시지로 스크롤
            recyclerChat.scrollToPosition(adapter.itemCount - 1)
        }
    }
}

7. 디바이스별 테스트의 중요성

서로 다른 안드로이드 기기마다 화면 크기와 키보드 높이가 다르기 때문에, 다양한 디바이스에서 테스트하는 것이 중요합니다:

1. 작은 화면 스마트폰 (5인치 이하)
2. 큰 화면 스마트폰 (6인치 이상)
3. 태블릿
4. 다양한 안드로이드 버전

8. 마무리 및 요약

키보드가 레이아웃에 영향을 주지 않게 하는 방법을 정리하면:

1. AndroidManifest.xml 설정
   • adjustPan: 키보드가 포커스된 영역을 가리지 않도록 화면을 이동
   • adjustResize: 키보드 영역을 제외한 나머지 부분으로 화면 크기 조정
   • adjustNothing: 키보드가 화면을 가릴 수 있음
2. 레이아웃 최적화
   • ConstraintLayout 사용으로 유연한 UI 구성
   • ScrollView 사용으로 내용 스크롤 가능하게 구성
   • 입력 필드와 중요 버튼의 적절한 배치
3. 프로그래밍 방식의 제어
   • InputMethodManager를 사용한 키보드 표시/숨기기
   • 키보드 상태 감지 및 높이 측정
   • UI 동적 조정

이러한 방법들을 조합하여 사용하면 키보드가 나타나도 앱의 사용성을 해치지 않는 UI를 구현할 수 있습니다. 사용자 경험을 최우선으로 고려하여 키보드 관련 문제를 해결해 보세요!

 

#2. 자주 묻는 질문

Q: adjustPan과 adjustResize 중 어떤 것을 사용해야 할까요?

A: 입력 필드가 많은 폼이나 스크롤 가능한 콘텐츠가 있는 화면에서는 adjustResize가 더 적합합니다. 단순한 화면이나 고정된 레이아웃이 필요한 경우에는 adjustPan이 유용할 수 있습니다.

Q: 키보드가 자동으로 나타나지 않게 하려면 어떻게 해야 하나요?

A: AndroidManifest.xml에서 android:windowSoftInputMode="stateHidden"을 설정하거나, 코드에서 editText.setFocusable(false)와 같이 입력 필드의 포커스를 제어할 수 있습니다.

Q: 특정 EditText에서 다음 EditText로 포커스 이동하는 방법은 무엇인가요?

A: android:imeOptions="actionNext"와 android:nextFocusDown 속성을 사용하여 키보드의 다음 버튼을 누를 때 포커스를 다음 입력 필드로 이동시킬 수 있습니다.

---

긴 글 읽어주셔서 감사합니다.

끝.

 

관련 자료

• 안드로이드 공식 문서: 소프트 키보드 처리
• ConstraintLayout 가이드
• InputMethodManager API 참조