Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.
Widget dan pintasan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
API alur baru untuk menambahkan pintasan dan widget di Android 8.0 memungkinkan
developer aplikasi menambahkan pintasan dan widget dari dalam aplikasi, bukan
mengandalkan baki widget. Versi ini juga tidak lagi menggunakan metode lama (mengirim
siaran) untuk menambahkan pintasan karena alasan keamanan.
Peluncur harus mendukung penerapan baru ini sehingga developer aplikasi dapat
mengandalkan sistem untuk menambahkan pintasan atau widget mereka.
Contoh dan sumber
Dokumen tersedia di berbagai class sistem. Referensi mencakup hal berikut:
- ShortcutManager.java
Memublikasikan bagian Pintasan yang disematkan di header.
- Intent.java
Javadoc untuk ACTION_CREATE_SHORTCUT.
- AppWidgetManager.java
Javadoc untuk requestPinAppWidget.
Implementasi
Implementator perangkat perlu menambahkan aktivitas di peluncur dengan tindakan filter intent:
android.content.pm.action.CONFIRM_PIN_SHORTCUTandroid.content.pm.action.CONFIRM_PIN_APPWIDGET
Lihat dokumentasi
API untuk mengetahui detail selengkapnya.
Aktivitas ini akan menampilkan perintah konfirmasi kepada pengguna untuk menambahkan widget/pintasan
yang diminta dan setelah menerima, tambahkan widget/pintasan yang sesuai di
layar utama.
Untuk widget, panggilan accept() harus menyertakan ID widget
dari widget yang baru ditambahkan.
Mengimplementasikan UI Sistem
Partner perlu mengupdate aplikasi Peluncur mereka menggunakan penerapan
Launcher3 (packages/apps/Launcher3) sebagai referensi.
Temukan perubahan Launcher3 yang relevan di Project Open Source Android (AOSP):
Validasi
Untuk memvalidasi fitur ini, coba tambahkan pintasan dari Chrome atau aplikasi Kontak
dan pastikan perintah konfirmasi yang tepat ditampilkan. Setelah menerima, ikon
akan ditambahkan di layar utama dan Chrome akan menampilkan toast keberhasilan.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-27 UTC."],[],[],null,["# Widgets and shortcuts\n\nThe new flow API for adding shortcuts and widgets in Android 8.0 allows\napp developers to add shortcuts and widgets from inside the app instead\nof relying on the widget tray. It also deprecates the old method (sending a\nbroadcast) of adding shortcuts for security reasons.\n\n\nLaunchers need to support this new implementation so that app developers can\nrely on the system to add their shortcut or widget.\n\nExamples and source\n-------------------\n\n\nDocs are available in various system class. References include the following:\n\n- **[ShortcutManager.java](https://developer.android.com/reference/android/content/pm/ShortcutManager.html)** \n Publish Pinned shortcut section in header.\n- **Intent.java** \n Javadoc for ACTION_CREATE_SHORTCUT.\n- **AppWidgetManager.java** \n Javadoc for requestPinAppWidget.\n\nImplementation\n--------------\n\n\nDevice implementers need to add an activity in their launcher with intent filter actions:\n\n- `android.content.pm.action.CONFIRM_PIN_SHORTCUT`\n- `android.content.pm.action.CONFIRM_PIN_APPWIDGET`\n\n\nRefer to the [API\ndocumentation](https://developer.android.com/reference/android/content/pm/LauncherApps.html) for more details.\n\n\nThis activity should display a confirmation prompt to the user to add the [requested\nwidget/shortcut](https://developer.android.com/reference/android/content/pm/LauncherApps.html) and upon accepting, add the corresponding widget/shortcut on\nthe homescreen.\n\n\nIn case of widgets, the `accept()` call should include the widget ID\nof the newly added widget.\n\n### Implementing a System UI\n\n\nPartners need to update their Launcher app using the Launcher3 implementation\n(`packages/apps/Launcher3`) as reference.\n\n\nFind the relevant Launcher3 changes in the Android Open Source Project (AOSP):\n\n- Change-Id: [8b2002e28072c52d78f6d052c6ff6da50a2d0324](https://android.googlesource.com/platform/packages/apps/Launcher3/+/8b2002e28072c52d78f6d052c6ff6da50a2d0324)\n- Change-Id: [278359539c02ca160caf1df54ce96053a2a2ef59](https://android.googlesource.com/platform/packages/apps/Launcher3/+/278359539c02ca160caf1df54ce96053a2a2ef59)\n\nValidation\n----------\n\n\nTo validate the feature, try to add shortcuts from Chrome or the Contacts app\nand verify that a proper confirmation prompt is shown. Upon accepting, the icon\nshould get added on the homescreen and Chrome should display a success toast."]]
