Android 浮动搜索框(SearchManager)

浮动搜索框的使用其实并不难，而是在于它的配置非常之繁琐，对于它的使用主要是方便开发者对于程序中有搜索业务时，更好的设计UI

SearchManager具体使用步骤如下：
（1）配置search bar的相关信息，新建一个位于res/xml下的一个searchable.xml的配置文件，如默认值、是否有搜索建议或者语音搜索。

java代码：

1. <searchable xmlns:android=http://schemas.android.com/apk/res/android
   
2. <!-- label为搜索框上方的文本，hint搜索框里面的提示文本，显示label -->
   
3. android:label="@string/search_label"
   
4. android:hint="@string/search_hint"
   
5. android:searchMode="showSearchLabelAsBadge"
   
6. <!-- 语音搜索配置 -->
   
7. android:voiceSearchMode="showVoiceSearchButton|launchRecognizer"
   
8. android:voiceLanguageModel="free_form"
   
9. android:voicePromptText="@string/search_invoke"
   
10. <!-- 配置搜索建议，配置错误将不会显示，这里的searchSuggestAuthority的值必须是
    
11. 继承自SearchRecentSuggestionsProvider的完整路径名 -->
    
12. android:searchSuggestAuthority="com.android.cbin.SearchSuggestionSampleProvider"
    
13. android:searchSuggestSelection=" ? "
    
14. />

（2）manifest.xml配置，搜索结果处理的Activity将出现两种情况，一种是从其他Activity中的search bar打开一个Activtiy

专门处理搜索结果，第二种是就在当前Activity就是处理结果的Activity，先介绍第一种配置：

java代码：

1. <activity android:name="SearchResultActivity">
   
2. <intent-filter>
   
3. <action android:name="android.intent.action.SEARCH"></action>
   
4. </intent-filter>
   
5. <!-- 指定上面的searchable.xml文件 -->
   
6. <meta-data android:resource="@xml/searchable"
   
7. android:name="android.app.searchable"></meta-data>
   
8. </activity>
   
9. <!-- 为了使每一个Activity都能使用search bar,一定要将这个标签放到启动Activity中，里面的value指定 的是前面的搜索结果Activity-->
   
10. <meta-data android:name="android.app.default_searchable"
    
11. android:value=".SearchResultActivity"
    
12. />

（3）搜索建议在manifest.xml中相关的配置

java代码：

1. <!--之前searchable.xml中有一个searchSuggestAuthority的值其实和这里的
   
2. authorities指向的都是name中所关联的SearchSuggestionSampleProvider，他是一个SearchRecentSuggestionsProvider的子类-->
   
3. <provider android:name="SearchSuggestionSampleProvider"
   
4. android:authorities="com.android.cbin.SearchSuggestionSampleProvider">
   
5. </provider>

（4）为了能够使用search bar 我们必须重写Activity的onSearchRequested的方法，在界面上启动一个search bar但是这个动作不会自动触发，必须通过一个按钮或者菜单的点击事件触发；

java代码：

1. @Override
   
2. public boolean onSearchRequested(){
   
3. 
   
4. 
   
5. String text=etdata.getText().toString();
   
6. Bundle bundle=new Bundle();
   
7. bundle.putString("data", text);
   
8. //打开浮动搜索框（第一个参数默认添加到搜索框的值）
   
9. //bundle为传递的数据
   
10. startSearch("mm", false, bundle, false);
    
11. //这个地方一定要返回真 如果只是super.onSearchRequested方法不但
    
12. //onSearchRequested（搜索框默认值）无法添加到搜索框中,bundle也无法传递出去
    
13. return
    
14. true;
    
15. }

（5）接收query和bundle、保存query值（即搜索建议的列表值）

java代码：

1. public void doSearchQuery(){
   
2. final Intent intent = getIntent();
   
3. //获得搜索框里值
   
4. String query=intent.getStringExtra(SearchManager.QUERY);
   
5. tvquery.setText(query);
   
6. //保存搜索记录
   
7. SearchRecentSuggestions suggestions=new SearchRecentSuggestions(this,
   
8. SearchSuggestionSampleProvider.AUTHORITY, SearchSuggestionSampleProvider.MODE);
   
9. suggestions.saveRecentQuery(query, null);
   
10. if(Intent.ACTION_SEARCH.equals(intent.getAction())){
    
11. //获取传递的数据
    
12. Bundle bundled=intent.getBundleExtra(SearchManager.APP_DATA);
    
13. if(bundled!=null){
    
14. String ttdata=bundled.getString("data");
    
15. tvdata.setText(ttdata);
    
16. }else{
    
17. tvdata.setText("no data");
    
18. }
    
19. }
    
20. }

之前说到了处理结果的Activity将可能出现的两种情况的两种，现在就处理第二种状况，就是假如invoke search bar的
Activity同时也是处理搜索结果的Activity，如果按照之前的方式处理则会出现一种情况，搜索一次就实例化一次Activity,当按返回键的时候会发现老是同一个Activity,其实为了使它只有一个实例化对象，只需简单的配置和代码就能实现

第一:在处理搜索结果Activity的manifest.xml中添加android:launchMode="singleTop"属性
第二:重写Activity的onNewIntent(Intent intent)

java代码：

1. @Override
   
2. public void onNewIntent(Intent intent){
   
3. super.onNewIntent(intent);
   
4. //获得搜索框里值
   
5. String query=intent.getStringExtra(SearchManager.QUERY);
   
6. tvquery.setText(query);
   
7. //保存搜索记录
   
8. SearchRecentSuggestions suggestions=new SearchRecentSuggestions(this,
   
9. SearchSuggestionSampleProvider.AUTHORITY, SearchSuggestionSampleProvider.MODE);
   
10. suggestions.saveRecentQuery(query, null);
    
11. if(Intent.ACTION_SEARCH.equals(intent.getAction())){
    
12. //获取传递的数据
    
13. Bundle bundled=intent.getBundleExtra(SearchManager.APP_DATA);
    
14. if(bundled!=null){
    
15. String ttdata=bundled.getString("data");
    
16. tvdata.setText(ttdata);
    
17. }else{
    
18. tvdata.setText("no data");
    
19. }
    
20. }
    
21. }

相关知识：上面讲到了将最近的搜索值添加到搜索建议中，但却没有提到如果清理搜索建议中的值，与保存相似，SearchRecentSuggestion对象提供了一个clearHistory()方法。

java代码：

1. private void clearSearchHistory() {
   
2. SearchRecentSuggestions suggestions =new SearchRecentSuggestions(this,
   
3. SearchSuggestionSampleProvider.AUTHORITY, SearchSuggestionSampleProvider.MODE);
   
4. suggestions.clearHistory();
   
5. }