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; }