هنگام طراحی و ایجاد میانبرهای برنامه خود، این دستورالعملها را دنبال کنید:
- دستورالعملهای طراحی را دنبال کنید
- برای اینکه میانبرهای برنامه شما از نظر بصری با میانبرهای مورد استفاده برای برنامههای سیستمی سازگار باشند، دستورالعملهای طراحی آیکون میانبرهای برنامه را دنبال کنید.
- فقط چهار میانبر مجزا منتشر کنید
اگرچه این API از ترکیبی از حداکثر ۱۵ میانبر استاتیک و دینامیک برای برنامه شما پشتیبانی میکند، اما توصیه میکنیم فقط چهار میانبر مجزا منتشر کنید تا ظاهر بصری آنها در لانچر بهبود یابد.
علاوه بر نمایش میانبرها در لانچر، از کتابخانه یکپارچهسازی میانبرهای گوگل برای نمایش میانبرها در سطوح گوگل مانند دستیار گوگل استفاده کنید. این کتابخانه از ارسال تعداد نامحدودی میانبر پویا پشتیبانی میکند. اگر از این کتابخانه برای ارسال تعداد زیادی میانبر استفاده میکنید، توصیه میکنیم
rankمیانبرهایی را که باید در لانچرهای پشتیبانیشده ظاهر شوند، با فراخوانی متدsetRank()تنظیم کنید.- محدود کردن طول توضیحات میانبر
فضای منویی که میانبرهای برنامه شما را در لانچر نشان میدهد محدود است. در صورت امکان، طول «توضیح کوتاه» یک میانبر را به ۱۰ کاراکتر و طول «توضیحات طولانی» را به ۲۵ کاراکتر محدود کنید.
برای اطلاعات بیشتر در مورد برچسبها برای میانبرهای استاتیک، بخش «سفارشیسازی مقادیر ویژگی» را مطالعه کنید. برای میانبرهای پویا و پینشده، مستندات مرجع مربوط به
setLongLabel()وsetShortLabel()را مطالعه کنید.- تاریخچه استفاده از میانبرها و اقدامات را حفظ کنید
برای هر میانبری که ایجاد میکنید، روشهای مختلفی را که یک کاربر میتواند همان کار را مستقیماً درون برنامه شما انجام دهد، در نظر بگیرید. در هر یک از این موقعیتها، تابع
reportShortcutUsed()را فراخوانی کنید تا لانچر، تاریخچه دقیقی از تعداد دفعاتی که یک کاربر اقدامات مربوط به میانبرهای شما را انجام میدهد، نگهداری کند.- بهروزرسانی میانبرها فقط زمانی که معنی آنها حفظ شده باشد
هنگام تغییر میانبرهای پویا و پینشده، فقط هنگام تغییر اطلاعات میانبری که معنای آن را حفظ میکند، تابع
updateShortcuts()را فراخوانی کنید. در غیر این صورت، بسته به نوع میانبری که در حال ایجاد مجدد آن هستید، از یکی از روشهای زیر استفاده کنید:
- میانبرهای پویا:
pushDynamicShortcut(). میانبرهای پین شده:
requestPinShortcut().برای مثال، اگر برای رفتن به یک سوپرمارکت یک میانبر ایجاد میکنید، اگر نام سوپرمارکت تغییر کرد اما مکان آن ثابت ماند، بهروزرسانی میانبر مناسب است. با این حال، اگر کاربر خرید را از مکان سوپرمارکت دیگری شروع کند، بهتر است یک میانبر جدید ایجاد کنید.
- هر زمان که برنامه خود را اجرا میکنید، میانبرهای پویا را بررسی کنید
- میانبرهای پویا وقتی کاربر دادههای خود را در دستگاه جدید بازیابی میکند، حفظ نمیشوند. به همین دلیل، توصیه میکنیم هر بار که برنامه خود را اجرا میکنید، تعداد اشیاء برگردانده شده توسط
getDynamicShortcuts()را بررسی کنید و در صورت نیاز، میانبرهای پویا را دوباره منتشر کنید، همانطور که در قطعه کد در Backup and restore نشان داده شده است.