أفضل الممارسات للاختصارات

عند تصميم اختصارات تطبيقك وإنشائها، اتبع هذه الإرشادات:

اتّباع إرشادات التصميم

لجعل اختصارات تطبيقك متسقة مرئيًا مع الاختصارات المستخدمة لتطبيقات النظام، اتّبِع إرشادات تصميم رموز اختصارات التطبيقات.

نشر أربعة اختصارات مختلفة فقط

على الرغم من أنّ واجهة برمجة التطبيقات تتيح مزيجًا من ما يصل إلى 15 اختصارًا ثابتًا وديناميكيًا لتطبيقك، ننصحك بنشر أربعة اختصارات مختلفة فقط لتحسين مظهرها المرئي في مشغّل التطبيقات.

بالإضافة إلى عرض الاختصارات على مشغّل التطبيقات، يمكنك استخدام مكتبة اختصارات Google لدمج اختصارات Google لعرض الاختصارات على مساحات عرض Google، مثل "مساعد Google". تدعم هذه المكتبة دفع عدد غير محدود من الاختصارات الديناميكية. إذا كنت تستخدم هذه المكتبة لإرسال عدد كبير من الاختصارات، نقترح إعداد rank للاختصارات التي يجب أن تظهر في مشغِّلات التطبيقات المتوافقة من خلال استدعاء طريقة setRank().

الحدّ من طول وصف الاختصار

إنّ المساحة المتوفّرة في القائمة التي تعرض اختصارات تطبيقك في مشغّل التطبيقات محدودة. عندما يكون ذلك ممكنًا، حدد طول "الوصف القصير" للاختصار بـ 10 أحرف، واختصر طول "الوصف الطويل" بـ 25 حرفًا.

لمزيد من المعلومات حول تصنيفات الاختصارات الثابتة، اطّلِع على تخصيص قيم السمات. للحصول على الاختصارات الديناميكية والمثبَّتة، اقرأ المستندات المرجعية على setLongLabel() وsetShortLabel().

الاحتفاظ بسجلّ استخدام الاختصارات والإجراءات

في كل اختصار تنشئه، فكِّر في الطرق المختلفة التي يمكن للمستخدم من خلالها إنجاز المهمة نفسها مباشرةً في تطبيقك. عليك طلب reportShortcutUsed() في كل حالة من هذه الحالات كي يحتفظ مشغّل التطبيقات بسجلّ دقيق لعدد مرات تنفيذ المستخدم للإجراءات التي تمثل اختصاراتك.

تعديل الاختصارات فقط عند الاحتفاظ بمعناها

عند تغيير الاختصارات الديناميكية والمثبَّتة، يجب استدعاء updateShortcuts() فقط عند تغيير معلومات الاختصار الذي يحتفظ بمعناه. بخلاف ذلك، استخدم إحدى الطرق التالية، بناءً على نوع الاختصار الذي تعيد إنشاؤه:

• الاختصارات الديناميكية: pushDynamicShortcut().
• الاختصارات المثبَّتة: requestPinShortcut().

على سبيل المثال، إذا قمت بإنشاء اختصار للانتقال إلى سوبر ماركت، من المناسب تحديث الاختصار إذا تغير اسم السوبرماركت ولكن يظل موقعه كما هو. إذا بدأ المستخدم التسوق في موقع سوبرماركت مختلف، فمن الأفضل إنشاء اختصار جديد.

التحقّق من الاختصارات الديناميكية عند إطلاق تطبيقك

لا يتم الاحتفاظ بالاختصارات الديناميكية عندما يستعيد المستخدم بياناته على جهاز جديد. ولهذا السبب، ننصحك بالتحقق من عدد العناصر التي يعرضها getDynamicShortcuts() في كل مرة يتم فيها تشغيل التطبيق وإعادة نشر الاختصارات الديناميكية حسب الحاجة، كما هو موضّح في مقتطف الرمز في صفحة الاحتفاظ بنسخة احتياطية والاستعادة.