Android QuickSearchBox全局搜索

1. 全局搜索（QuickSearchBox）介绍：
全局搜索（QuickSearchBox）是Android系统中原生的应用程序，它的主要职能是接收用户的搜索请求，并将搜索请求传达给支持全局搜索的应用程序，应用程序执行搜索操作，并将搜索到的結果返回给全局搜索应用程序，全局搜索应用根据搜索結果渲染UI界面，当用户单击某一个搜索出来的結果项就会打开相应的应用程序，显示搜索結果的詳細信息。 

2. 全局搜索(QuickSearchBox)技术架构:
Android系统的全局搜索由搜索管理器（SearchManager），全局搜索AppWidget，全局搜索应用，支持全局搜索的应用程序（联系人，音乐，浏览器等）四大部分组成：
（1）framework层的搜索管理器（SearchManager）：主要功能是对Android系统全局搜索提供支持，当Android系统启动完成后会发出系统启动完成（BOOT_COMPLETED）广播，SearchManager接收到此广播后会通过PackageManager搜索系统中支持全局搜索的应用程序（应用程序如何支持全局搜索以后的文章会介绍），这此支持全局搜索的应用我们称为搜索源，SearchManager解析搜索源的配置信息并将这些配置信息封装成对象保存在List列表中供全局搜索应用程序使用。
（2）全局搜索AppWidget：AppWidget是搜索的入口，当用户需要使用全局搜索时会单击已经添加到桌面的全局搜索AppWidget，这时会打开全局搜索应用。
（3）全局搜索应用程序(QuickSearchBox)：它的主要职能是接受用户的输入请求，启动异步搜索，将搜索到的結果显示。
（4）支持全局搜索的应用程序：每一个支持全局搜索的应用程序都需要实现一个ContentProvider，通过这个ContentProvider向外提供数据，全局搜索应用（QuickSearchBox）会调用这些ContentProvider获取数据。
    
1. 新建一个Activity,配置AndroidManifest.xml
第一，这样一个Activity在你的应用程序中是必须存在的，因为你配置了上面我用红色注释标注的代码后，这个Activity可以被识别为搜索源，
第二，当搜索出結果信息后单击某一个結果项后会打开这个Activity显示搜索出的内容。
		<activity
            android:name=".noteeditor.NoteEditorActivity"
            android:launchMode="singleTask"
            android:screenOrientation="portrait"
            android:theme="@style/AppTheme.NoteEditorActivity"
            android:windowSoftInputMode="adjustResize" >

            <intent-filter>
                <action android:name="android.intent.action.NoteDetail" />
                <category android:name="android.intent.category.DEFAULT" />
            </intent-filter>

            <intent-filter>
                <action android:name="android.intent.action.SEARCH" />
                <category android:name="android.intent.category.DEFAULT" />
            </intent-filter>

            <meta-data
                android:name="android.app.searchable"
                android:resource="@xml/note_searchable" />
        </activity> 
                
2.note_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:includeInGlobalSearch="true"
    android:searchSuggestAuthority="com.freeme.freemenote.data.SearchProvider"
    android:searchSuggestIntentAction="android.intent.action.NoteDetail"
    android:searchSuggestIntentData="content://com.freeme.launcher.local.themelist">
</searchable>           
        
3. 在AndroidManifest.xml文件中配置ContentProvider：
	<provider
            android:name=".data.SearchProvider"
            android:authorities="com.freeme.freemenote.data.SearchProvider" />          
                
4.创建Content Provider
在QuickSearchBox中通过ContentResolver调用内容提供者的query(Uri, String[], String, String[], String)方法进行信息搜索，应用程序必须实现这个方法并且返回搜索到的Cursor对象。下面将对ContentProvider的query方法的参数进行说明：
第一个参数(uri)：
content://authority/suggestion.path/search_suggest_query/queryStr？limit=50

authority：对应searchable.xml文件中的android:searchSuggestAuthority属性。
suggestion.path：对应searchable.xml文件中的android:searchSuggestPath属性。
search_suggest_query ： 固定字符串。
queryStr： 查询字符串。
limit : 查询条数。
    
public class SearchProvider extends ContentProvider {

    private static final String TAG = "SearchProvider";
    DBOpenHelper mHelper;
    SQLiteDatabase db;

    @Override
    public boolean onCreate() {
        mHelper = DBOpenHelper.getInstance(getContext());
        return true;
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
        String selectStr = "";
        if (selectionArgs == null) {
            int index = uri.getEncodedPath().lastIndexOf("/");
            selectStr = uri.getEncodedPath().substring(index + 1);
        } else {
            selectStr = selectionArgs[0];
        }
        String decodeStr = null;
        try {
            decodeStr = URLDecoder.decode(selectStr, "utf-8");
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        android.util.Log.d("SearchHelper", "query: decodeStr = " + decodeStr);
        /*SupportSQLiteDatabase supportDB = ThemeClubDatabase.getInstance(mContext).getOpenHelper().getWritableDatabase();
        SimpleSQLiteQuery query = new SimpleSQLiteQuery("SELECT name AS " + SearchManager.SUGGEST_COLUMN_TEXT_1
                + "," + "defaultTheme AS " + SearchManager.SUGGEST_COLUMN_TEXT_2
                + "," + "id AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA_ID
                + "," + "packageName AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA
                + "," + "fileSize AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA
                + "," + "PreviewUrl AS " + SearchManager.SUGGEST_COLUMN_ICON_1
                + " FROM theme WHERE name like '%'||:name||'%'", new Object[]{decodeStr});
        Cursor cursor = supportDB.query(query);*/
        db = mHelper.getWritableDatabase();
        Cursor cursor = db.rawQuery("SELECT content AS " + SearchManager.SUGGEST_COLUMN_TEXT_1
                + "," + "longdate AS " + SearchManager.SUGGEST_COLUMN_TEXT_2
                + "," + "_id AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA_ID
                + " FROM notes WHERE content like '%'||:name||'%'", new String[]{decodeStr});

        return cursor;
    }
}

相关参考：
https://developer.android.com/develop/ui/views/search/adding-recent-query-suggestions