عند تصميم اختصارات تطبيقك وإنشائها، يُرجى اتّباع الإرشادات التالية:
- اتّباع إرشادات التصميم
- لجعل اختصارات تطبيقك متوافقة بصريًا مع الاختصارات المستخدَمة لتطبيقات النظام، اتّبِع إرشادات تصميم رموز اختصارات التطبيقات.
- نشر أربعة اختصارات مميّزة فقط
على الرغم من أنّ واجهة برمجة التطبيقات تتيح استخدام ما يصل إلى 15 اختصارًا ثابتًا وديناميكيًا لتطبيقك، ننصحك بنشر أربعة اختصارات مميزة فقط لتحسين مظهرها المرئي في مشغّل التطبيقات.
بالإضافة إلى عرض الاختصارات على مشغّل التطبيقات، يمكنك استخدام مكتبة دمج اختصارات Google لعرض الاختصارات على مساحات عرض Google، مثل "مساعد Google". تتيح هذه المكتبة إرسال عدد غير محدود من الاختصارات الديناميكية. إذا كنت تستخدم هذه المكتبة لإرسال عدد كبير من الاختصارات، ننصحك بضبط
rankللاختصارات التي يجب أن تظهر في المشغّلات المتوافقة من خلال استدعاء الطريقةsetRank().- الحدّ من طول وصف الاختصار
المساحة المخصّصة في القائمة لعرض اختصارات تطبيقك في مشغّل التطبيقات محدودة. يُرجى حصر طول "الوصف القصير" لاختصار التطبيق على 10 أحرف، وحصر طول "الوصف الطويل" على 25 حرفًا، وذلك عند الإمكان.
لمزيد من المعلومات عن تصنيفات الاختصارات الثابتة، يمكنك الاطّلاع على مقالة تخصيص قيم السمات. بالنسبة إلى الاختصارات الديناميكية والمثبّتة، يمكنك الاطّلاع على مستندات المرجع حول
setLongLabel()وsetShortLabel().- الاحتفاظ بسجلّ استخدام الاختصارات والإجراءات
بالنسبة إلى كل اختصار تنشئه، عليك مراعاة الطرق المختلفة التي يمكن للمستخدم من خلالها إنجاز المهمة نفسها مباشرةً داخل تطبيقك. استدعِ الدالة
reportShortcutUsed()في كل من هذه الحالات لكي يحتفظ مشغّل التطبيق بسجلّ دقيق لمدى تكرار تنفيذ المستخدم للإجراءات التي تمثّل اختصاراتك.- تعديل الاختصارات فقط عندما يتم الحفاظ على معناها
عند تغيير الاختصارات الديناميكية والمثبّتة، لا تستدعِ الدالة
updateShortcuts()إلا عند تغيير معلومات اختصار يحتفظ بمعناه. في ما عدا ذلك، استخدِم إحدى الطرق التالية، حسب نوع الاختصار الذي تريد إعادة إنشائه:
- الاختصارات الديناميكية:
pushDynamicShortcut() الاختصارات المثبَّتة:
requestPinShortcut()على سبيل المثال، إذا أنشأت اختصارًا للانتقال إلى متجر كبير، من المناسب تعديل الاختصار إذا تغيّر اسم المتجر ولكن بقي موقعه الجغرافي كما هو. أما إذا بدأ المستخدم التسوّق في موقع مختلف من السوبرماركت، فمن الأفضل إنشاء اختصار جديد.
- التحقّق من الاختصارات الديناميكية عند تشغيل تطبيقك لا يتم الاحتفاظ
- بالاختصارات الديناميكية
عندما يستعيد المستخدم بياناته على جهاز جديد. لهذا السبب، ننصحك بالتحقّق من عدد العناصر التي تعرضها الدالة
getDynamicShortcuts()في كل مرة تشغّل فيها تطبيقك، وإعادة نشر الاختصارات الديناميكية حسب الحاجة، كما هو موضّح في مقتطف الرمز البرمجي في النسخ الاحتياطي والاستعادة.