이 튜토리얼에서는 안드로이드 앱의 툴바(Toolbar)에 SearchView를 추가하고, 이를 활용해 리스트뷰(ListView) 항목을 실시간으로 검색·필터링하는 방법을 단계별로 알아보겠습니다.
Step 1 – 새 프로젝트 생성
Android Studio를 실행한 뒤, 상단 메뉴에서 File → New Project를 선택하고 프로젝트 생성에 필요한 정보를 모두 입력하여 새 프로젝트를 만듭니다.
Step 2 – 레이아웃 작성 (activity_main.xml)
res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 툴바와 리스트뷰, 그리고 검색 결과가 없을 때 표시할 빈 화면용 TextView로 구성되어 있습니다.
<?xml version="1.0" encoding="utf-8"?> <RelativeLayout 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" xmlns:app="https://schemas.android.com/apk/res-auto" tools:context=".MainActivity"> <android.support.v7.widget.Toolbar android:id="@+id/toolbar" android:layout_width="match_parent" android:layout_height="wrap_content" android:background="?attr/colorPrimary" android:minHeight="?attr/actionBarSize" app:actionViewClass="android.support.v7.widget.SearchView" app:theme="@style/ThemeOverlay.AppCompat.Dark" /> <ListView android:id="@+id/listView" android:layout_width="match_parent" android:layout_height="wrap_content" /> <TextView android:id="@+id/emptyView" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_centerInParent="true" android:text="No Results" android:textSize="20sp" android:visibility="gone"/> </RelativeLayout>
Step 3 – MainActivity 구현
src/MainActivity.java 파일에 아래 코드를 추가합니다. 여기서는 SearchView의 OnQueryTextListener를 등록해, 사용자가 검색어를 입력할 때마다 어댑터의 필터를 호출하여 리스트를 실시간으로 갱신합니다.
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.SearchView;
import android.support.v7.widget.Toolbar;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast;
public class MainActivity extends AppCompatActivity {
Toolbar toolbar;
ArrayAdapter adapter;
ListView listView;
TextView emptyView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
toolbar = findViewById(R.id.toolbar);
listView = findViewById(R.id.listView);
emptyView = findViewById(R.id.emptyView);
adapter = new ArrayAdapter(this, android.R.layout.simple_list_item_1,
getResources().getStringArray(R.array.months_array));
listView.setAdapter(adapter);
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> adapterView, View view, int i, long l) {
Toast.makeText(MainActivity.this, adapterView.getItemAtPosition(i).toString(), Toast.LENGTH_SHORT).show();
}
});
listView.setEmptyView(emptyView);
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.menu, menu);
MenuItem mSearch = menu.findItem(R.id.appSearchBar);
SearchView mSearchView = (SearchView) mSearch.getActionView();
mSearchView.setQueryHint("Search");
mSearchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
@Override
public boolean onQueryTextSubmit(String query) {
return false;
}
@Override
public boolean onQueryTextChange(String newText) {
adapter.getFilter().filter(newText);
return true;
}
});
return super.onCreateOptionsMenu(menu);
}
}Step 4 – 메뉴 리소스 생성 (menu.xml)
프로젝트에서 마우스 오른쪽 버튼을 클릭한 뒤 New → Android Resource Directory를 선택하고 리소스 타입을 menu로 지정합니다. 그다음 res/menu 폴더에서 오른쪽 클릭 후 New → Menu Resource File을 선택해 menu.xml 파일을 만들고 아래 코드를 추가합니다.
<?xml version="1.0" encoding="utf-8"?> <menu xmlns:android="https://schemas.android.com/apk/res/android" xmlns:app="https://schemas.android.com/apk/res-auto"> <item android:id="@+id/appSearchBar" android:icon="@drawable/ic_search" android:title="Search" app:showAsAction="ifRoom|withText" app:actionViewClass="android.support.v7.widget.SearchView"/> </menu>
Step 5 – 문자열 리소스 추가 (strings.xml)
res/values/strings.xml 파일을 열고 아래 코드를 추가합니다. 여기에는 검색 대상이 될 12개월 이름 배열이 포함되어 있습니다.
<resources> <string name="app_name">Sample</string> <string-array name="months_array"> <item>January</item> <item>February</item> <item>March</item> <item>April</item> <item>May</item> <item>June</item> <item>July</item> <item>August</item> <item>September</item> <item>October</item> <item>November</item> <item>December</item> </string-array> </resources>
Step 6 – 매니페스트 설정 (AndroidManifest.xml)
AndroidManifest.xml 파일에 아래 코드가 올바르게 설정되어 있는지 확인합니다.
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample"> <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 Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run(실행) 아이콘을 클릭하세요. 실행 옵션에서 본인의 모바일 기기를 선택하면, 기기 화면에 아래와 같은 기본 화면이 표시됩니다.
