البحث هو ميزة أساسية للمستخدم على Android. يجب أن يكون المستخدمون قادرين على البحث في أي بيانات متاحة لهم، سواء كان المحتوى موجودًا على الجهاز أو على الإنترنت. للمساعدة في إنشاء تجربة بحث متسقة للمستخدمين، يوفّر Android إطار عمل بحث يساعدك في تنفيذ البحث في تطبيقك.
![](https://developer.android.google.cn/static/images/search/search-suggest-custom.png?authuser=9&hl=ar)
الشكل 1. مربع حوار بحث يحتوي على اقتراحات بحث مخصصة.
يوفّر إطار عمل البحث وضعَين لإدخال البحث: مربّع حوار بحث في أعلى الشاشة أو أداة بحث (SearchView
) يمكنك تضمينها في تنسيق نشاطك. وفي كلتا الحالتين، يساعد نظام Android في تنفيذ البحث من خلال توجيه طلبات البحث إلى نشاط محدد يؤدي عمليات بحث. يمكنك أيضًا تمكين مربع حوار البحث أو التطبيق المصغّر
لتقديم اقتراحات البحث أثناء كتابة المستخدمين. يوضح الشكل 1 مثالاً
لمربع حوار البحث مع اقتراحات البحث الاختيارية.
بعد إعداد مربّع حوار البحث أو تطبيق "بحث Google" المصغّر، يمكنك إجراء ما يلي:
- تفعيل البحث الصوتي
- تقديم اقتراحات البحث استنادًا إلى طلبات البحث الأخيرة التي أجراها المستخدمون
- توفير اقتراحات بحث مخصص تطابق النتائج الفعلية في بيانات التطبيق.
- اعرض اقتراحات البحث الخاصة بالتطبيق في مربع البحث السريع على مستوى النظام.
ملاحظة: لا يوفّر إطار عمل البحث واجهات برمجة تطبيقات
للبحث في بياناتك. لإجراء بحث، عليك استخدام واجهات برمجة التطبيقات المناسبة لبياناتك. على سبيل المثال، إذا تم تخزين بياناتك في قاعدة بيانات SQLite، يمكنك استخدام واجهات برمجة التطبيقات android.database.sqlite
لإجراء عمليات البحث.
بالإضافة إلى ذلك، ليس هناك ما يضمن توفير جهاز لزر SEARCH مخصّص يستدعي
واجهة البحث في تطبيقك. عند استخدام مربع حوار البحث أو واجهة مخصصة، يجب
تقديم زر بحث في واجهة المستخدم الخاصة بك ينشط واجهة البحث. ولمزيد
من المعلومات، يُرجى الاطّلاع على استدعاء مربّع حوار البحث.
توضّح لك الصفحات التالية كيفية استخدام إطار عمل Android لتنفيذ البحث:
- إنشاء واجهة بحث
- كيفية إعداد تطبيقك لاستخدام مربّع حوار البحث أو تطبيق البحث المصغّر
- إضافة اقتراحات طلبات البحث الأخيرة
- كيفية تقديم الاقتراحات بناءً على طلبات البحث المستخدَمة سابقًا
- إضافة اقتراحات مخصّصة
- كيفية تقديم الاقتراحات استنادًا إلى بيانات مخصصة من تطبيقك وعرضها في مربّع البحث السريع على مستوى النظام
- الضبط القابل للبحث
- مستند مرجعي لملف الإعداد القابل للبحث وتناقش المستندات الأخرى أيضًا ملف الضبط من حيث سلوكيات محددة.
حماية خصوصية المستخدم
عند تنفيذ البحث في تطبيقك، يجب اتخاذ بعض الخطوات لحماية خصوصية المستخدم. يعتبر العديد من المستخدمين أن أنشطتهم على هواتفهم، بما في ذلك عمليات البحث، معلومات خاصة. ولحماية خصوصية المستخدمين، التزم بالمبادئ التالية:
- لا ترسل معلومات شخصية إلى الخوادم، وإذا كان الأمر كذلك، لا تسجّلها.
المعلومات الشخصية هي أي معلومات يمكنها تحديد هوية المستخدمين على نحو شخصي، مثل الأسماء أو عناوين البريد الإلكتروني أو معلومات الفوترة أو أي بيانات أخرى يمكن ربطها بشكل معقول بهذه المعلومات. إذا نفّذ تطبيقك البحث بمساعدة أحد الخوادم، تجنَّب إرسال معلومات شخصية مع طلبات البحث. على سبيل المثال، إذا كنت تبحث عن أنشطة تجارية بجانب رمز بريدي، لن تحتاج إلى إرسال رقم تعريف المستخدم أيضًا، بل يجب إرسال الرمز البريدي فقط إلى الخادم. إذا كان يجب عليك إرسال معلومات شخصية، فتجنب تسجيلها. إذا كان يجب عليك تسجيلها، فقم بحماية تلك البيانات بعناية شديد ومحوها في أقرب وقت ممكن.
- وفِّر للمستخدمين طريقة لمحو سجلّ البحث.
يساعد إطار عمل البحث تطبيقك على تقديم اقتراحات خاصة بالسياق أثناء كتابة المستخدم. وتستند هذه الاقتراحات أحيانًا إلى عمليات البحث السابقة أو الإجراءات الأخرى التي اتخذها المستخدم في جلسة سابقة. قد لا يرغب المستخدم في الكشف عن عمليات البحث السابقة لمستخدمي الأجهزة الآخرين. إذا كان تطبيقك يقدّم اقتراحات يمكن أن تكشف عن أنشطة البحث السابقة، نفِّذ طريقة تتيح للمستخدم محو سجلّ البحث الخاص به. إذا كنت تستخدم
SearchRecentSuggestions
، يمكنك استدعاء الطريقةclearHistory()
. إذا كنت تنفّذ اقتراحات مخصّصة، يجب توفير طريقة "محو السجلّ" مماثلة في موفر المحتوى يمكن للمستخدم تنفيذها.