其餘回溯相容

試試 Compose
Jetpack Compose 是 Android 推薦的 UI 工具包。瞭解如何在 Compose 中新增搜尋功能。
篩選清單 →

SearchView 和動作列僅適用於 Android 3.0 以上版本。如要支援舊版平台，可以改用搜尋對話方塊。搜尋對話方塊是系統提供的 UI，在叫用時會疊加在應用程式上方。

設定最低和目標 API 級別

如要設定搜尋對話方塊，請先在資訊清單中宣告您要支援舊版裝置，但目標是 Android 3.0 以上版本。這麼做之後，應用程式會在 Android 3.0 以上版本自動使用動作列，並在舊版裝置上使用傳統選單系統：

<uses-sdk android:minSdkVersion="7" android:targetSdkVersion="15" />

<application>
...

為舊版裝置提供搜尋對話方塊

如要在舊版裝置上叫用搜尋對話方塊，請在使用者從選項選單選取搜尋選單項目時呼叫 onSearchRequested()。由於 Android 3.0 以上版本的裝置會在動作列中顯示 SearchView (如第一堂課所示)，因此只有 3.0 之前的版本會在使用者選取搜尋選單項目時呼叫 onOptionsItemSelected()。

Kotlin

override fun onOptionsItemSelected(item: MenuItem): Boolean {
    return when (item.itemId) {
        R.id.search -> {
            onSearchRequested()
            true
        }
        else -> false
    }
}

Java

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
        case R.id.search:
            onSearchRequested();
            return true;
        default:
            return false;
    }
}

在執行階段檢查 Android 建構版本

在執行階段，請檢查裝置版本，確保舊版裝置不會發生不支援的 SearchView 用法。在我們的範例程式碼中，這發生在 onCreateOptionsMenu() 方法中：

Kotlin

override fun onCreateOptionsMenu(menu: Menu): Boolean {

    menuInflater.inflate(R.menu.options_menu, menu)

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
        val searchManager = getSystemService(Context.SEARCH_SERVICE) as SearchManager
        (menu.findItem(R.id.search).actionView as SearchView).apply {
            setSearchableInfo(searchManager.getSearchableInfo(componentName))
            setIconifiedByDefault(false)
        }
    }
    return true
}

Java

@Override
public boolean onCreateOptionsMenu(Menu menu) {

    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.options_menu, menu);

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
        SearchManager searchManager =
                (SearchManager) getSystemService(Context.SEARCH_SERVICE);
        SearchView searchView =
                (SearchView) menu.findItem(R.id.search).getActionView();
        searchView.setSearchableInfo(
                searchManager.getSearchableInfo(getComponentName()));
        searchView.setIconifiedByDefault(false);
    }
    return true;
}