Bonnes pratiques pour les raccourcis

Lorsque vous concevez et créez les raccourcis de votre application, suivez ces consignes:

Respecter les consignes de conception

Pour que les raccourcis de votre application soient visuellement cohérents avec ceux utilisés pour les applications système, suivez les consignes de conception des icônes de raccourcis d'application.

Ne publier que quatre raccourcis distincts

Bien que l'API accepte jusqu'à 15 raccourcis statiques et dynamiques pour votre application, nous vous recommandons de ne publier que quatre raccourcis distincts afin d'améliorer leur apparence visuelle dans le lanceur d'applications.

En plus d'afficher des raccourcis dans le lanceur d'applications, utilisez la bibliothèque d'intégration de raccourcis Google pour afficher des raccourcis sur les surfaces Google telles que l'Assistant Google. Cette bibliothèque permet de transmettre un nombre illimité de raccourcis dynamiques. Si vous utilisez cette bibliothèque pour transférer un grand nombre de raccourcis, nous vous recommandons de définir le rank des raccourcis qui doivent apparaître dans les lanceurs d'applications compatibles en appelant la méthode setRank().

Limiter la longueur de la description du raccourci

L'espace du menu qui affiche les raccourcis de votre application dans le Lanceur d'applications est limité. Dans la mesure du possible, limitez la longueur de la "description courte" d'un raccourci à 10 caractères et celle de la "description longue" à 25 caractères.

Pour en savoir plus sur les libellés des raccourcis statiques, consultez Personnaliser les valeurs d'attribut. Pour les raccourcis dynamiques et épinglés, consultez la documentation de référence sur setLongLabel() et setShortLabel().

Conserver l'historique d'utilisation des raccourcis et des actions

Pour chaque raccourci que vous créez, réfléchissez aux différentes façons dont un utilisateur peut accomplir la même tâche directement dans votre application. Appelez reportShortcutUsed() dans chacune de ces situations afin que le lanceur d'applications conserve un historique précis de la fréquence à laquelle un utilisateur effectue les actions correspondant à vos raccourcis.

Mettre à jour les raccourcis uniquement si leur signification est conservée

Lorsque vous modifiez des raccourcis dynamiques et épinglés, n'appelez updateShortcuts() que lorsque vous modifiez les informations d'un raccourci qui conserve sa signification. Sinon, utilisez l'une des méthodes suivantes, en fonction du type de raccourci que vous recréez:

• Raccourcis dynamiques : pushDynamicShortcut().
• Raccourcis épinglés : requestPinShortcut().

Par exemple, si vous créez un raccourci pour accéder à un supermarché, il est approprié de le mettre à jour si le nom du supermarché change, mais que son emplacement reste le même. Toutefois, si l'utilisateur commence ses achats dans un autre supermarché, il est préférable de créer un nouveau raccourci.

Vérifier les raccourcis dynamiques chaque fois que vous lancez votre application

Les raccourcis dynamiques ne sont pas conservés lorsque l'utilisateur restaure ses données sur un nouvel appareil. C'est pourquoi nous vous recommandons de vérifier le nombre d'objets renvoyés par getDynamicShortcuts() chaque fois que vous lancez votre application et de republier les raccourcis dynamiques si nécessaire, comme indiqué dans l'extrait de code de la section Sauvegarde et restauration.