یافت‌پذیری ابزاره

در دستگاه‌هایی که از Android 8.0 (میانای برنامه کاربردی سطح ۲۶) و بالاتر استفاده می‌کنند، راه‌اندازهایی که به کاربران اجازه می‌دهند میان‌برهای سنجاق‌شده ایجاد کنند، به آن‌ها اجازه می‌دهند ابزارک‌ها را نیز در صفحه اصلی سنجاق کنند. مشابه میان‌برهای سنجاق‌شده، این ابزاره‌های سنجاق‌شده به کاربران امکان دسترسی به تکالیف خاص در برنامه شما را می‌دهند و می‌توانند مستقیماً از برنامه به صفحه اصلی اضافه شوند، همان‌طور که در ویدیو زیر نشان داده شده است.

مثالی از سنجاق کردن ابزاره
شکل ۱. مثالی از سنجاق کردن ابزاره.

به کاربران اجازه دهید ابزاره‌ای را سنجاق کنند

در برنامه‌تان، می‌توانید با تکمیل مراحل زیر، درخواستی برای سنجاق کردن ابزاره در راه‌انداز پشتیبانی‌شده به سیستم ارسال کنید:

  1. مطمئن شوید که ابزاره‌ای را در فایل مانیفست برنامه‌تان اعلام کرده باشید.

  2. همان‌طور که در تکه‌کد زیر نشان داده شده است، requestPinAppWidget() روش را فراخوانی کنید:

val appWidgetManager = AppWidgetManager.getInstance(context)
val myProvider = ComponentName(context, ExampleAppWidgetProvider::class.java)

if (appWidgetManager.isRequestPinAppWidgetSupported) {
    // Create the PendingIntent object only if your app needs to be notified
    // when the user chooses to pin the widget. Note that if the pinning
    // operation fails, your app isn't notified. This callback receives the ID
    // of the newly pinned widget (EXTRA_APPWIDGET_ID).
    val successCallback = PendingIntent.getBroadcast(
        /* context = */ context,
        /* requestCode = */ 0,
        /* intent = */ Intent(
            // ...
        ),
        /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
    )

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)
}

کاربران ابزاره شما را ازطریق انتخابگر ابزاره یا از داخل برنامه شما، زمانی که عملکرد ابزاره بیشترین ارتباط را دارد، پیدا و اضافه می‌کنند. برای اطلاعات بیشتر، به اکتشاف و تبلیغات مراجعه کنید.