Android 앱에서 AutoCompleteTextView 사용하는 방법 완벽 가이드

이 튜토리얼에서는 Android 앱에서 AutoCompleteTextView를 사용하여 자동완성 기능을 구현하는 방법을 단계별로 알아봅니다. AutoCompleteTextView는 사용자가 입력한 글자에 따라 제안 목록을 보여주는 편집 가능한 텍스트 뷰로, 검색창이나 입력 폼에서 매우 유용하게 활용됩니다.

1단계: 새 프로젝트 생성

Android Studio를 실행하고 File ⇒ New Project 메뉴로 이동한 후, 새 프로젝트 생성에 필요한 모든 세부 정보를 입력하여 새 프로젝트를 만듭니다.

2단계: 레이아웃 파일 작성

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:layout_margin="16dp"
    android:orientation="vertical"
    tools:context=".MainActivity">

    <android.support.v7.widget.AppCompatAutoCompleteTextView
        android:id="@+id/autoTextView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="Enter fruit name"
        android:textColor="#000000"
        android:textColorHint="#000000" />

</LinearLayout>

여기서 AppCompatAutoCompleteTextView는 하위 호환성을 지원하는 자동완성 텍스트 뷰 위젯입니다. hint 속성으로 입력 전 안내 문구를 표시할 수 있습니다.

3단계: MainActivity 작성

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

package app.tutorialspoint.com.sample;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.AppCompatAutoCompleteTextView;
import android.widget.ArrayAdapter;

public class MainActivity extends AppCompatActivity {

    private String[] fruits = {"Apple", "Banana", "Cherry", "Date", "Grape", "Kiwi", "Mango", "Pear"};

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        AppCompatAutoCompleteTextView autoTextView = findViewById(R.id.autoTextView);
        ArrayAdapter<String> adapter = new ArrayAdapter<>(this,
                android.R.layout.select_dialog_item, fruits);

        autoTextView.setThreshold(1); // 첫 번째 글자부터 자동완성 시작
        autoTextView.setAdapter(adapter);
    }
}

핵심 포인트:

• ArrayAdapter를 사용해 과일 이름 배열을 어댑터로 연결합니다.
• setThreshold(1)은 사용자가 한 글자만 입력해도 자동완성 제안이 나타나도록 설정합니다.
• setAdapter()로 데이터 소스를 위젯에 연결합니다.

4단계: AndroidManifest.xml 확인

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

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.tutorialspoint.com.sample">

    <uses-permission android:name="android.permission.VIBRATE" />

    <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(실행) 아이콘을 클릭하세요. 실행 옵션에서 모바일 기기를 선택하면 기기 화면에 아래와 같은 결과가 표시됩니다.

텍스트 필드에 글자를 입력하면 입력한 문자와 일치하는 과일 이름 목록이 드롭다운 형태로 나타나며, 원하는 항목을 선택하면 해당 값이 자동으로 입력됩니다.