Creare 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 delle app.

Pubblica 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 nel launcher.

Oltre a mostrare le scorciatoie nel launcher, utilizza la libreria Google Shortcuts Integration 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 rank delle scorciatoie che devono essere visualizzate nei launcher supportati chiamando il metodo setRank().

Limitare la lunghezza della descrizione della scorciatoia

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

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

Mantenere la cronologia di utilizzo di scorciatoie e azioni

Per ogni scorciatoia che crei, valuta i diversi modi in cui un utente può svolgere la stessa attività direttamente all'interno della tua app. Chiama reportShortcutUsed() in ognuna di queste situazioni in modo che il launcher 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 mantenuto

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

• Scorciatoie dinamiche: pushDynamicShortcut().

• Scorciatoie fissate: requestPinShortcut().

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

Controlla le scorciatoie dinamiche ogni volta che avvii l'app

Le scorciatoie dinamiche non vengono conservate quando l'utente ripristina i propri 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 di ripubblicare le scorciatoie dinamiche in base alle necessità, come mostrato nello snippet di codice in Backup e ripristino.