Android ApiDemos示例解析(36)：App->Search->Invoke Search

Search (搜索）是Android平台的一个核心功能之一，用户可以在手机搜索在线的或是本地的信息。Android平台为所有需要提供搜索或是查询功能的应用提供了一个统一的Search Framework来帮助实现Search功能。Search Framework的UI可以有两种形式：

• 屏幕顶部的Search Dialog：如Google Map提供的搜索条。
• 可以嵌到ContentView中的SearchView，应用可以将它放在屏幕上任何地方。

不管采用那种UI，Android系统都可以通过向某个指定Activity发送需要查询的内容来帮助应用实现查询功能。同时Android也支持查询提示，如下图所示：

除此之外，Android查询UI可以支持：

• 语音查询
• 根据用户输入提供查询提示列表
• 支持应用自定义查询提示列表来匹配用户输入
• 在系统全局搜索(System-wide Quick Search Box)提供你的应用相关的查询提示列表

Invoke Search介绍了如何使用Search Framework 并采用Search dialog 的方式在屏幕顶部显示查询条。下面结合例子介绍使用Search Framework的一般步骤：

Create a Search Interface

本例采用屏幕顶部Search Dialog的方式。在这种方式下，Android操作系统接管所有Search Dialog的事件，当用户提交查询后，Android系统将给支持的用来处理查询的Activity发送消息。Search Dialog可以提供查询提示列表来匹配用户输入。

用户提交查询后，Android系统构造一个Intent并把用户的查询内容放在这个Intent中。然后Android启动你定义的用来处理用户查询的Activity（称为Searchable Activity)，并把这个Intent发给该Activity。为了能够使用Android系统提供的Search Framework.需要以下几步：

1. Creating a Searchable Configuration

首先定义一个Searchable configuration,用于描述Search Dialog 的一些属性，该描述文件按惯例通常命名为searchable.xml 并定义在/res/xml 目录下。

<searchable xmlns:android=”http://schemas.android.com/apk/res/android”
android:label=”@string/search_label”
android:hint=”@string/search_hint”
android:searchMode=”showSearchLabelAsBadge”

android:voiceSearchMode=”showVoiceSearchButton|launchRecognizer”
android:voiceLanguageModel=”free_form”
android:voicePromptText=”@string/search_invoke”

android:searchSuggestAuthority=”com.example.android.apis.SuggestionProvider”
android:searchSuggestSelection=” ? ”
/>

只有android:label是必须的，一般定义为应用程序的名称。尽管不是必须的，一般也会定义android:hint。这个属性定义查询框没有任何输入时的背景文字。如上图中的”Search the dictionary” 。本例中为“Search Demo Hint”来提示用户可以输入的内容。

2. Creating a Searchable Activity

一个”Searchable Activity”就是一个可以用来处理Search Query 的Activity。和一般的Activity没有太大分别。当用户提交查询后，Android会给这个“Searchable Activity”发送一个Intent包含有用户查询内容，同时这个Intent 含有ACTION_SEARCH action。

由于可以在任何一个Activity中使用Search Dialog或是SearchView，Android需要知道哪个Activity是“Searchable Activity”，这就需要在AndroidManifest.xml中来定义“Searchable Activity”。

本例中 SearchQueryResults 定义为“Searchable Activity”，它在AndroidManifest.xml中定义为：

<!– search results are gathered and displayed. –>

<activity android:name=”.app.SearchQueryResults”
android:label=”@string/search_query_results”>
<intent-filter>
< action android:name=”android.intent.action.MAIN” />
<category android:name=”android.intent.category.SAMPLE_CODE” />
< /intent-filter>

<!– This intent-filter identifies this activity as “searchable” –>

<intent-filter>
<action android:name=”android.intent.action.SEARCH” />
<category android:name=”android.intent.category.DEFAULT” />
< /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>

Searchable Activity 需要在Intent-filter中指定android.intent.action.SEARCH，并在<meta-data>部分指定searchable configuration (指向res/xml/searchable.xml）

SearchQueryResults 用来处理用户查询请求，本例为简单起见，只是在屏幕上显示用户查询请求的内容。

它用来处理查询请求Intent的代码如下

if (Intent.ACTION_SEARCH.equals(queryAction)) {
 doSearchQuery(queryIntent, "onNewIntent()");
}
else {
 mDeliveredByText.setText("onNewIntent(), but no ACTION_SEARCH intent");
}

如果请求的Action为ACTION_SEARCH，表明该Activity是由Search Dialog触发的，则调用doSearchQuery来显示用户查询内容。此外这个Activity也可以从Launcher启动，此时Action不含ACTION_SEARCH。

Using the Search Dialog

Search Dialog 先为屏幕上方的浮动窗口，缺省为不可见的。只有当调用onSearchRequested()或是用户按“Search”键时（不是所有设备都有Search钮，在模拟器上可以用F5）Search Dialog才会显示。

为了使用Search Dialog，我们在AndroidManifest.xml定义了Searchable Activity： SearchQueryResults。 如果此时直接运行SearchQueryResults，在模拟器上按F5，将会在屏幕上方显示Search Dialog。

如果现在Invoke Search （SearchInvoke）Activity也可以使用Search Dialog， 也需要在AndroidManifest.xml做些说明：

<activity android:name=”.app.SearchInvoke”
android:label=”@string/search_invoke”>
<intent-filter>
< action android:name=”android.intent.action.MAIN” />
<category android:name=”android.intent.category.SAMPLE_CODE” />
< /intent-filter>

<!– This metadata entry causes .app.SearchQueryResults to be the default context –>
< !– whenever the user invokes search while in this Activity. –>
<meta-data android:name=”android.app.default_searchable”
android:value=”.app.SearchQueryResults” />

</activity>.

这时按下 onSearchRequest() 或是 “Search”键就显示Search Dialog，按查询键后，将会在SearchQueryResults显示用户输入的查询内容：

此外我们看到这Search Dialog下提供不最近用户输入作为输入提示，如果里面含有敏感信息，可以清除这个列表。

private void clearSearchHistory() {
 SearchRecentSuggestions suggestions
 = new SearchRecentSuggestions(this,
 SearchSuggestionSampleProvider.AUTHORITY,
 SearchSuggestionSampleProvider.MODE);
 suggestions.clearHistory();
}