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