Cómo crear accesos directos

Para diseñar y crear los accesos directos de tu app, sigue estos lineamientos:

Sigue los lineamientos de diseño

Para lograr que los accesos directos de tu app sean visualmente coherentes con los que se usan para las apps de sistemas, sigue los Lineamientos de diseño de íconos de accesos directos a aplicaciones.

Publica solo cuatro accesos directos distintos

Aunque la API admite una combinación de hasta 15 accesos directos estáticos y dinámicos para tu app, te recomendamos que publiques solo cuatro accesos directos distintos para mejorar su apariencia visual en el selector.

Además de mostrar accesos directos en el selector, usa la Biblioteca de integración de accesos directos de Google para mostrar accesos directos en las plataformas de Google, como Asistente de Google. Esta biblioteca admite el envío de una cantidad ilimitada de accesos directos dinámicos. Si utilizas esta biblioteca para enviar una gran cantidad de accesos directos, te recomendamos que configures el rank de los accesos directos que deben aparecer en los selectores compatibles llamando al método setRank().

Limita la longitud de la descripción del acceso directo

El espacio en el menú que muestra los accesos directos de tu app en el selector es limitado. Cuando sea posible, limita la longitud de la "descripción breve" de un acceso directo a 10 caracteres y la de la "descripción larga" a 25 caracteres.

Para obtener más información sobre las etiquetas para accesos directos estáticos, consulta Cómo personalizar valores de atributos. Para los accesos directos dinámicos y fijos, consulta la documentación de referencia en setLongLabel() y setShortLabel().

Conserva el historial de uso de accesos directos y acciones

Para cada atajo que crees, considera las diferentes formas en que un usuario puede realizar la misma tarea directamente en tu app. Llama a reportShortcutUsed() en cada una de estas situaciones para que el selector mantenga un historial preciso de la frecuencia con la que un usuario realiza las acciones que representan tus atajos.

Actualiza los accesos directos solo cuando se conserve su significado

Cuando cambies los accesos directos dinámicos y fijos, llama a updateShortcuts() solo cuando cambies la información de un acceso directo que conserve su significado. De lo contrario, usa uno de los siguientes métodos, según el tipo de acceso directo que estés recreando:

• Accesos directos dinámicos: pushDynamicShortcut()

• Accesos directos fijados: requestPinShortcut()

  Por ejemplo, si creas un acceso directo para navegar a un supermercado, es apropiado actualizarlo si el nombre del supermercado cambia, pero la ubicación sigue siendo la misma. Sin embargo, si el usuario comienza a comprar en un supermercado diferente, es mejor que crees un acceso directo nuevo.

Verifica los accesos directos dinámicos cada vez que inicies tu app por primera vez

Los accesos directos dinámicos no se conservan cuando el usuario restablece sus datos en un dispositivo nuevo. Por este motivo, te recomendamos que verifiques la cantidad de objetos que muestra getDynamicShortcuts() cada vez que inicias tu app y que vuelvas a publicar accesos directos dinámicos según sea necesario, como se muestra en el fragmento de código de Copia de seguridad y restablecimiento.