Kotlin으로 EditText 외부 클릭 시 Android 소프트 키보드 숨기는 방법

이 글에서는 Kotlin을 사용하여 Android 앱에서 EditText 외부 영역을 클릭했을 때 소프트 키보드(화면 키보드)를 자동으로 숨기는 방법을 단계별로 알아봅니다.

핵심 원리

소프트 키보드를 숨기려면 InputMethodManager의 hideSoftInputFromWindow() 메서드를 사용합니다. 이 메서드는 현재 포커스를 가진 뷰의 windowToken을 전달받아 해당 뷰에 열려 있는 키보드를 닫아줍니다.

1단계 — 새 프로젝트 생성

Android Studio에서 File → New Project를 선택하고, 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다.

2단계 — activity_main.xml 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp"
    tools:context="MainActivity">
    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal"
        android:hint="Enter text here"
        android:textColor="@android:color/background_dark"
        android:textSize="20sp" />
    <EditText
        android:id="@+id/editText"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal"
        android:onClick="setText"
        android:text="Set Text"
        android:textStyle="bold" />
</LinearLayout>

레이아웃은 TextView, EditText, Button 세 가지 요소로 구성되어 있습니다. 버튼을 누르면 EditText에 입력된 텍스트가 TextView로 복사되면서 키보드도 함께 닫힙니다.

3단계 — MainActivity.kt 작성

src/MainActivity.kt 파일에 아래 코드를 추가합니다.

import android.content.Context
import android.os.Bundle
import android.view.View
import android.view.inputmethod.InputMethodManager
import android.widget.EditText
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    lateinit var editText: EditText
    lateinit var textView: TextView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        editText = findViewById(R.id.editText)
        textView = findViewById(R.id.textView)
        title = "KotlinApp"
    }

    fun setText(view: View) {
        val newText = editText.text.toString()
        textView.text = newText
        closeKeyBoard()
    }

    private fun closeKeyBoard() {
        val view = this.currentFocus
        if (view != null) {
            val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
            imm.hideSoftInputFromWindow(view.windowToken, 0)
        }
    }
}

코드 설명

• currentFocus: 현재 포커스를 가진 뷰(여기서는 EditText)를 반환합니다.
• getSystemService(Context.INPUT_METHOD_SERVICE): 입력 메서드(키보드)를 제어하는 시스템 서비스를 가져옵니다.
• hideSoftInputFromWindow(view.windowToken, 0): 해당 뷰의 windowToken을 기준으로 소프트 키보드를 숨깁니다.

4단계 — AndroidManifest.xml 확인

androidManifest.xml 파일에 아래와 같이 MainActivity가 등록되어 있는지 확인합니다.

<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.q11">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

앱 실행 및 결과 확인

실제 Android 기기를 컴퓨터에 연결한 상태라고 가정하고 진행합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 아이콘을 클릭하세요. 목록에서 본인의 모바일 기기를 선택하면 기본 화면이 표시됩니다.

EditText를 탭해 키보드를 연 후, 화면의 다른 영역이나 Set Text 버튼을 누르면 입력된 텍스트가 TextView에 표시되고 소프트 키보드가 자동으로 사라지는 것을 확인할 수 있습니다.