如何将自己的App作为外部数据源提供给Android系统搜索？

（1）基础：安卓标准search框架

search框架是安卓为了减少App开发搜索功能的成本，提供的一套接口，主要实现两大类功能：第一、可以轻松地实现本地数据的搜索，包括数据和UI；第二、提供了将App的数据开放给系统搜索（system-wide Quick Search Box）的能力。第二部分基于第一部分，在实现了第一部分的基础上，应用可以通过简单的配置即将数据开放出来。
安卓将第二部分命名为“Custom Suggestion”，即在搜索输入query string的时候，即时推荐的内容。这部分相当于给了App一个数据通道，可以通过它将自己的数据在系统搜索框中被搜索到，增加入口。
安卓官方文档对于Search框架有详细的介绍：
https://developer.android.com/guide/topics/search/index.html
安卓官方demo：
https://github.com/android/platform_development/tree/master/samples/SearchableDictionary/
安卓代码中也提供了这个demo的源代码：
development/samples/SearchableDictionary
建议先通读官方guide。本文接下来基于官方文档以及demo，整理接入的steps，只要按照文档逐步实现即可。本文仅包含数据开放给系统搜索的部分，App内部搜索不涉及。

（2）如何将自己的App作为一个外部数据源添加到系统搜索

第1步：创建Search Activity
这个Activity用以处理搜索结果的跳转，在系统搜索中点击搜索召回的结果，跳转到的界面即Search Activity。

以安卓官方Demo为例：

<!-- The default activity of the app; displays search results. -->

<activity android:name=".SearchableDictionary"

android:launchMode="singleTop">

<intent-filter>

<action android:name="android.intent.action.MAIN" />

<category android:name="android.intent.category.LAUNCHER" />

</intent-filter>

<!-- Receives the search request. -->

<intent-filter>

<action android:name="android.intent.action.SEARCH" />

<!-- No category needed, because the Intent will specify this class component-->

</intent-filter>

<!-- Points to searchable meta data. -->

<meta-data android:name="android.app.searchable"

android:resource="@xml/searchable" />

</activity>

有两个关键信息：
需要在intent filter配置action “android.intent.action.Search”，相应的在Activity的业务逻辑中应该有对此Action的处理。
配置一个meta-data “android.app.searchable”，向系统注册了一个Searchable对象。这个meta-data对应一个xml文件来描述Searchable对象信息，与Activity绑定。基本上一个Searchable可以看作一个数据源。可以有多个Activity/xml来处理多个数据源。

第2步：创建Searchable Configuration
Searchable Configuration即第1步中的xml文件，仍以安卓官方Demo的searchable.xml为例：

<searchable xmlns:android="http://schemas.android.com/apk/res/android"

android:label="@string/search_label"

android:hint="@string/search_hint" 

android:searchSettingsDescription="@string/settings_description" 

android:searchSuggestAuthority="com.example.android.searchabledict.DictionaryProvider"

android:searchSuggestIntentAction="android.intent.action.VIEW"

android:searchSuggestIntentData="content://com.example.android.searchabledict.DictionaryProvider/dictionary"

android:searchSuggestSelection=" ?"

android:searchSuggestThreshold="1"

android:includeInGlobalSearch="true">

</searchable>

安卓官方文档和sdk对上述字段有详细的解释，这里举几个重要的说明。
includeInGlobalSearch：表示是否将数据开放给系统搜索。必须置为true。
searchSuggestAuthority：对应于提供数据的Provider的authorities。
searchSuggestIntentData：在数据使用方，即系统搜索，为点击结果条目跳转回App配置Intent Uri时使用。
queryAfterZeroResults：这是一个有利于性能优化的配置。因为需要在用户每次输入一个字母（或汉字）之后都要触发搜索，如果你的数据源是模糊匹配，譬如输入ab时，如果结果为空，意味着ab*的结果都为空，那么可以将此项配置为false。在系统搜索的数据query逻辑中会使用这个字段来减少数据库query次数。建议在适当的时候使用。
这个配置文件的使用可以参考安卓官方demo。

第3步：接入数据
这一步需要做的是配置并实现对系统搜索提供数据的Provider。安卓官方Demo的Provider配置比较简单，以官方文档中的示例参考：

<provider android:name="MySuggestionProvider"
 android:authorities="com.example.MyCustomSuggestionProvider"
 android:readPermission="com.example.provider.READ_MY_DATA"
 android:writePermission="com.example.provider.WRITE_MY_DATA">
 <path-permission android:pathPrefix="/search_suggest_query"
  android:readPermission="android.permission.GLOBAL_SEARCH" />
</provider>

其中权限 android.permission.GLOBAL_SEARCH是安卓提供的数据保护权限。
详见：https://developer.android.com/reference/android/Manifest.permission.html GLOBAL_SEARCH。
下面看看数据源需要提供哪些字段？安卓官方文档给出了标准字段：https://developer.android.com/guide/topics/search/adding-custom-suggestions.html#SuggestionTable
其中包括两个必选字段和一些可选字段。
一些重要字段：

BaseColumns._ID

SearchManager.SUGGEST_COLUMN_TEXT_1

SearchManager.SUGGEST_COLUMN_TEXT_2

SearchManager.SUGGEST_COLUMN_ICON_1

SearchManager.SUGGEST_COLUMN_INTENT_ACTION

SearchManager.SUGGEST_COLUMN_INTENT_DATA

SearchManager.SUGGEST_COLUMN_SHORTCUT_ID

第4步：enable外部数据源
经过上面3步后添加的数据源默认并没有打开，会在系统搜索设置中出现对应的项，需要用户手动打开，系统搜索才会去这个数据源获取数据。设置项的文字描述可以通过Searchable配置。