In qualità di sviluppatore, puoi definire scorciatoie per eseguire azioni specifiche nella tua app. Puoi visualizzare queste scorciatoie in un Avvio app o un assistente supportato e aiutare gli utenti ad avviare rapidamente attività comuni o consigliate all'interno della tua app.
Questa documentazione spiega come creare e gestire le scorciatoie per le app. Puoi anche scoprire alcune best practice per migliorare le tue 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:
- Scrivere una nuova email in un'app email.
- Indirizzare gli utenti a una determinata località in un'app di mappe.
- Invio di messaggi a un contatto dell'utente in un'app di comunicazione.
- Riproduzione della puntata successiva di un programma TV in un'app multimediale.
- Caricamento dell'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 pacchettizzato in un APK o un app bundle.
- Le scorciatoie dinamiche possono essere inviate, aggiornate e rimosse dalla tua app solo in fase di runtime.
Le scorciatoie bloccate possono essere aggiunte ai launcher supportati in fase di runtime se l'utente concede l'autorizzazione.
Visualizza le scorciatoie negli assistenti utilizzando le funzionalità
Le funzionalità in shortcuts.xml ti consentono di dichiarare i tipi di azioni che gli utenti possono eseguire 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 quelle statiche sia quelle dinamiche. Quando esegui il push delle scorciatoie dinamiche per la visualizzazione sulle piattaforme Google, utilizza la libreria Google Shortcuts Integration per evitare di essere soggetto al limite delle scorciatoie.
Se scegli di non utilizzare la libreria di integrazione delle scorciatoie di Google, la tua app è soggetta al limite del dispositivo per il numero di scorciatoie supportate contemporaneamente. Le scorciatoie pubblicate in questo modo vengono visualizzate solo nei launcher Android e non sono rilevabili su altre piattaforme Google.
Non esiste un limite al numero di scorciatoie bloccate che gli utenti possono creare per la tua app. La tua app non può rimuovere le scorciatoie bloccate, 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 documentazione di riferimento dell'API ShortcutManager.