Praktik terbaik untuk pintasan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Saat mendesain dan membuat pintasan aplikasi, ikuti panduan berikut:
-
Mengikuti panduan desain
-
Untuk membuat pintasan aplikasi Anda konsisten secara visual dengan pintasan yang digunakan untuk aplikasi sistem, ikuti
Panduan Desain Ikon Pintasan Aplikasi.
-
Hanya memublikasikan empat pintasan yang berbeda
-
Meskipun API mendukung kombinasi hingga 15 pintasan statis dan dinamis untuk aplikasi Anda, sebaiknya
publikasikan hanya empat pintasan yang berbeda untuk meningkatkan tampilan visualnya di
peluncur.
Selain menampilkan pintasan di peluncur, gunakan
Library Integrasi Pintasan Google
untuk menampilkan pintasan di platform Google seperti Asisten Google. Library ini mendukung pengiriman
pintasan dinamis dalam jumlah tak terbatas. Jika Anda menggunakan library ini untuk mengirim banyak
pintasan, sebaiknya tetapkan rank pintasan yang harus muncul di peluncur
yang didukung dengan memanggil
metode
setRank().
-
Batasi panjang deskripsi pintasan
-
Ruang pada menu yang menampilkan pintasan aplikasi Anda di peluncur dibatasi. Jika memungkinkan,
batasi panjang "deskripsi singkat" pintasan hingga 10 karakter dan batasi panjang "deskripsi panjang" hingga 25 karakter.
Untuk mengetahui informasi selengkapnya tentang label untuk pintasan statis, baca
Menyesuaikan nilai atribut.
Untuk pintasan dinamis dan yang disematkan, baca dokumentasi referensi tentang
setLongLabel()
dan
setShortLabel().
-
Mempertahankan histori penggunaan pintasan dan tindakan
-
Untuk setiap pintasan yang Anda buat, pertimbangkan berbagai cara yang dapat digunakan pengguna untuk menyelesaikan tugas
yang sama secara langsung dalam aplikasi Anda. Panggil
reportShortcutUsed()
dalam setiap situasi ini sehingga peluncur dapat menyimpan histori yang akurat tentang seberapa sering
pengguna melakukan tindakan yang merepresentasikan pintasan Anda.
-
Memperbarui pintasan hanya jika artinya dipertahankan
-
Saat mengubah pintasan dinamis dan yang disematkan, hanya panggil
updateShortcuts()
saat mengubah informasi pintasan yang mempertahankan artinya. Jika tidak, gunakan salah satu
metode berikut, bergantung pada jenis pintasan yang Anda buat ulang:
Misalnya, jika Anda membuat pintasan untuk menavigasi ke supermarket, sebaiknya perbarui pintasan tersebut jika nama supermarket berubah tetapi lokasinya tetap sama. Namun, jika
pengguna mulai berbelanja di lokasi supermarket lain, sebaiknya buat pintasan
baru.
-
Memeriksa pintasan dinamis setiap kali Anda meluncurkan aplikasi
-
Pintasan dinamis tidak dipertahankan apabila pengguna memulihkan datanya ke perangkat baru. Karena
alasan ini, sebaiknya periksa jumlah objek yang ditampilkan oleh
getDynamicShortcuts()
setiap kali Anda meluncurkan aplikasi dan publikasikan ulang pintasan dinamis sesuai kebutuhan, seperti yang ditunjukkan dalam cuplikan
kode di
Pencadangan dan pemulihan.
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,["# Best practices for shortcuts\n\nWhen designing and creating your app's shortcuts, follow these guidelines:\n\n\n**Follow the design guidelines**\n\n: To make your app's shortcuts visually consistent with the shortcuts used for system apps, follow\n the\n [App Shortcuts Icon Design Guidelines](/static/shareables/design/app-shortcuts-design-guidelines.pdf).\n\n\n**Publish only four distinct shortcuts**\n\n: Although the API supports a combination of up to 15 static and dynamic shortcuts for your app, we\n recommend that you publish only four distinct shortcuts, to improve their visual appearance in the\n launcher.\n\n In addition to displaying shortcuts on the launcher, use the\n [Google Shortcuts Integration Library](/develop/ui/views/launch/shortcuts/creating-shortcuts#gsi-library)\n to display shortcuts on Google surfaces such as Google Assistant. This library supports pushing an\n unlimited number of dynamic shortcuts. If you are using this library to push a large number of\n shortcuts, we recommend setting the `rank` of the shortcuts that must appear in supported\n launchers by calling the\n [](/reference/androidx/core/content/pm/ShortcutInfoCompat.Builder#setRank(int))`setRank()`\n method.\n\n\n**Limit shortcut description length**\n\n: The space in the menu that shows your app's shortcuts in the launcher is limited. When possible,\n limit the length of the \"short description\" of a shortcut to 10 characters and limit the length of\n the \"long description\" to 25 characters.\n\n For more information about labels for static shortcuts, read\n [Customize attribute values](/guide/topics/ui/shortcuts/creating-shortcuts#attribute-values).\n For dynamic and pinned shortcuts, read the reference documentation on\n [setLongLabel()](/reference/androidx/core/content/pm/ShortcutInfoCompat.Builder#setLongLabel(java.lang.CharSequence))\n and\n [setShortLabel()](/reference/androidx/core/content/pm/ShortcutInfoCompat.Builder#setShortLabel(java.lang.CharSequence)).\n\n\n**Maintain shortcut and action usage history**\n\n: For each shortcut you create, consider the different ways a user can accomplish the same task\n directly within your app. Call\n [reportShortcutUsed()](/reference/androidx/core/content/pm/ShortcutManagerCompat#reportShortcutUsed(android.content.Context,%20java.lang.String))\n in each of these situations so that the launcher maintains an accurate history of how frequently a\n user performs the actions representing your shortcuts.\n\n\n**Update shortcuts only when their meaning is retained**\n\n: When changing dynamic and pinned shortcuts, only call\n [updateShortcuts()](/reference/androidx/core/content/pm/ShortcutManagerCompat#updateShortcuts(android.content.Context,%20java.util.List%3Candroidx.core.content.pm.ShortcutInfoCompat%3E))\n when changing the information of a shortcut that retains its meaning. Otherwise, use one of the\n following methods, depending on the type of shortcut you're recreating:\n\n - Dynamic shortcuts: [pushDynamicShortcut()](/reference/androidx/core/content/pm/ShortcutManagerCompat#pushDynamicShortcut(android.content.Context,%20androidx.core.content.pm.ShortcutInfoCompat)).\n - Pinned shortcuts: [requestPinShortcut()](/reference/androidx/core/content/pm/ShortcutManagerCompat#requestPinShortcut(android.content.Context,%20androidx.core.content.pm.ShortcutInfoCompat,%20android.content.IntentSender)).\n\n For example, if you create a shortcut for navigating to a supermarket, it is appropriate to\n update the shortcut if the name of the supermarket changes but its location stays the same. If the\n user begins shopping at a different supermarket location, however, it's better to create a new\n shortcut.\n\n\n**Check dynamic shortcuts whenever you launch your app**\n\n: Dynamic shortcuts aren't preserved when the user restores their data onto a new device. For this\n reason, we recommend that you check the number of objects returned by\n [getDynamicShortcuts()](/reference/androidx/core/content/pm/ShortcutManagerCompat#getDynamicShortcuts(android.content.Context))\n each time you launch your app and re-publish dynamic shortcuts as needed, as shown in the code\n snippet in\n [Backup and restore](/guide/topics/ui/shortcuts/managing-shortcuts#backup-restore)."]]
