نمای کلی میان‌برهای برنامه

به‌عنوان توسعه‌دهنده، می‌توانید میان‌برهایی برای انجام کنش‌های خاص در برنامه‌تان تعریف کنید. می‌توانید این میان‌برها را در راه‌انداز یا دستیار پشتیبانی‌شده نمایش دهید و به کاربرانتان کمک کنید تا کارهای رایج یا توصیه‌شده را به‌سرعت در برنامه‌تان شروع کنند.

این سند به شما نشان می‌دهد که چگونه میان‌برهای برنامه را ایجاد و مدیریت کنید. همچنین می‌توانید با برخی روال‌های مطلوب برای بهبود میان‌برهایتان آشنا شوید.

انواع میان‌بر

کنش‌های کلیدی نشان‌داده‌شده بااستفاده از میان‌برهای برنامه
شکل ۱. بااستفاده از میان‌برهای برنامه، می‌توانید کنش‌های کلیدی را نشان دهید و فوراً کاربران را به بخش‌های عمیق برنامه‌تان هدایت کنید.

هر میان‌بر به یک یا چند هدف ارجاع می‌دهد که هرکدام از آن‌ها کنش خاصی را در برنامه‌تان راه‌اندازی می‌کند وقتی کاربران میان‌بر را انتخاب می‌کنند. انواع میان‌برهایی که برای برنامه‌تان ایجاد می‌کنید به مورد استفاده برنامه بستگی دارد. نمونه‌هایی از کنش‌هایی که می‌توانید به‌عنوان میان‌بر بیان کنید شامل موارد زیر است:

  • نوشتن ایمیل جدید در برنامه ایمیل.
  • هدایت کردن کاربران به مکانی خاص در برنامه نقشه‌برداری.
  • ارسال پیام به مخاطب کاربر در برنامه ارتباطی.
  • پخش قسمت بعدی نمایش تلویزیونی در برنامه رسانه.
  • بار کردن آخرین نقطه ذخیره‌شده در برنامه بازی.
  • اجازه دادن به کاربر برای سفارش نوشیدنی در برنامه ارسال بااستفاده از فرمان‌های گفتاری.

می‌توانید انواع میان‌برهای زیر را برای برنامه‌تان منتشر کنید:

  • میان‌برهای ایستا در فایل منبعی تعریف می‌شوند که در یک فایل APK یا دسته برنامه بسته‌بندی شده است.
  • میان‌برهای پویا را فقط در زمان اجرا می‌توان توسط برنامه ارسال، به‌روزرسانی، و حذف کرد.
  • میان‌برهای سنجاق‌شده را می‌توان در زمان اجرا به راه‌اندازهای پشتیبانی‌شده اضافه کرد، به‌شرطی که کاربر اجازه دهد.

نمایش میان‌برها در دستیارها بااستفاده از قابلیت‌ها

قابلیت‌ها در shortcuts.xml به شما امکان می‌دهد انواع کنش‌هایی را که کاربران می‌توانند برای راه‌اندازی برنامه‌تان و رفتن مستقیم به انجام تکلیفی خاص انجام دهند اعلام کنید. برای جزئیات بیشتر، اسناد مربوط به افزودن قابلیت‌ها را ببینید.

محدودیت‌های میان‌بر

اکثر راه‌اندازهای پشتیبانی‌شده حداکثر چهار میان‌بر را به‌طور هم‌زمان نمایش می‌دهند، ازجمله میان‌برهای ایستا و پویا. هنگام ارسال میان‌برهای پویا برای نمایش در سطوح Google، از کتابخانه ادغام میان‌برهای Google استفاده کنید تا مشمول محدودیت میان‌بر نشوید.

اگر انتخاب کنید از «کتابخانه ادغام میان‌برهای Google» استفاده نکنید، برنامه شما مشمول محدودیت دستگاه برای تعداد میان‌برهایی می‌شود که به‌طور هم‌زمان پشتیبانی می‌کند. میان‌برهایی که به این روش منتشر می‌شوند فقط در راه‌اندازهای Android نشان داده می‌شوند و در دیگر سطوح Google قابل‌کشف نیستند.

محدودیتی برای تعداد میان‌برهای سنجاق‌شده‌ای که کاربران می‌توانند برای برنامه‌تان ایجاد کنند وجود ندارد. برنامه‌تان نمی‌تواند میان‌برهای سنجاق‌شده را بردارد، اما می‌تواند آن‌ها را غیرفعال کند.

برای شروع ایجاد میان‌بر برای برنامه‌تان، به اسناد زیر مراجعه کنید:

برای جزئیات بیشتر درباره عملیاتی که می‌توانید روی میان‌برها انجام دهید، به سند مرجع میانای برنامه‌سازی کاربردی ShortcutManager مراجعه کنید.