In qualità di sviluppatore, puoi definire scorciatoie per eseguire azioni specifiche nella tua app. Puoi visualizzare queste scorciatoie in un launcher o assistente supportato e aiutare gli utenti ad avviare rapidamente le attività comuni o consigliate all'interno della tua app.
Questa documentazione mostra come creare e gestire le scorciatoie delle app. Puoi anche scoprire alcune best practice per migliorare le scorciatoie.
Tipi di scorciatoie
Ogni scorciatoia fa riferimento a uno o più intent, ognuno dei quali avvia un' azione specifica nella tua app quando gli utenti selezionano la scorciatoia. I tipi di scorciatoie che crei per la tua app dipendono dal caso d'uso dell'app. Ecco alcuni esempi di azioni che puoi esprimere come scorciatoie:
- Comporre una nuova email in un'app email.
- Indirizzare gli utenti a una posizione specifica in un'app di mappe.
- Inviare messaggi al contatto di un utente in un'app di comunicazione.
- Riprodurre la puntata successiva di un programma TV in un'app multimediale.
- Caricare l'ultimo punto di salvataggio in un'app di gioco.
- Consentire all'utente di ordinare una bevanda in un'app di consegna utilizzando i comandi vocali.
Puoi pubblicare i seguenti tipi di scorciatoie per la tua app:
- Le scorciatoie statiche sono definite in un file di risorse incluso in un APK o in un app bundle.
- Le scorciatoie dinamiche possono essere inviate, aggiornate e rimosse dalla tua app solo in fase di runtime.
Le scorciatoie aggiunte alla schermata Home possono essere aggiunte ai launcher supportati in fase di runtime se l'utente concede l'autorizzazione.
Visualizzare le scorciatoie negli assistenti utilizzando le funzionalità
Le funzionalità in shortcuts.xml ti consentono di dichiarare i tipi di azioni che gli utenti possono intraprendere per avviare la tua app e passare direttamente all'esecuzione di un'attività specifica. Per
maggiori dettagli, consulta la documentazione sull'aggiunta di funzionalità.
Limitazioni delle scorciatoie
La maggior parte dei launcher supportati mostra fino a quattro scorciatoie alla volta, incluse sia le scorciatoie statiche sia quelle dinamiche. Quando invii scorciatoie dinamiche per la visualizzazione sulle piattaforme Google, utilizza la libreria Google Shortcuts Integration per evitare di essere soggetto al limite di scorciatoie.
Se scegli di non utilizzare la libreria Google Shortcuts Integration, la tua app è soggetta al limite del dispositivo per il numero di scorciatoie che supporta alla volta. Le scorciatoie pubblicate in questo modo vengono visualizzate solo all'interno dei launcher Android e non sono rilevabili su altre piattaforme Google.
Non esiste un limite al numero di scorciatoie aggiunte alla schermata Home che gli utenti possono creare per la tua app. La tua app non può rimuovere le scorciatoie aggiunte alla schermata Home, ma può disattivarle.
Per iniziare a creare scorciatoie per la tua app, consulta la seguente documentazione:
Per maggiori dettagli sulle operazioni che puoi eseguire sulle scorciatoie, consulta la
ShortcutManager documentazione di riferimento dell'API.