Membuat pintasan

Saat merancang dan membuat pintasan aplikasi, ikuti panduan berikut:

Ikuti panduan desain

Untuk membuat pintasan aplikasi Anda konsisten secara visual dengan pintasan yang digunakan untuk aplikasi sistem, ikuti Panduan Desain Ikon Pintasan Aplikasi.

Hanya publikasikan empat pintasan yang berbeda

Meskipun API mendukung kombinasi hingga 15 pintasan statis dan dinamis untuk aplikasi Anda, sebaiknya hanya publikasikan 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 mendorong pintasan dinamis dalam jumlah tak terbatas. Jika Anda menggunakan library ini untuk mendorong sejumlah besar pintasan, sebaiknya tetapkan rank pintasan yang harus muncul di peluncur yang didukung dengan memanggil metode setRank().

Batasi panjang deskripsi pintasan

Ruang di menu yang menampilkan pintasan aplikasi Anda di peluncur terbatas. 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 artikel Menyesuaikan nilai atribut. Untuk pintasan dinamis dan yang dipasangi pin, baca dokumentasi referensi tentang setLongLabel() dan setShortLabel().

Simpan histori penggunaan pintasan dan tindakan

Untuk setiap pintasan yang Anda buat, pertimbangkan berbagai cara pengguna dapat menyelesaikan tugas yang sama secara langsung dalam aplikasi Anda. Panggil reportShortcutUsed() dalam setiap situasi ini sehingga peluncur mempertahankan histori akurat tentang seberapa sering pengguna melakukan tindakan yang merepresentasikan pintasan Anda.

Perbarui pintasan hanya saat artinya dipertahankan

Saat mengubah pintasan dinamis dan yang dipasangi pin, panggil updateShortcuts() hanya saat Anda mengubah informasi pintasan yang mempertahankan artinya. Atau, gunakan salah satu metode berikut, bergantung pada jenis pintasan yang Anda buat ulang:

• Pintasan dinamis: pushDynamicShortcut().

• Pintasan yang disematkan: requestPinShortcut().

  Misalnya, jika Anda membuat pintasan untuk menavigasi ke swalayan, akan sangat wajar untuk memperbarui pintasan apabila nama swalayan diubah, tetapi lokasinya tetap sama. Namun, jika pengguna mulai berbelanja di swalayan yang lokasinya berbeda, sebaiknya buat pintasan baru.

Periksa pintasan dinamis setiap kali Anda meluncurkan aplikasi

Pintasan dinamis tidak dipertahankan saat pengguna memulihkan datanya ke perangkat baru. Oleh karena itu, sebaiknya periksa jumlah objek yang ditampilkan oleh getDynamicShortcuts() setiap kali Anda meluncurkan aplikasi dan memublikasikan ulang pintasan dinamis sesuai kebutuhan, seperti yang ditunjukkan pada cuplikan kode di Pencadangan dan pemulihan.