Android 浮动搜索框 searchable 使用

转自：http://it.warmtel.com/?p=1328

Android为程序的搜索功能提供了统一的搜索接口，search dialog和search widget，这里介绍search dialog使用。
search dialog 只能为于activity窗口的上方。下面以点击EditText输入框启动search dialog搜索框为例:
效果如下

实现步骤：

1. 新建searchable.xml配置文件，放在res/xml目录下。
searchable.xml用于配置搜索框相关属性,配置文件内容为:

 <?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"/>

注:android:lable是唯一必须定义的属性。它指向一个字符串，是应用程序的名字。
实际上该label也只有在search suggestions for Quick Search Box可用时才可见。
android:hint属性不是必须，但是还是推荐总是定义它。它是search box用户输入前输入框中的提示语。

其它属性可以查看google官方文档:

<?xml version="1.0" encoding="utf-8"?>
    <searchable xmlns:android="http://schemas.android.com/apk/res/android"
        android:label="string resource"
        android:hint="string resource"
        android:searchMode=["queryRewriteFromData" | "queryRewriteFromText"]
        android:searchButtonText="string resource"
        android:inputType="inputType"
        android:imeOptions="imeOptions"
        android:searchSuggestAuthority="string"
        android:searchSuggestPath="string"
        android:searchSuggestSelection="string"
        android:searchSuggestIntentAction="string"
        android:searchSuggestIntentData="string"
        android:searchSuggestThreshold="int"
        android:includeInGlobalSearch=["true" | "false"]
        android:searchSettingsDescription="string resource"
        android:queryAfterZeroResults=["true" | "false"]
        android:voiceSearchMode=["showVoiceSearchButton" | "launchWebSearch" | "launchRecognizer"]
        android:voiceLanguageModel=["free-form" | "web_search"]
        android:voicePromptText="string resource"
        android:voiceLanguage="string"
        android:voiceMaxResults="int"
        >
        <actionkey
            android:keycode="KEYCODE"
            android:queryActionMsg="string"
            android:suggestActionMsg="string"
            android:suggestActionMsgColumn="string" >
    </searchable>

2. 在AndroidManifest.xml文件中声明Searchable Activity。
Searchable Activity为搜索结果显示Activity，可以定义为搜索框所在的当前Activity，也可以单独定义一个Activity
这里直接定义当前搜索框所在SearchActivity.配置如下:

<application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
       <meta-data
            android:name="android.app.default_searchable"
            android:value=".SearchActivity"/>

        <activity android:name=".SearchActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <intent-filter>
                <action android:name="android.intent.action.SEARCH" />
            </intent-filter>

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

    </application>

注:activity标签内的标签必须包括android:name这个属性，而且其值必须为”android.app.searchable”，
还必须包括android:resource这个属性，它指定了我们的search dialog的配置文件。(res/xml/searchable.xml).

3.启动搜索框search dailog：
在activity中调用onSearchRequested()方法

 @Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.search_edit:
                onSearchRequested();
                break;
        }
    }

4. 获取搜索关键字
搜索框中输入的搜索关键字通过下面代码可以取到:
String query = intent.getStringExtra(SearchManager.QUERY);
但在获取前应该先判断Intent中action是否为搜索action:”android.intent.action.SEARCH”

Intent intent = getIntent();
        if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
            String query = intent.getStringExtra(SearchManager.QUERY);
          
        }
  

5.搜索结果处理方式
在前面已经提过，搜索结果可以在单独一个类里处理，也可以在当前搜索框所在类处理,如果在当前搜索框所在类处理，需设置当前类为SingTop模式，防止再次创建Activity. 但这样又会引发一个问题，搜索时onCreate方法不会在执行，而在可以执行的onResult方法中得到的Intent不包含搜索Action:”android.intent.action.SEARCH”,而是原来的Action。
这说明搜索执行后Intent已经被改变，Activity中通过getIntent()取到的Intent还是原来的Intent。那么被改变的Intent从那里获取呢？
重写 onNewIntent(Intent intent) 获取，执行 setIntent(intent) 更新Activity中Intent,

 @Override
    protected void onNewIntent(Intent intent) {
        setIntent(intent);
    }

    @Override
    protected void onResume() {
        super.onResume();
        if (getIntent().ACTION_SEARCH.equals(getIntent().getAction())) {
            String query = intent.getStringExtra(SearchManager.QUERY);
        }
   }

综上在当前搜索框所在类获取搜索关键字处理搜索结果可以这样写：

 @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_search_dialog_layout);
        mSearchEdit = (EditText) findViewById(R.id.search_edit);
        mContentTxt = (TextView)findViewById(R.id.search_content_txt);
        mSearchEdit.setOnClickListener(this);
        handleIntent(getIntent());
    }

    /**
     * 重复刷新当前Activity时执行
     * @param intent
     */
    @Override
    protected void onNewIntent(Intent intent) {
        setIntent(intent);
        handleIntent(intent);
    }

    private void handleIntent(Intent intent) {
        if (getIntent().ACTION_SEARCH.equals(getIntent().getAction())) {
            String query = intent.getStringExtra(SearchManager.QUERY);
            doMySearch(query);
        }
    }
    /**
     *   处理搜索结果
     */
    public void doMySearch(String query){
        mContentTxt.setText(query);
    }