當(dāng)您需要在您的應(yīng)用程序中提供搜索服務(wù)時(shí)，您第一個(gè)想到的是您的搜索框要放哪呢？通過(guò)使用Android的搜索框架，應(yīng)用程序?qū)@示一個(gè)自定義搜索對(duì)話(huà)框來(lái)處理用戶(hù)的搜索請(qǐng)求。通過(guò)一個(gè)簡(jiǎn)單的搜索按鈕或從您的應(yīng)用程序中調(diào)用API，搜索對(duì)話(huà)框就會(huì)顯示在屏幕的頂部，并會(huì)自動(dòng)顯示您的應(yīng)用程序圖標(biāo)。如下圖所示：


本文將教你如何為你的應(yīng)用程序提供一個(gè)自定義搜索對(duì)話(huà)框。這樣做，給您的用戶(hù)提供一個(gè)標(biāo)準(zhǔn)化的搜索體驗(yàn)，并能增加如語(yǔ)音搜索和搜索建議等功能。

基礎(chǔ)知識(shí)
Android的搜索框架將代您管理的搜索對(duì)話(huà)框，您不需要自己去開(kāi)發(fā)一個(gè)搜索框，不需要擔(dān)心要把搜索框放什么位置，也不需要擔(dān)心搜索框影響您當(dāng)前的界面。所有的這些工作都由SearchManager類(lèi)來(lái)為您處理（以下簡(jiǎn)稱(chēng)“搜索管理器”），它管理的Android搜索對(duì)話(huà)框的整個(gè)生命周期，并執(zhí)行您的應(yīng)用程序?qū)l(fā)送的搜索請(qǐng)求，返回相應(yīng)的搜索關(guān)鍵字。
當(dāng)用戶(hù)執(zhí)行一個(gè)搜索，搜索管理器將使用一個(gè)專(zhuān)門(mén)的Intent把搜索查詢(xún)的關(guān)鍵字傳給您在配置文件中配置的處理搜索結(jié)果的Activity。從本質(zhì)上講，所有你需要的就是一個(gè)Activity來(lái)接收Intent，然后執(zhí)行搜索，并給出結(jié)果。具體來(lái)說(shuō)，你需要的做的事就包括以下內(nèi)容：
一個(gè)搜索配置
我們用個(gè)XML配置文件來(lái)對(duì)搜索對(duì)話(huà)框進(jìn)行配置，包括一些功能的配置，如文本框，設(shè)置語(yǔ)音搜索和搜索建議中顯示的提示文字等。
一個(gè)用來(lái)處理搜索請(qǐng)求的Activity
這個(gè)Activity用來(lái)接收搜索查詢(xún)的內(nèi)容，然后搜索您的數(shù)據(jù)并顯示搜索結(jié)果。
一種用戶(hù)執(zhí)行搜索的途徑
默認(rèn)情況下，一旦你配置了一個(gè)可搜索的Activity，設(shè)備搜索鍵（如果有）將調(diào)用搜索對(duì)話(huà)框。然而，你應(yīng)該始終提供另一種手段，讓用戶(hù)可以調(diào)用搜索對(duì)話(huà)框，如在選項(xiàng)菜單中的搜索按鈕或其他用戶(hù)界面上的按鈕，因?yàn)椴皇撬械脑O(shè)備提供一個(gè)專(zhuān)門(mén)的搜索鍵。

創(chuàng)建一個(gè)搜索對(duì)話(huà)框配置文件
搜索框配置文件是一個(gè)用來(lái)配置您的應(yīng)用程序中搜索框的設(shè)置的XML文件，這個(gè)文件一般命名為searchable.xml，并且必須保存在項(xiàng)目的res/xml/目錄下。
配置文件的根節(jié)點(diǎn)必須為，可以有一個(gè)或多個(gè)屬性。如下圖所示：

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

  

上面的配置文件中，除android:hint屬性外，其它都是一個(gè)搜索對(duì)話(huà)框必須的配置項(xiàng)，android:label是一個(gè)必須的屬性，它的值為一個(gè)string資源引用，不能直接用字符串，通常會(huì)是應(yīng)用程序的名稱(chēng)（盡管它是一個(gè)必須的屬性，但通常情況下是不顯示出來(lái)的，除非你開(kāi)啟了搜索建議功能）。android:hint是配置搜索框的輸入提示信息，也必須引用string.xml中配置的字符串資源，不能直接使用字符串。
可以配置很多的屬性，但大部分屬性都只是在使用搜索建議和語(yǔ)音搜索時(shí)進(jìn)行配置，盡管如此，我們建議你一定要配置android:hint,用于提示用戶(hù)需要輸入的信息。
接下來(lái)，你需要把這個(gè)配置文件放到你的應(yīng)用程序中。

