Android Kotlin Fundamentals 01.1: inizia

Questo codelab fa parte del corso Android Kotlin Fundamentals. Otterrai il massimo valore da questo corso se lavori in sequenza nei codelab. Tutti i codelab del corso sono elencati nella pagina di destinazione di Android Kotlin Fundamentals.

Introduzione

In questo codelab puoi creare ed eseguire la tua prima app per Android, HelloWorld, su un emulatore e su un dispositivo fisico. Puoi anche esplorare l'aspetto di un progetto Android.

Cosa dovresti sapere

• Dovresti comprendere il processo di sviluppo software generale per le app orientate agli oggetti utilizzando un IDE (ambiente di sviluppo integrato), come Android Studio.
• Devi avere almeno un anno di esperienza nella programmazione orientata agli oggetti, con almeno una conoscenza di Java e Kotlin.

Cosa imparerai a fare:

• Come creare un'app Android di base in Android Studio.
• Come creare un progetto Android da un modello.
• Come trovare i componenti principali di un progetto Android.
• Come eseguire un'app Android su un emulatore o un dispositivo fisico.

Cosa dovrai fare

• Crea un nuovo progetto Android e un'app predefinita chiamata HelloWorld.
• Crea un emulatore (un dispositivo virtuale) in modo da poter eseguire la tua app sul computer.
• Esegui l'app HelloWorld su dispositivi virtuali e fisici.
• Esplora il layout del progetto.
• Esplora il file AndroidManifest.xml.

L'app HelloWorld visualizza la stringa "Hello World" sullo schermo di un dispositivo virtuale Android o di un dispositivo fisico. Ecco come si presenta l'app:

In questa attività creerai un nuovo progetto di app per verificare che Android Studio sia installato correttamente.

1. Se non è già aperto, apri Android Studio.
2. Nella finestra di dialogo principale Ti diamo il benvenuto in Android Studio, fai clic su Avvia un nuovo progetto Android Studio.
   
   
3. Viene visualizzata la finestra di dialogo Scegli il tuo progetto . Seleziona Attività vuota come mostrato di seguito e fai clic su Avanti.
   
   
   
   L'utente può eseguire una singola Activity e deve essere eseguita in modo mirato. Ogni app deve avere almeno un'attività come punto di accesso. Pensa a questa attività punto di accesso come alla funzione main() di altri programmi. In genere, a un'attività è associato un layout che definisce il modo in cui gli elementi dell'interfaccia utente (UI) vengono visualizzati in una schermata. Android Studio offre diversi modelli di Activity per aiutarti a iniziare.
   
4. Nella finestra di dialogo Configure your project (Configura il tuo progetto), inserisci "HelloWorld" per Nome.
   
   
5. Accetta il dominio android.example.com predefinito per Dominio aziendale o crea un dominio aziendale univoco. Questo valore più il nome dell'app è il nome del pacchetto dell'app. Se non intendi pubblicare l'app, accetta il valore predefinito. Puoi modificare il nome del pacchetto dell'app in un secondo momento, ma dovrai farlo in più.
6. Verifica che l'opzione Salva posizione predefinita sia quella in cui vuoi archiviare l'app. In caso contrario, modifica la posizione in base alla directory che preferisci.
7. Assicurati che la Lingua sia Kotlin.
8. Assicurati che il livello minimo dell'API sia API 19: Android 4.4 (KitKat). Al momento della preparazione di questo codelab, Android Studio ha indicato che, con questo livello API, l'app veniva eseguita su circa il 95,3% dei dispositivi.
   (Scopri di più sui livelli minimi di API in un codelab successivo). Per saperne di più, fai clic su Aiutami a scegliere. Si aprirà una finestra con informazioni sui livelli dell'API.
   
9. Seleziona la casella di controllo Usa artefatti AndroidX.
10. Lascia deselezionate tutte le altre caselle di controllo e fai clic su Fine. Se il tuo progetto richiede più componenti per l'SDK di destinazione scelto, Android Studio li installa automaticamente. L'operazione potrebbe richiedere del tempo. Segui le istruzioni e accetta le opzioni predefinite.

Ora Android Studio crea il tuo progetto, operazione che può richiedere del tempo. Non dovresti visualizzare errori. Se ricevi avvisi, ignorali.

In questa attività esplorerai il progetto HelloWorld in Android Studio e scoprirai le nozioni di base per lo sviluppo con Android Studio.

