ActionBar的搜索功能

使用ActionBar SearchView时的注意点：

首先要吐槽一下Android的官方Guide文档，关于用法讲得不明确，可能是一直没更新的原因吧。

本来照着文档搞了一下，hint死活出不来，也无法跳转到搜索结果Activity。

StackOverflow也有人提出了这个问题，答案说得很明白 - 参考链接。

正确用法

1. 在AndroidManifest.xml中为提供SearchView的Activity添加meta-data

   <activity
       android:name=".navigation.NavigationActivity"
       android:label="@string/title_activity_navigation">
       <intent-filter>
           <action android:name="android.intent.action.MAIN" />
           <category android:name="android.intent.category.DEFAULT" />
       </intent-filter>
       <meta-data
           android:name="android.app.default_searchable"
           android:value=".search.SearchResultActivity" />
   </activity>
   

2. 在提供搜索结果的Activity中添加为SearchableInfo用的meta-data

   <activity
       android:name=".search.SearchResultActivity"
       android:label="@string/title_activity_search_result"
       android:launchMode="singleTop">
       <intent-filter>
           <action android:name="android.intent.action.SEARCH" />
       </intent-filter>
        <!--This metadata entry provides further configuration details for searches-->
        <!--that are handled by this activity.-->
       <meta-data
           android:name="android.app.searchable"
           android:resource="@xml/searchable" />
   </activity>
   

3. @xml/searchable文件中的android:hint只能使用string.xml中定义的字符串，不能hard-coded

   <?xml version="1.0" encoding="utf-8"?>
   <searchable xmlns:android="http://schemas.android.com/apk/res/android"
       android:label="@string/app_name"
       android:hint="@string/search_hint">
   </searchable>
   

4. 初始化Menu的时候，获取SearchableInfo

   SearchManager searchManager = (SearchManager)getSystemService(Context.SEARCH_SERVICE);
   SearchView searchView = (SearchView)menu.findItem(R.id.action_search).getActionView();
   searchView.setSearchableInfo(searchManager.getSearchableInfo(getComponentName()));
   

注意点

SearchManager通过ComponentName查找SearchableInfo的时候，对应Component必须满足一定条件：

1. intent-filter包含<action android:name="android.intent.action.SEARCH" />

2. meta-data

   <meta-data
       android:name="android.app.searchable"
       android:resource="@xml/searchable" />
   

另一种方法

既然SearchManager是通过ComponentName来获取SearchableInfo，当然可以直接从提供搜索结果的Activity中获取ComponentName。

SearchManager searchManager = (SearchManager)getSystemService(Context.SEARCH_SERVICE);
SearchView searchView = (SearchView)menu.findItem(R.id.action_search).getActionView();
ComponentName cn = new ComponentName("com.liangfeizc.catykanji", "com.liangfeizc.catykanji.search.SearchResultActivity");
searchView.setSearchableInfo(searchManager.getSearchableInfo(cn));

tips

ComponentName构造函数的第一个参数pkg是Application的Package，不是目标类所在的Package。

The first parameter ComponentName(String pkg, String cls) is application package not the package where the activity is.