Best practice per le scorciatoie

Quando progetti e crei le scorciatoie della tua app, segui queste linee guida:

Segui le linee guida per la progettazione

Per rendere le scorciatoie della tua app visivamente coerenti con quelle utilizzate per le app di sistema, segui le linee guida per la progettazione delle icone delle scorciatoie app.

Pubblicare solo quattro scorciatoie distinte

Sebbene l'API supporti una combinazione di un massimo di 15 scorciatoie statiche e dinamiche per la tua app, ti consigliamo di pubblicare solo quattro scorciatoie distinte, per migliorarne l'aspetto visivo in Avvio app.

Oltre a visualizzare le scorciatoie in Avvio app, utilizza la libreria di integrazione delle scorciatoie di Google per mostrare le scorciatoie sulle piattaforme Google come l'Assistente Google. Questa libreria supporta il push di un numero illimitato di scorciatoie dinamiche. Se utilizzi questa libreria per eseguire il push di un numero elevato di scorciatoie, ti consigliamo di impostare il rank delle scorciatoie che devono essere visualizzate nei Avvio app supportati chiamando il metodo setRank().

Limita la lunghezza della descrizione della scorciatoia

Lo spazio nel menu che mostra le scorciatoie dell'app in Avvio app è limitato. Se possibile, limita la lunghezza della "descrizione breve" di una scorciatoia a 10 caratteri e limita la lunghezza della "descrizione lunga" a 25 caratteri.

Per saperne di più sulle etichette per le scorciatoie statiche, consulta Personalizzare i valori degli attributi. Per le scorciatoie dinamiche e bloccate, leggi la documentazione di riferimento su setLongLabel() e setShortLabel().

Gestire la cronologia di utilizzo di scorciatoie e azioni

Per ogni scorciatoia che crei, considera i diversi modi in cui un utente può eseguire la stessa attività direttamente all'interno dell'app. Chiama reportShortcutUsed() in ognuna di queste situazioni per fare in modo che Avvio app mantenga una cronologia accurata della frequenza con cui un utente esegue le azioni che rappresentano le tue scorciatoie.

Aggiornare le scorciatoie solo quando il loro significato viene conservato

Quando modifichi le scorciatoie dinamiche e bloccate, chiama updateShortcuts() solo se modifichi le informazioni di una scorciatoia che conserva il suo significato. In caso contrario, utilizza uno dei seguenti metodi, a seconda del tipo di scorciatoia che stai ricreando:

Ad esempio, se crei una scorciatoia per raggiungere un supermercato, è opportuno aggiornarla se il nome del supermercato cambia ma la sua posizione rimane invariata. Se l'utente inizia a fare acquisti in un altro supermercato, tuttavia, è meglio creare una nuova scorciatoia.

Controllare le scorciatoie dinamiche ogni volta che avvii l'app

Le scorciatoie dinamiche non vengono mantenute quando l'utente ripristina i suoi dati su un nuovo dispositivo. Per questo motivo, ti consigliamo di controllare il numero di oggetti restituiti da getDynamicShortcuts() ogni volta che avvii l'app e ripubblicare le scorciatoie dinamiche secondo necessità, come mostrato nello snippet di codice in Backup e ripristino.