Android API Guides---Search Overview

Search Overview

搜索是Android上的核心用户功能。用户应该能够搜索是提供给他们，内容是否位于设备或互联网上的任何数据。为了帮助为用户创建一个一致的搜索体验，Android提供了搜索框架，可以帮助你实现搜索应用程序。

图1.截图自定义搜索建议搜索对话框。

搜索框架提供的搜索输入两种模式：在屏幕顶部的搜索对话框或搜索小工具（搜索查看），你可以在你的活动布局嵌入。在这两种情况下，Android系统将通过提供搜索查询来执行搜索特定活动帮助你搜索的实现。您还可以启用搜索对话框或窗口小部件提供搜索建议的用户类型。图1显示了可选的搜索建议的搜索对话框中的一个例子。
一旦你设置了搜索对话框或搜索插件，您可以：
启用语音搜索
提供基于最近用户查询的搜索建议
提供应用程序数据与实际结果的自定义搜索建议
报价在全系统快速搜索框应用程序的搜索建议
注意：搜索的框架并没有提供API来搜索您的数据。为了执行搜索，你需要使用的API适合您的数据。例如，如果您的数据存储在SQLite数据库，你应该使用android.database.sqlite API来执行搜索。
此外，也不能保证一个设备提供一个专门的搜索按钮调用应用程序中的搜索界面。当使用搜索对话框或自定义界面，您必须提供在UI搜索按钮激活的搜索界面。欲了解更多信息，请参阅调用搜索对话框。
下列文件显示如何使用Android的框架来实现搜索：
创建一个搜索界面
如何设置应用程序使用搜索对话框或窗口小部件进行搜索。
最近查询建议增加
如何提供基于先前使用的查询建议。
添加自定义的建议
如何提供基于从应用程序自定义数据建议，还提供了他们在全系统的快速搜索框。
检索配置
对于搜索的配置文件的参考文档（虽然其他文件还讨论了在具体行为方面的配置文件）。
保护用户隐私
当您实现您的应用程序搜索，采取措施保护用户的隐私。许多用户认为他们的手机上，包括活动的搜索，是私人信息。为了保护每个用户的隐私，你应该遵循以下原则：
不要将个人信息发送给服务器，但如果你一定要，不记录它。
个人信息是指可以亲自确定你的用户，如他们的姓名，电子邮件地址，账单信息，或可合理地链接到此类信息的其他数据的任何信息。如果你的应用程序实现与服务器的协助搜索，避免与搜索查询一起发送的个人信息。例如，如果您正在寻找附近邮政编码的企业，你不需要发送用户ID为好;只发送邮政编码到服务器。如果你必须发送个人信息，你不应该记录它。如果你必须登录吧，很仔细地保护数据，并尽快将它抹去。
一种方法来明确自己的搜索历史提供的用户。
搜索框架有助于您的应用程序，同时提供用户键入特定的上下文建议。有时，这些建议是基于以前的搜索或由用户在早先会议采取的其他行动。用户可能不与朋友希望为先前的搜索被泄露给其他设备的用户，例如，如果用户共享该设备。如果你的应用提供建议，可以揭示以前的搜索活动，你应该实现为用户清除搜索历史记录的功能。如果你正在使用SearchRecentSuggestions，你可以简单地调用clearHistory（）方法。如果要实现自定义的建议，你需要在用户可以执行你的内容提供商提供一个类似的“清除历史记录”的方法。