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

در دستگاه‌هایی که از 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)
}

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