ویژگی های جستجوی اندروید را در برنامه خود ادغام کنید، ویژگی های جستجوی اندروید را در برنامه خود ادغام کنید، ویژگی های جستجوی اندروید را در برنامه خود ادغام کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
روش Compose را امتحان کنید
Jetpack Compose جعبه ابزار UI توصیه شده برای اندروید است. با نحوه افزودن قابلیت جستجو در Compose آشنا شوید.
جستجو یک ویژگی اصلی کاربر در اندروید است. کاربران باید بتوانند هر داده ای را که در دسترس آنها است جستجو کنند، خواه محتوا در دستگاه یا اینترنت قرار گرفته باشد. برای کمک به ایجاد یک تجربه جستجوی ثابت برای کاربران، Android یک چارچوب جستجو ارائه می‌کند که به شما کمک می‌کند جستجو را برای برنامه خود پیاده‌سازی کنید.
شکل 1. گفتگوی جستجو با پیشنهادهای جستجوی سفارشی.
چارچوب جستجو دو حالت ورودی جستجو را ارائه می دهد: یک گفتگوی جستجو در بالای صفحه یا یک ویجت جستجو ( SearchView ) که می توانید آن را در طرح بندی فعالیت خود جاسازی کنید. در هر صورت، سیستم Android با ارائه درخواست‌های جستجو به یک فعالیت خاص که جستجوها را انجام می‌دهد، به اجرای جستجوی شما کمک می‌کند. همچنین می‌توانید گفتگو یا ویجت جستجو را فعال کنید تا پیشنهادات جستجو را به عنوان کاربر ارائه دهد. شکل 1 نمونه ای از گفتگوی جستجو را با پیشنهادهای جستجوی اختیاری نشان می دهد.
هنگامی که گفتگوی جستجو یا ویجت جستجو را تنظیم کردید، می توانید کارهای زیر را انجام دهید:
- فعال کردن جستجوی صوتی
- پیشنهادات جستجو را بر اساس سؤالات اخیر کاربر ارائه دهید.
- پیشنهادات جستجوی سفارشی را ارائه دهید که با نتایج واقعی در داده های برنامه شما مطابقت دارد.
- پیشنهادات جستجوی برنامه خود را در جعبه جستجوی سریع در سراسر سیستم ارائه دهید.
توجه : چارچوب جستجو برای جستجوی داده‌های شما API ارائه نمی‌کند . برای انجام جستجو، باید از API های مناسب برای داده های خود استفاده کنید. به عنوان مثال، اگر داده های شما در پایگاه داده SQLite ذخیره شده است، از API های android.database.sqlite برای انجام جستجوها استفاده کنید.
همچنین، هیچ تضمینی وجود ندارد که دستگاه یک دکمه SEARCH اختصاصی ارائه کند که رابط جستجو را در برنامه شما فراخوانی کند. هنگام استفاده از گفتگوی جستجو یا یک رابط سفارشی، باید یک دکمه جستجو در رابط کاربری خود ارائه دهید که رابط جستجو را فعال می کند. برای اطلاعات بیشتر، به فراخوانی گفتگوی جستجو مراجعه کنید.
صفحات زیر به شما نشان می دهد که چگونه از فریم ورک اندروید برای پیاده سازی جستجو استفاده کنید:
- یک رابط جستجو ایجاد کنید
- چگونه برنامه خود را برای استفاده از گفتگوی جستجو یا ویجت جستجو تنظیم کنید.
- پیشنهادات درخواست اخیر را اضافه کنید
- نحوه ارائه پیشنهادات بر اساس پرس و جوهایی که قبلا استفاده شده است.
- پیشنهادات سفارشی را اضافه کنید
- نحوه ارائه پیشنهادات بر اساس داده های سفارشی از برنامه خود و ارائه آنها در جعبه جستجوی سریع در سراسر سیستم.
- پیکربندی قابل جستجو
- یک سند مرجع برای فایل پیکربندی قابل جستجو. اسناد دیگر نیز فایل پیکربندی را از نظر رفتارهای خاص مورد بحث قرار می دهند.
از حریم خصوصی کاربر محافظت کنید
هنگامی که جستجو را در برنامه خود پیاده سازی می کنید، اقداماتی را برای محافظت از حریم خصوصی کاربر انجام دهید. بسیاری از کاربران فعالیت های خود را در تلفن خود - از جمله جستجوها - اطلاعات خصوصی می دانند. برای محافظت از حریم خصوصی کاربران، اصول زیر را رعایت کنید:
- اطلاعات شخصی را به سرورها نفرستید - و در صورت لزوم، آن را وارد نکنید.
اطلاعات شخصی هر گونه اطلاعاتی است که می تواند به طور شخصی کاربران شما را شناسایی کند، مانند نام، آدرس ایمیل، اطلاعات صورتحساب، یا سایر داده هایی که می تواند به طور منطقی به چنین اطلاعاتی مرتبط شود. اگر برنامه شما جستجو را با کمک سرور اجرا می کند، از ارسال اطلاعات شخصی همراه با جستارهای جستجو خودداری کنید. برای مثال، اگر به دنبال کسب‌وکارهای نزدیک به کد پستی هستید، نیازی به ارسال شناسه کاربری ندارید. فقط کد پستی را به سرور ارسال کنید. اگر باید اطلاعات شخصی را ارسال کنید، از ثبت آن خودداری کنید. اگر باید آن را وارد کنید، از آن داده ها با دقت محافظت کنید و در اسرع وقت آن ها را پاک کنید.
- به کاربران راهی برای پاک کردن تاریخچه جستجوی خود ارائه دهید.
چارچوب جستجو به برنامه شما کمک می کند تا در حین تایپ کردن کاربر، پیشنهادات مربوط به زمینه را ارائه دهد. گاهی اوقات این پیشنهادات بر اساس جستجوهای قبلی یا سایر اقدامات انجام شده توسط کاربر در جلسه قبلی است. ممکن است یک کاربر بخواهد جستجوهای قبلی برای سایر کاربران دستگاه فاش نشود. اگر برنامه شما پیشنهاداتی ارائه می دهد که می تواند فعالیت های جستجوی قبلی را نشان دهد، راهی را برای کاربر برای پاک کردن سابقه جستجوی خود پیاده کنید. اگر از SearchRecentSuggestions استفاده می کنید، می توانید متد clearHistory() فراخوانی کنید. اگر پیشنهادهای سفارشی را پیاده سازی می کنید، باید روش مشابهی با "پاک کردن تاریخچه" در ارائه دهنده محتوای خود ارائه دهید که کاربر بتواند آن را اجرا کند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Try the Compose way \nJetpack Compose is the recommended UI toolkit for Android. Learn how to add search functionality in Compose. \n[Search bar →](/develop/ui/compose/components/search-bar) \n\nSearch is a core user feature on Android. Users must be able\nto search any data that is available to them, whether the content is located on the device or\nthe internet. To help create a consistent search experience for users, Android provides a\nsearch framework that helps you implement search for your application. \n\n**Figure 1.** A search dialog with custom\nsearch suggestions.\n\nThe search framework offers two modes of search input: a search dialog at the top of the\nscreen or a search widget ([SearchView](/reference/android/widget/SearchView)) that you can embed in your activity\nlayout. In either case, the Android system assists your search implementation by\ndelivering search queries to a specific activity that performs searches. You can also enable\nthe search dialog or widget to provide search suggestions as the user types. Figure 1 shows an\nexample of the search dialog with optional search suggestions.\n\nOnce you set up either the search dialog or the search widget, you can do the following:\n\n- Enable voice search.\n- Provide search suggestions based on recent user queries.\n- Provide custom search suggestions that match actual results in your application data.\n- Offer your application's search suggestions in the system-wide Quick Search Box.\n\n**Note** : The search framework does *not* provide APIs to\nsearch your data. To perform a search, you need to use APIs appropriate for your data. For example,\nif your data is stored in an SQLite database, use the [android.database.sqlite](/reference/android/database/sqlite/package-summary)\nAPIs to perform searches.\n\n\u003cbr /\u003e\n\n\nAlso, there is no guarantee that a device provides a dedicated SEARCH button that invokes the\nsearch interface in your application. When using the search dialog or a custom interface, you\nmust provide a search button in your UI that activates the search interface. For more\ninformation, see [Invoke the search\ndialog](/develop/ui/views/search/search-dialog#InvokingTheSearchDialog).\n\nThe following pages show you how to use Android's framework to implement search:\n\n**[Create a search interface](/develop/ui/views/search/search-dialog)**\n: How to set up your application to use the search dialog or search widget.\n\n**[Add recent query\nsuggestions](/develop/ui/views/search/adding-recent-query-suggestions)**\n: How to provide suggestions based on queries previously used.\n\n**[Add custom suggestions](/develop/ui/views/search/adding-custom-suggestions)**\n: How to provide suggestions based on custom data from your application and offer them\n in the system-wide Quick Search Box.\n\n**[Searchable configuration](/develop/ui/views/search/searchable-config)**\n: A reference document for the searchable configuration file. The other\n documents also discuss the configuration file in terms of specific behaviors.\n\nProtect user privacy\n\nWhen you implement search in your application, take steps to protect the user's\nprivacy. Many users consider their activities on their phone---including searches---to\nbe private information. To protect users' privacy, abide by the following\nprinciples:\n\n- **Don't send personal information to servers‐and if you must, don't log it.**\n\n Personal information is any information that can personally identify your users, such as their\n names, email addresses, billing information, or other data that can be reasonably linked to such\n information. If your application implements search with the assistance of a server, avoid sending\n personal information along with the search queries. For example, if you are searching for businesses\n near a ZIP code,\n you don't need to send the user ID as well; send only the ZIP code to the server. If you must\n send personal information, avoid logging it. If you must log it, protect that data\n very carefully and erase it as soon as possible.\n- **Provide users with a way to clear their search history.**\n\n The search framework helps your application provide context-specific suggestions while the user\n types. Sometimes these\n suggestions are based on previous searches or other actions taken by the user in an earlier\n session. A user might not want previous searches to be revealed to other device users. If your\n application provides suggestions that\n can reveal previous search activities, implement a way for the user to clear their\n search history. If you are using [SearchRecentSuggestions](/reference/android/provider/SearchRecentSuggestions),\n you can call the\n [clearHistory()](/reference/android/provider/SearchRecentSuggestions#clearHistory())\n method. If you are implementing custom suggestions, you need to provide a similar \"clear history\"\n method in your content provider that the user can execute."]]