創(chuàng)建一個(gè)可用于搜索的Activity
當(dāng)用戶(hù)從一個(gè)搜索框執(zhí)行搜索時(shí)，搜索管理器（Search Manager）會(huì)通過(guò)ACTION_SEARCH Intent 把要搜索的內(nèi)容（關(guān)鍵字）發(fā)送到一個(gè)可執(zhí)行搜索的Activity。這個(gè)Acitivity查詢(xún)數(shù)據(jù)并顯示結(jié)果。

定義一個(gè)可搜索的Activity
如果你還沒(méi)有準(zhǔn)備好，那么就創(chuàng)建一個(gè)用來(lái)執(zhí)行搜索的Activity，聲明它可以響應(yīng)ACTION_SEARCH Intent ，并且增加搜索框配置信息。為此，你需要添加一個(gè)元素和一個(gè)元素在你的manifest文件中的節(jié)點(diǎn)。如下所示：

    
<application ... >
    <activity android:name=".MySearchableActivity" >
        <intent-filter>
            <action android:name="android.intent.action.SEARCH" />
        </intent-filter>
        <meta-data android:name="android.app.searchable"
                   android:resource="@xml/searchable"/>
    </activity>
    ...
</application>

  

中的android:name屬性值必須為”android.app.searchable”，android:resource屬性值必須引用上面提到的res/xml/目錄下的搜索配置文件（本例中的res/xml/searchable.xml）。
請(qǐng)注意，只有配置了上面的meta-data節(jié)點(diǎn)的Activity的節(jié)點(diǎn)才能執(zhí)行搜索，如果想在整個(gè)應(yīng)用程序中都可以調(diào)用搜索框，可以進(jìn)行如下配置：

    
<application ... >
    <activity android:name=".MySearchableActivity" >
        <intent-filter>
            <action android:name="android.intent.action.SEARCH" />
        </intent-filter>
        <meta-data android:name="android.app.searchable"
                   android:resource="@xml/searchable"/>
    </activity>
    <activity android:name=".AnotherActivity" ... >
    </activity>
    <!—這個(gè)配置就可以讓你在整個(gè)應(yīng)用程序中調(diào)用搜索框 -->
    <meta-data android:name="android.app.default_searchable"
               android:value=".MySearchableActivity" />
    ...
</application>

  

上面代碼中android:name=”android.app.default_searchable” 定義一個(gè)響應(yīng)搜索框搜索請(qǐng)求的名稱(chēng)，android:value指定是由哪個(gè)Activity響應(yīng)并執(zhí)行搜索。當(dāng)我們?cè)趹?yīng)用程序中的OtherAcitivity中執(zhí)行搜索請(qǐng)求時(shí)，MySearchableActivity將會(huì)被加載用于執(zhí)行搜索并顯示搜索結(jié)果。

執(zhí)行一個(gè)搜索
當(dāng)一個(gè)Activity聲明為可搜索時(shí)，執(zhí)行實(shí)際的搜索包括三個(gè)步驟：接收查詢(xún)，檢索你的數(shù)據(jù)，并提交結(jié)果。
通常情況下，你的搜索結(jié)果需要在一個(gè)ListView中展現(xiàn)，所以你用于執(zhí)行搜索的Acitivity要繼承ListActivity，這樣，可以方便的訪問(wèn)ListView的Api。

接收搜索查詢(xún)
當(dāng)從搜索對(duì)話(huà)框執(zhí)行搜索時(shí)，剛才配置的可用于搜索的Acitivity將會(huì)被Intent激活，同時(shí)帶著一些搜索相關(guān)的參數(shù)，你需要檢查Intent并做出搜索響應(yīng)，如下所示：

    
@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.search);
 
    Intent intent = getIntent();
//判斷是否是搜索請(qǐng)求
    if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
//獲取搜索的查詢(xún)內(nèi)容（關(guān)鍵字）
      String query = intent.getStringExtra(SearchManager.QUERY);
//執(zhí)行相應(yīng)的查詢(xún)動(dòng)作
      doMySearch(query);
    }
}

  

doMySearch()方法將根據(jù)關(guān)鍵字查詢(xún)數(shù)據(jù)庫(kù)，或從網(wǎng)絡(luò)上查詢(xún)數(shù)據(jù)，如果是耗時(shí)的搜索，你還需要使用進(jìn)度條，來(lái)告訴用戶(hù)搜索正在進(jìn)行，最后返回結(jié)果后，可以調(diào)用ListView的setAdapter()方法將結(jié)果顯示在ListView中。

