Come sviluppatori Android, tutti noi usiamo Android Studio per sviluppare le nostre applicazioni. Ci sono molti altri editor che possono essere utilizzati per lo sviluppo di applicazioni Android, ma la parte migliore che mi attrae nell’utilizzare Android Studio è il supporto che fornisce agli sviluppatori Android. Il supporto può essere sotto forma di auto-suggestione o può essere della forma di mostrare errori nel nostro codice (in tutti i file presenti nel nostro progetto).
Quindi, in questo blog, vedremo una delle migliori caratteristiche di Android Studio che ci aiuta a migliorare il nostro modo di scrivere codice senza errori e questa caratteristica è Lint. Gli argomenti che saranno discussi in questo blog sono:
- Che cos’è Lint?
- Configurazione di lint
- Aiutare Lint
- Utilizzare Baseline
- Eseguire manualmente le ispezioni
- Conclusione
Perciò, cominciamo.
Che cos’è Lint?
Lint è uno strumento di scansione del codice fornito da Android Studio per identificare, suggerire e correggere il codice sbagliato o rischioso presente nel progetto.
Lint è come un vero e proprio framework di analisi dello stack
Tutti noi abbiamo usato Lint da quando abbiamo iniziato ad usare Android Studio perché per default Android Studio fornisce il supporto per Lint in ogni nostro progetto. I problemi rilevati nel vostro codice da Lint vi verranno segnalati con alcuni suggerimenti e un livello di avvertimento. Potete usare il suggerimento per correggere il vostro codice. La parte migliore di Lint è che potete usare Lint secondo le vostre necessità. Se volete vedere un particolare tipo di errore nel vostro progetto, allora Lint vi mostrerà solo quel tipo di errore. Lint è personalizzabile in natura. Per impostazione predefinita Android Studio esegue il processo di ispezione ogni volta che si costruisce il progetto, ma a parte questo, è possibile ispezionare il codice con l’aiuto di Lint manualmente o dalla riga di comando.
La seguente immagine mostra il funzionamento di Lint:
Picture courtesy: Android Developer website
L’intero processo di lint può essere riassunto in tre passi:
- Creare il file lint.xml: Puoi personalizzare i controlli di Lint nel file lint.xml. In questo file, puoi scrivere i controlli che vuoi includere e ignorare i controlli che non vuoi includere. Per esempio, se volete controllare il problema delle variabili inutilizzate e non volete controllare i problemi di denominazione, allora potete farlo nel file lint.xml. Oltre a questo, è possibile personalizzare i controlli di Lint anche manualmente. Vedremo come fare i controlli manuali di Lint nella prossima parte di questo blog.
- File sorgente dell’applicazione: Il prossimo passo è quello di selezionare i file sorgente su cui si vuole eseguire il controllo Lint. Può essere il vostro file .java o .kt o qualsiasi file xml del vostro progetto.
- Lo strumento Lint: Infine, lo strumento lint prende i file sorgente e lint.xml e controlla i problemi strutturali del codice e suggerisce alcuni miglioramenti nel codice se ce ne sono. Si suggerisce di usare il suggerimento di lint prima di pubblicare la nostra app.
Quando usare Lint?
Se volete pubblicare la vostra app sul play store o qualsiasi app store allora vorreste avere un’app senza errori. Per questo scopo, devi eseguire tanti test sulla tua app manualmente. Ma se vuoi liberarti di alcuni dei test manuali, puoi usare Lint nel tuo progetto. Potete ispezionare ogni singolo file del vostro codice per trovare qualche errore e Lint identificherà gli errori e suggerirà alcune risposte. Questi errori o avvertimenti possono essere di:
- Variabili non usate
- Eccezioni non usate
- Importazioni che non sono usate nel progetto, e molti altri
Quindi, prima di pubblicare la tua applicazione, dovresti usare Lint per ispezionare completamente il tuo codice.
Inoltre, puoi configurare il controllo Lint per diversi livelli del tuo progetto:
- Globalmente (intero progetto)
- Modulo progetto
- Modulo produzione
- Modulo test
- File aperti
- Classe gerarchia
- Sistema di controllo delle versioni (VCS) scope
Configurazione di Lint
Per usare Lint o semplicemente eseguire ispezioni nel tuo progetto, è possibile aggiungere l’ispezione Lint nel file lint.xml o puoi selezionare manualmente l’elenco dei problemi da configurare con Lint nel tuo progetto usando Android Studio.
- Configura il file Lint: Per specificare i controlli manuali nella tua applicazione, aggiungi l’elenco dei problemi da configurare nel file lint.xml. Se stai creando un nuovo file lint.xml, assicurati di metterlo nella directory principale del tuo progetto Android.
Di seguito un esempio di file lint.xml:
<?xml version="1.0" encoding="UTF-8"?><lint> <!-- Disable the given check in this project --> <issue severity="ignore" /> <!-- Ignore the ObsoleteLayoutParam issue in the specified files --> <issue> <ignore path="res/layout/activation.xml" /> <ignore path="res/layout-xlarge/activation.xml" /> </issue> <!-- Ignore the UselessLeaf issue in the specified file --> <issue> <ignore path="res/layout/main.xml" /> </issue> <!-- Change the severity of hardcoded strings to "error" --> <issue severity="error" /></lint>- Configura il lint manualmente: Per impostazione predefinita, lint controlla un certo numero di problemi ma non tutti. Questo non viene fatto perché se si eseguono tutti i controlli dei problemi che lint può controllare, allora le prestazioni di Android Studio saranno rallentate. Quindi, solo un numero limitato di controlli lint sono utilizzati in Android Studio per impostazione predefinita. Ma è possibile aggiungere più controlli e rimuovere i controlli da lint seguendo i passi seguenti:
Vai a File > Impostazioni > Editor > Ispezioni e poi controlla i controlli che vuoi che siano eseguiti da lint
Helping Lint
Ci sono molte volte in cui stai scrivendo un codice rischioso o pieno di errori ma il lint non mostra alcun errore o avviso al tuo codice. Per esempio, scrivete il seguente codice in Android Studio:
fun updateUi() { // code goes here networkRequest()}fun networkRequest() { // code goes here }Le linee di codice di cui sopra non vi mostreranno alcun errore, ma logicamente dovrebbe mostrare qualche errore perché, durante l’aggiornamento della UI, la richiesta di rete non dovrebbe essere chiamata. Quindi, quello che puoi fare qui è aiutare il lint.
Help Lint ti aiuta
Sì, se tu aiuti il lint allora anche il lint ti aiuterà. Quindi, per aiutare il lint a capire il codice in modo più preciso, cercate sempre di usare le annotazioni nel vostro progetto. Ora scrivete lo stesso codice che avete scritto in precedenza e poi controllate gli errori:
@UiThreadfun updateUi() { // code goes here networkRequest()}@WorkerThreadfun networkRequest() { // code goes here}Così, aiutate Lint usando le annotazioni nel vostro codice.
Usando la Baseline
Se state lavorando su un progetto molto grande e siete interessati a trovare gli errori futuri che potrebbero verificarsi aggiungendo altri codici al vostro progetto, allora potete aggiungere una baseline al vostro progetto e così facendo Lint genererà gli errori che si sono verificati dopo quella baseline. Quindi, lint ignorerà i problemi del codice precedente e ti avvertirà solo delle nuove linee di codice aggiunte dopo la linea di base.
Per aggiungere una linea di base al tuo progetto, aggiungi la seguente linea nel file build.gradle del tuo progetto:
android { lintOptions { baseline file("lint-baseline.xml") }}Questo creerà un lint-baseline.xml che stabilirà una linea di base del tuo progetto. Per aggiungere un’altra baseline, cancella il file e la lint di nuovo.
Un’altra cosa che puoi fare qui è, puoi abilitare qualsiasi tipo di controllo dei problemi solo qui. Per esempio, per abilitare il controllo di interoperabilità di Kotlin, scrivi il seguente codice:
android { lintOptions { baseline file("lint-baseline.xml") }}enable "Interoperability"Esegui manualmente le ispezioni
Per ispezionare manualmente un file in Android Studio, segui i seguenti passi:
Passo 1: Vai al file che vuoi ispezionare.
Passo 2: Fai clic con il tasto destro e poi vai su Analyze > Inspect Code. Si aprirà la seguente finestra:
Immagine per gentile concessione: Android Developer website
Qui potete selezionare il vostro ambito di ispezione, cioè l’intero progetto o modulo o semplicemente un file. Dopo aver selezionato lo scopo clicca su OK.
Si aprirà la seguente finestra:
Immagine di cortesia: Android Developer website
Ci sarà un elenco di categorie di errore, tipi e problemi. È possibile visualizzare il risultato dell’ispezione espandendo l’errore nella vista ad albero del pannello di sinistra.
Nell’altro pannello, quello di destra, viene visualizzato il rapporto di ispezione per l’errore selezionato.
Conclusione
In questo blog, abbiamo imparato come utilizzare Lint in Android Studio. Abbiamo visto che se vogliamo analizzare il nostro codice non dobbiamo farlo manualmente. Android Studio fornisce uno strumento di controllo del codice Lint, che ci aiuta a pulire il nostro codice e ad usare il codice necessario e giusto per lo sviluppo dell’applicazione.
Quindi, usa Lint per la rimozione di vari tipi di errori nel tuo progetto e aiuta anche il Lint ad aiutarti.
Continua ad imparare 🙂
Team MindOrks.