Passaggio 1: esplora il riquadro Progetto

1. Se la scheda Progetto non è già selezionata, selezionala. La scheda Progetto si trova nella colonna verticale della scheda sul lato sinistro della finestra di Android Studio. Viene aperto il riquadro Progetto.
   
   
   
2. Per visualizzare il progetto come gerarchia di progetti Android standard, seleziona Android dal menu a discesa nella parte superiore del riquadro Progetto. (Android è l'impostazione predefinita). Puoi visualizzare i file di progetto in molti modi diversi, inclusa la visualizzazione dei file nella gerarchia del file system. Tuttavia, è più facile lavorare con il progetto utilizzando la visualizzazione Android.
   
   

Nota: questo codelab e altri fanno riferimento al riquadro Progetto, se impostato su Android, come riquadro Progetto > Android.

Passaggio 2: esplora la cartella dell'app

Tutto il codice e le risorse per la tua app si trovano all'interno della cartella app.

1. Nel riquadro Progetto &Android, espandi la cartella app. All'interno della cartella app sono presenti quattro sottocartelle: manifests, java, generatedJava e res.
2. Espandi la cartella java, quindi espandi la cartella com.example.android.HelloWorld per visualizzare il file Kotlin MainActivity.
   
   
   
   La cartella java contiene tutto il codice Kotlin principale per un'app Android. Esistono motivi storici per cui il codice Kotlin viene visualizzato nella cartella Java. Tale convenzione consente a Kotlin di interagire perfettamente con il codice scritto nel linguaggio di programmazione Java, anche nello stesso progetto e nella stessa app.
   
   I file della classe della tua app sono contenuti in tre sottocartelle, come mostrato nella figura precedente. La cartella com.example.hello.helloworld (o il nome di dominio che hai specificato) contiene tutti i file di un pacchetto dell'app. In particolare, la classe MainActivity è il punto di accesso principale per la tua app. Scopri di più su MainActivity nel prossimo codelab. Le altre due cartelle nella cartella java vengono utilizzate per il codice relativo ai test, come i test delle unità.

Nota: nel file system, i tuoi file Kotlin hanno un'estensione .kt e un'icona K. Nella visualizzazione Progetto, Android Studio mostra il nome della classe (MainActivity) senza estensione.

3. Prendi nota della cartella generateJava. Questa cartella contiene file che vengono generati da Android Studio al momento della creazione dell'app. Non modificare nulla in questa cartella perché le modifiche potrebbero venire sostituite quando crei di nuovo l'app. Tuttavia, è utile conoscere questa cartella quando devi esaminare i file durante il debug.

Passaggio 3: esplora la cartella Res

1. Nel riquadro Progetto > Android, espandi la cartella res.
   
   La cartella res contiene risorse. Le risorse in Android sono contenuti statici utilizzati nelle tue app. Le risorse includono immagini, stringhe di testo, layout dello schermo, stili e valori quali colori esadecimali o dimensioni standard.
   
   Le app Android separano il più possibile il codice e le risorse di Kotlin. In questo modo è molto più semplice trovare tutte le stringhe o le icone utilizzate nell'interfaccia utente dell'app. Inoltre, la modifica di uno di questi file di risorse ha effetto ovunque nel file utilizzato nell'app.
2. All'interno della cartella res, espandi la cartella layout per visualizzare il file activity_main.xml.
   
   
   

Generalmente, la colonna Activity è associata a un file di layout dell'interfaccia utente, definito come file XML nella directory res/layout. In genere, il file di layout prende il nome dalla relativa attività. In questo caso, il nome dell'attività è MainActivity, quindi il layout associato è activity_main.

Passaggio 4: esplora la cartella manifest e il file AndroidManifest.xml

La cartella manifests contiene file che forniscono al sistema Android informazioni essenziali sulla tua app.

1. Espandi la cartella manifests e fai doppio clic su AndroidManifest.xml per aprirla. Il file AndroidManifest.xml contiene i dettagli necessari per il sistema Android per eseguire l'app, incluse le attività che ne fanno parte.
   
   
   
2. Tieni presente che viene fatto riferimento a MainActivity nell'elemento <activity>. Qualsiasi elemento Activity nell'app deve essere dichiarato nel file manifest. Ecco un esempio per MainActivity:

<activity android:name=".MainActivity">
   <intent-filter>
       <action android:name="android.intent.action.MAIN"/>

       <category android:name="android.intent.category.LAUNCHER"/>
   </intent-filter>
</activity>

3. Osserva l'elemento <intent-filter> all'interno di <activity>. Gli elementi <action> e <category> in questo filtro per intent indicano ad Android dove avviare l'app quando l'utente fa clic sull'icona in Avvio applicazioni. Scoprirai di più sui filtri per intent in un codelab successivo.

Il file AndroidManifest.xml è anche il punto in cui definisci tutte le autorizzazioni necessarie per l'app. Le autorizzazioni includono la possibilità per la tua app di leggere i contatti del telefono, inviare dati su Internet o accedere a hardware come la fotocamera del dispositivo.

Gradle è un sistema di automazione che utilizza un linguaggio specifico del dominio per descrivere la struttura, la configurazione e le dipendenze dell'app. Quando compili ed esegui l'app, vedi le informazioni sulla build di Gradle in esecuzione. Puoi anche visualizzare le informazioni sull'installazione dell'APK (Android Package Kit) (APK). APK è il formato file pacchetto che il sistema operativo di Android utilizza per distribuire e installare app per dispositivi mobili.

Esplora il sistema Gradle:

1. Espandi la cartella Gradle Scripts. Nel riquadro Progetto &Android, questa cartella contiene tutti i file necessari per il sistema di compilazione.
   
   
   
2. Cerca il file build.gradle(Project: HelloWorld).
   
   Questo file contiene le opzioni di configurazione comuni a tutti i moduli che compongono il tuo progetto. Ogni progetto di Android Studio contiene un singolo file di build Gradle di primo livello. Questo file definisce i repository e le dipendenze Gradle comuni a tutti i moduli del progetto.
3. Cerca il file build.gradle(Modulo:app).
   
   Oltre al file build.gradle a livello di progetto, ogni modulo ha un file build.gradle proprio. Il file build.gradle a livello di modulo consente di configurare le impostazioni di compilazione per ciascun modulo. L'app HelloWorld ha un solo modulo, il modulo dell'app stessa. Questo file build.gradle è quello che modifichi più spesso quando modifichi le configurazioni di build a livello di app. Ad esempio, modifichi questo file build.gradle quando cambi il livello dell'SDK supportato dalla tua app o quando dichiari nuove dipendenze nella sezione dependencies. Scoprirai di più su entrambi questi argomenti in un codelab successivo.

In questa attività, utilizzerai Gestione dei dispositivi virtuali Android (AVD) per creare un dispositivo virtuale (un emulatore). Il dispositivo virtuale simula la configurazione per un determinato tipo di dispositivo Android. quindi lo utilizzerai per eseguire l'app.

L'emulatore Android è un'applicazione indipendente e ha requisiti di sistema specifici. I dispositivi virtuali potrebbero utilizzare molto spazio su disco. Se riscontri problemi, vedi Eseguire app sull'emulatore Android.

Passaggio 1: crea un dispositivo virtuale Android (AVD)

Per eseguire un emulatore sul computer, devi creare una configurazione che descriva il dispositivo virtuale.

1. In Android Studio, seleziona Strumenti e gestione, oppure fai clic sull'icona Gestione inserzioni nella barra degli strumenti. Viene visualizzata la finestra di dialogo I tuoi dispositivi virtuali. Se hai già creato dispositivi virtuali, la finestra di dialogo li mostra (come mostrato nella figura seguente), altrimenti vedrai un elenco vuoto.
   
   
   
2. Fai clic su +Crea dispositivo virtuale in basso a sinistra nella finestra di dialogo. Viene visualizzata la finestra di dialogo Seleziona hardware che mostra un elenco di dispositivi hardware preconfigurati. Per ogni dispositivo, la tabella fornisce una colonna per le dimensioni di visualizzazione in diagonale (Dimensioni), la risoluzione dello schermo in pixel (Risoluzione) e la densità dei pixel (Densità).
   
   
3. Seleziona un dispositivo, ad esempio Nexus 5x o Pixel XL, e fai clic su Avanti. Viene visualizzata la finestra di dialogo Immagine di sistema.
4. Fai clic sulla scheda Consigliati e scegli la versione del sistema Android da eseguire sul dispositivo virtuale (ad esempio Pie).
   
   
   

Nota: sono disponibili molte più versioni del sistema Android di quelle mostrate nella scheda Consigliate. Per visualizzarli, consulta le schede Immagini x86 e Altre immagini.

Queste immagini utilizzano molto spazio su disco, pertanto solo poche parti sono parte dell'installazione originale. Se il link Scarica è visibile accanto a un'immagine di sistema che vuoi utilizzare, significa che l'immagine non è installata. Fai clic sul link per avviare il download, che può richiedere molto tempo. Al termine del download, fai clic su Fine.

5. Dopo aver scelto un'immagine di sistema, fai clic su Avanti. Viene visualizzata la finestra di dialogo Android Virtual Device (AVD). Controlla la configurazione e fai clic su Fine.

Passaggio 2: esegui l'app sul dispositivo virtuale

Infine, dovrai eseguire la nuova app.

1. In Android Studio, seleziona Esegui > esegui app o fai clic sull'icona Esegui nella barra degli strumenti. Viene visualizzata la finestra di dialogo Seleziona target di deployment che ti avvisa che non ci sono dispositivi disponibili. Questo avviso viene visualizzato se non hai un dispositivo fisico collegato al tuo computer di sviluppo o se non hai ancora avviato un dispositivo virtuale.
2. Nella finestra di dialogo Seleziona target di deployment, in Dispositivi virtuali disponibili, seleziona il dispositivo virtuale che hai creato. Fai clic su OK.
   
   
   
   L'emulatore si avvia e si avvia come un dispositivo fisico. A seconda della velocità del computer, questo processo potrebbe richiedere del tempo. L'app viene creata e, quando l'emulatore è pronto, Android Studio carica l'APK dell'app e lo esegue.
   
   Dovresti vedere l'app HelloWorld come vedi nella figura che segue.
   
   

In questa attività, esegui l'app su un dispositivo mobile fisico, ad esempio un telefono o tablet, se ne hai uno. Testa sempre le tue app sia su dispositivi fisici che virtuali.

Quello che ti serve:

• Un dispositivo Android come smartphone o tablet.
• Un cavo dati USB per collegare il dispositivo Android al computer tramite la porta USB.
• Se utilizzi un sistema Linux o Windows, potrebbe essere necessario eseguire passaggi aggiuntivi. Consulta la documentazione Eseguire app su un dispositivo hardware. Potrebbe anche essere necessario installare il driver USB appropriato per il tuo dispositivo. Per i driver USB basati su Windows, vedi Installare driver USB OEM.

Passaggio 1: attiva il debug USB

Per consentire ad Android Studio di comunicare con il tuo dispositivo Android, devi attivare il debug USB nelle impostazioni Opzioni sviluppatore del dispositivo.

Su Android 4.2 (Jellybean) e versioni successive, le impostazioni Opzioni sviluppatore sono nascoste per impostazione predefinita. Per visualizzare le opzioni sviluppatore e attivare il debug USB:

1. Sul dispositivo, apri Impostazioni, cerca Informazioni sul telefono, tocca Informazioni sul telefono e tocca sette volte Numero build.
2. Torna alla pagina precedente (Impostazioni/Sistema). L'elenco Opzioni sviluppatore viene visualizzato. Tocca Opzioni sviluppatore.
3. Seleziona Debug USB.

Passaggio 2: esegui l'app sul dispositivo Android

Ora puoi connettere il tuo dispositivo ed eseguire l'app da Android Studio.

1. Collega il dispositivo Android alla tua macchina di sviluppo con un cavo USB. Sul dispositivo dovrebbe essere visualizzata una finestra di dialogo con la richiesta di consentire il debug USB.
   
   
   
2. Seleziona l'opzione Consenti sempre per memorizzare questo computer. Tocca OK.
3. Fai clic sul pulsante Esegui sulla barra degli strumenti di Android Studio sul computer. Viene visualizzata la finestra di dialogo Seleziona target di deployment con l'elenco di emulatori e dispositivi connessi disponibili. Dovresti vedere il tuo dispositivo fisico e gli emulatori.
   
   
   
4. Seleziona il tuo dispositivo e fai clic su OK. Android Studio installa l'app sul tuo dispositivo e la esegue.

Risoluzione dei problemi

Se Android Studio non riconosce il tuo dispositivo, procedi nel seguente modo:

1. Scollega e ricollega il cavo USB.
2. Riavvia Android Studio.

Se il computer ancora non lo trova o lo dichiara "non autorizzato", procedi nel seguente modo:

1. Scollega il cavo USB.
2. Sul dispositivo, apri Opzioni sviluppatore nell'app Impostazioni.
3. Tocca Revoca autorizzazioni di debug USB.
4. Ricollega il dispositivo al tuo computer.
5. Quando richiesto, concedi le autorizzazioni.

Potrebbe essere necessario installare il driver USB appropriato per il tuo dispositivo. Vedi Eseguire app su un dispositivo hardware.

Nota: tutte le verifiche tramite programmazione sono facoltative.

Sfida: ora che hai impostato e acquisito familiarità con il flusso di lavoro di sviluppo di base, procedi nel seguente modo:

1. Crea un nuovo progetto in Android Studio.
2. Cambia il nome di "Hello World" e auguri di "Buon compleanno a" e il nome di un compleanno.

• Per installare Android Studio, accedi ad Android Studio e segui le istruzioni per scaricarlo e installarlo.
• Per visualizzare la gerarchia Android di un'app nel riquadro Progetto, fai clic sulla scheda Progetto nella colonna della scheda verticale. A questo punto, seleziona Android nel menu a discesa in alto.
• Se devi aggiungere nuove dipendenze al progetto o modificare le versioni delle dipendenze, modifica il file build.gradle(Module:app).
• Tutto il codice e le risorse per un'app si trovano all'interno delle cartelle app e res. La cartella java include attività, test e altri componenti nel codice sorgente Kotlin o Java (o entrambi). La cartella res contiene risorse come layout, stringhe e immagini.
• Per aggiungere funzionalità, componenti e autorizzazioni alla tua app Android, modifica il file AndroidManifest.xml. Tutti i componenti delle app, come le attività aggiuntive, devono essere dichiarati in questo file XML.
• Per creare un dispositivo virtuale Android (un emulatore) per eseguire la tua app, utilizza AVD Manager.
• Per eseguire l'app su un dispositivo Android fisico tramite Android Studio, attiva il debug USB sul dispositivo. A tale scopo, apri Impostazioni > Informazioni sul telefono e tocca sette volte Numero build. Quindi, apri Impostazioni > Opzioni sviluppatore e seleziona Debug USB.

Corso Udacity:

• Sviluppo di app Android con Kotlin

Documentazione di Android Studio:

• Pagina di download per Android Studio
• Note di rilascio di Android Studio
• Android Studio
• Creare e gestire dispositivi virtuali
• Panoramica del file manifest dell'app
• Configura la build
• Creare e gestire dispositivi virtuali

Altro:

• Sito della release
• Pagina Wikipedia di Gradle

In questa sezione sono elencati i possibili compiti per gli studenti che lavorano attraverso questo codelab nell'ambito di un corso tenuto da un insegnante. Spetta all'insegnante fare quanto segue:

• Assegna i compiti, se necessario.
• Comunica agli studenti come inviare compiti.
• Valuta i compiti.

Gli insegnanti possono utilizzare i suggerimenti solo quanto e come vogliono e dovrebbero assegnare i compiti che ritengono appropriati.

Se stai lavorando da solo a questo codelab, puoi utilizzare questi compiti per mettere alla prova le tue conoscenze.

Creare ed eseguire un'app

• Crea un nuovo progetto Android dal modello vuoto.
• Apri il file res/strings.xml.
• Modifica il valore della stringa app_name in "My Dice Roller". Questo nome viene visualizzato nella barra del titolo.
• Crea un emulatore per un dispositivo, scegliendo come target qualsiasi versione di Android che ti piace ed esegui l'app. Nota come è cambiato il titolo dell'app.

Rispondi a queste domande

Domanda 1

Qual è il nome del file di layout per l'attività principale?

• MainActivity.java
• AndroidManifest.xml
• activity_main.xml
• build.gradle

Domanda 2

Qual è il nome della risorsa stringa che specifica il nome dell'app?

• app_name
• xmlns:app
• android:name
• applicationId

Domanda 3

Quale strumento utilizzi per creare un nuovo emulatore?

• Monitoraggio dispositivi Android
• Gestione AVD
• SDK Manager
• Editor di temi

Inviare l'app per valutare

Verifica che l'app contenga quanto segue:

• Activity che mostra "Hello World" sullo schermo.
• Una barra del titolo che dice "Il mio lancio di dadi"."

Inizia la lezione successiva: 1.2: Anatomia delle app di base

Per i link ad altri codelab in questo corso, consulta la pagina di destinazione di Android Kotlin Fundamentals.