調(diào)用搜索對(duì)話(huà)框
你可以從應(yīng)用程序中的任何一個(gè)地方調(diào)用onSearchRequested()方法激活搜索框，比如從菜單中或者一個(gè)按鈕等。你也要以在onCreate()方法中調(diào)用setDefaultKeyMode(DEFAULT_KEYS_SEARCH_LOCAL)，這樣，當(dāng)用戶(hù)按下鍵盤(pán)上的按鍵時(shí)，將會(huì)自動(dòng)激活搜索框。

搜索框和普通對(duì)話(huà)框一樣，浮動(dòng)在屏幕的最上方，它不會(huì)改變?nèi)魏蜛ctivity堆棧狀態(tài)，沒(méi)有任何Activity生命周期中的方法會(huì)被調(diào)用，只是當(dāng)搜索框出現(xiàn)就，正在運(yùn)行的Activity會(huì)失去輸入焦點(diǎn)。

如果你要在執(zhí)行搜索時(shí)，進(jìn)行別的操作，可以重寫(xiě)onSearchRequested()方法，如下所示：

    
@Override
public boolean onSearchRequested() {
//這個(gè)方法中干你想干的事，比如做一些被始化工作
    pauseSomeStuff();
    return super.onSearchRequested();
}

  

如果當(dāng)前的Activity就是響應(yīng)搜索請(qǐng)求的Activity時(shí)，會(huì)有以下兩種情況：
默認(rèn)情況下，ACTION_SEARCH Intent將會(huì)創(chuàng)建一個(gè)新的Activity，并調(diào)用onCreate()方法，這個(gè)新的Activity會(huì)顯示在最前面，你將同時(shí)有兩個(gè)Activity實(shí)例。當(dāng)你按“返回”鍵里，會(huì)回到?jīng)]有執(zhí)行搜索前的一個(gè)Activity。
另一種情況是配置了android:launchMode=”singleTop”的Activity，這時(shí)，我們需要
在 onNewIntent(Intent)方法中處理搜索請(qǐng)求，如下所示：

    
@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.search);
    handleIntent(getIntent());
}
 
@Override
protected void onNewIntent(Intent intent) {
    setIntent(intent);
    handleIntent(intent);
}
 
private void handleIntent(Intent intent) {
    if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
      String query = intent.getStringExtra(SearchManager.QUERY);
      doMySearch(query);
    }
}

  

相應(yīng)的Activity配置如下

    
<activity android:name=".MySearchableActivity"
              android:launchMode="singleTop" >
    <intent-filter>
        <action android:name="android.intent.action.SEARCH" />
    </intent-filter>
    <meta-data android:name="android.app.searchable"
                      android:resource="@xml/searchable"/>
  </activity>

  

如何給搜索框增加參數(shù)？
要給搜索框傳遞參數(shù)，我們需要重寫(xiě)onSearchRequested()方法，如下所示：

    
@Override
public boolean onSearchRequested() {
     Bundle appData = new Bundle();
     appData.putBoolean(MySearchableActivity.JARGON, true);
     startSearch(null, false, appData, false);
     return true;
 }

  

我們的Activity在收到搜索框的搜索請(qǐng)求時(shí)，通過(guò)如下方法獲取參數(shù)：

    
Bundle appData = getIntent().getBundleExtra(SearchManager.APP_DATA);
 if (appData != null) {
     boolean jargon = appData.getBoolean(MySearchableActivity.JARGON);
 }

  

最后我們來(lái)看看如何使用android的語(yǔ)音搜索：
只需要對(duì)我們的搜索配置文件做如下改動(dòng)，你的搜索就支持語(yǔ)音搜索了，配置文件如下所示：

    
<?xml version="1.0" encoding="utf-8"?>
<searchable xmlns:android="http://schemas.android.com/apk/res/android"
    android:label="@string/searchLabel"
    android:hint="@string/searchHint"
    android:voiceSearchMode="showVoiceSearchButton|launchRecognizer">
</searchable>

  

好了，今天就到這兒，自己動(dòng)手練習(xí)去吧！以后還會(huì)詳細(xì)講解如何增加搜索建議，語(yǔ)音搜索等內(nèi)容。

示例程序下載：http://www.ideasandroid.com/android/demo/FloatSearchBoxDemo.rar

在調(diào)用系統(tǒng)搜索框搜索自己的數(shù)據(jù)時(shí)，怎么增加搜索建議功能呢？
可參考 http://www.ideasandroid.com/android/sdk/docs/guide/topics/search/adding-custom-suggestions.html

簡(jiǎn)單使用Android Search Dialog
http://bigcat.easymorse.com/?p=655

Android系統(tǒng)搜索對(duì)話(huà)框（浮動(dòng)搜索框）的使用