Android Kotlin Fundamentals 01.1: Get started

Questo codelab fa parte del corso Android Kotlin Fundamentals. Per ottenere il massimo valore da questo corso, ti consigliamo di seguire le codelab in sequenza. Tutti i codelab del corso sono elencati nella pagina di destinazione dei codelab Android Kotlin Fundamentals.

Introduzione

In questo codelab crei ed esegui la tua prima app per Android, HelloWorld, su un emulatore e su un dispositivo fisico. Esplorerai anche l'aspetto di un progetto Android.

Cosa devi già sapere

• Devi comprendere il processo generale di sviluppo software per 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 per 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 per Android su un emulatore o un dispositivo fisico.

Cosa farai

• Crea un nuovo progetto Android e un'app predefinita chiamata HelloWorld.
• Crea un emulatore (un dispositivo virtuale) per poter eseguire l'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 l'aspetto dell'app:

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

1. Apri Android Studio se non è già aperto.
2. Nella finestra di dialogo principale 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.
   
   
   
   Un'Activity è un'azione singola e mirata che l'utente può eseguire. Ogni app deve avere almeno un'attività come punto di ingresso. Considera questa attività di punto di ingresso come la funzione main() in altri programmi. Un'attività in genere ha un layout associato che definisce l'aspetto degli elementi dell'interfaccia utente (UI) su uno schermo. Android Studio fornisce diversi Activity modelli per aiutarti a iniziare.
   
4. Nella finestra di dialogo Configura il progetto, inserisci "HelloWorld" per il nome.
   
   
5. Accetta il valore predefinito android.example.com per Dominio azienda o crea un dominio azienda univoco. Questo valore più il nome dell'app costituiscono il nome del pacchetto dell'app. Se non prevedi di pubblicare l'app, accetta il valore predefinito. Puoi modificare il nome del pacchetto della tua app in un secondo momento, ma è un lavoro extra.
6. Verifica che la posizione di salvataggio predefinita sia quella in cui vuoi archiviare l'app. In caso contrario, modificala nella directory che preferisci.
7. Assicurati che la lingua sia Kotlin.
8. Assicurati che il livello API minimo sia API 19: Android 4.4 (KitKat). Al momento della stesura di questo codelab, Android Studio indicava che con questo livello API l'app sarebbe stata eseguita su circa il 95, 3% dei dispositivi.
   (Scopri di più sui livelli API minimi in un codelab successivo. Per saperne di più, fai clic su Aiutami a scegliere, che apre una finestra con informazioni sui livelli API.)
   
9. Seleziona la casella di controllo Utilizza 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, il che potrebbe richiedere un po' di tempo. Segui le istruzioni e accetta le opzioni predefinite.

Android Studio ora crea il progetto, il che può richiedere un po' di tempo. Non dovresti ricevere errori. Se ricevi avvisi, ignorali.

In questa attività esplorerai il progetto HelloWorld in Android Studio e imparerai le nozioni di base dello 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 delle schede verticali sul lato sinistro della finestra di Android Studio. Si apre il riquadro Progetto.
   
   
   
2. Per visualizzare il progetto come una gerarchia di progetti Android standard, seleziona Android dal menu a discesa nella parte superiore del riquadro Progetto. Android è il valore predefinito. Puoi visualizzare i file di progetto in molti modi diversi, ad esempio visualizzandoli come appaiono nella gerarchia del file system. Tuttavia, è più facile lavorare al progetto utilizzando la visualizzazione Android.
   
   

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

Passaggio 2: esplora la cartella dell'app

Tutto il codice e le risorse della tua app si trovano nella cartella app.

1. Nel riquadro Progetto > Android, espandi la cartella app. All'interno della cartella app si trovano 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 per Android. Esistono motivi storici per cui il codice Kotlin viene visualizzato nella cartella java. Questa convenzione consente a Kotlin di interagire senza problemi con il codice scritto nel linguaggio di programmazione Java, anche nello stesso progetto e nella stessa app.
   
   I file di classe della tua app sono contenuti in tre sottocartelle, come mostrato nella figura sopra. La cartella com.example.hello.helloworld (o il nome di dominio che hai specificato) contiene tutti i file per un pacchetto app. In particolare, la classe MainActivity è il punto di ingresso 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, ad esempio i test delle unità.

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

3. Prendi nota della cartella generatedJava. Questa cartella contiene i file generati da Android Studio durante la creazione dell'app. Non modificare nulla in questa cartella, perché le modifiche potrebbero essere sovrascritte quando ricompili l'app. Tuttavia, è utile conoscere questa cartella quando devi esaminare questi file durante il debug.

Passaggio 3: esplora la cartella res

1. Nel riquadro Progetto > Android, espandi la cartella res.
   
   La cartella res contiene le 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 come colori esadecimali o dimensioni standard.
   
   Le app per Android separano il codice Kotlin e le risorse il più possibile. In questo modo è molto più facile trovare tutte le stringhe o le icone utilizzate nell'interfaccia utente dell'app. Inoltre, quando modifichi uno di questi file di risorse, la modifica viene applicata ovunque il file venga utilizzato nell'app.
2. All'interno della cartella res, espandi la cartella layout per visualizzare il file activity_main.xml.
   
   
   

Il tuo Activity è in genere associato a un file di layout dell'interfaccia utente, definito come file XML nella directory res/layout. Il file di layout in genere prende il nome dall'attività. In questo caso, il nome dell'attività è MainActivity, quindi il layout associato è activity_main.

Passaggio 4: esplora la cartella dei manifest e AndroidManifest.xml

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

1. Espandi la cartella manifests e fai doppio clic su AndroidManifest.xml per aprirlo. Il file AndroidManifest.xml include i dettagli necessari al sistema Android per eseguire l'app, incluse le attività che fanno parte dell'app.
   
   
   
2. Tieni presente che viene fatto riferimento a MainActivity nell'elemento <activity>. Qualsiasi Activity nella tua app deve essere dichiarata nel 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. Nota 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 di avvio. Scopri di più sui filtri per intent in un codelab successivo.

Il file AndroidManifest.xml è anche il luogo in cui definire le autorizzazioni necessarie per la tua app. Le autorizzazioni includono la possibilità per l'app di leggere i contatti dello smartphone, inviare dati su internet o accedere a hardware come la fotocamera del dispositivo.

Gradle è un sistema di automazione della build che utilizza un linguaggio specifico del dominio per descrivere la struttura, la configurazione e le dipendenze del progetto dell'app. Quando compili ed esegui l'app, vengono visualizzate informazioni sull'esecuzione della build Gradle. Vengono visualizzate anche informazioni sul pacchetto Android (APK) in fase di installazione. (APK è il formato del file del pacchetto che il sistema operativo Android utilizza per distribuire e installare app mobile.)

Esplora il sistema Gradle:

1. Espandi la cartella Gradle Scripts. Nel riquadro Progetto > Android, questa cartella contiene tutti i file necessari al 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 progetto. Ogni progetto Android Studio contiene un unico 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(Module:app).
   
   Oltre al file build.gradle a livello di progetto, ogni modulo ha un proprio file build.gradle. Il file build.gradle a livello di modulo consente di configurare le impostazioni di build per ogni modulo. L'app HelloWorld ha un solo modulo, quello dell'app stessa. Questo file build.gradle è quello che modifichi più spesso quando cambi 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 gli argomenti in un codelab successivo.

In questa attività, utilizzerai Gestione AVD (Android Virtual Device) per creare un dispositivo virtuale (un emulatore). Il dispositivo virtuale simula la configurazione per un particolare tipo di dispositivo Android. Quindi, utilizzi il dispositivo virtuale per eseguire l'app.

Android Emulator è un'applicazione indipendente e ha requisiti di sistema propri. I dispositivi virtuali possono utilizzare molto spazio su disco. Se riscontri problemi, consulta 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 > AVD Manager oppure fai clic sull'icona AVD Manager 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 illustrato nella figura seguente). In caso contrario, visualizzerai 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 diagonali del display (Dimensioni), la risoluzione dello schermo in pixel (Risoluzione) e la densità di pixel (Densità).
   
   
3. Seleziona un dispositivo come Nexus 5x o Pixel XL e fai clic su Avanti. Viene visualizzata la finestra di dialogo Immagine di sistema .
4. Fai clic sulla scheda Consigliato 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 Consigliati. Per visualizzarli, guarda le schede Immagini x86 e Altre immagini.

Queste immagini occupano molto spazio su disco, quindi solo alcune fanno parte dell'installazione originale. Se accanto a un'immagine di sistema che vuoi utilizzare è visibile un link Download, 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. Si apre la finestra di dialogo Android Virtual Device (AVD). Controlla la configurazione e fai clic su Fine.

Passaggio 2: esegui l'app sul dispositivo virtuale

In questa attività, esegui finalmente la nuova app.

1. In Android Studio, seleziona Esegui > Esegui app o fai clic sull'icona Esegui Esegui app o fai clic sull'icona Esegui [ICON HERE] nella barra degli strumenti. [IMAGEINFO]: ic_run.png, Android Studio Run icon" style="width: 24.00px" src="img/6c65750f2ce7f651.png"> nella barra degli strumenti. Viene visualizzata la finestra di dialogo Seleziona destinazione di deployment, che ti avvisa che non sono disponibili dispositivi. Visualizzi questo avviso se non hai un dispositivo fisico connesso al computer di sviluppo o se non hai ancora avviato un dispositivo virtuale.
2. Nella finestra di dialogo Seleziona destinazione di deployment, seleziona il dispositivo virtuale che hai creato nella sezione Dispositivi virtuali disponibili. Fai clic su Ok.
   
   
   
   L'emulatore si avvia e si avvia proprio come un dispositivo fisico. A seconda della velocità del computer, questa procedura potrebbe richiedere un po' di tempo. Le build dell'app vengono create e, quando l'emulatore è pronto, Android Studio carica l'APK dell'app nell'emulatore e lo esegue.
   
   Dovresti vedere l'app HelloWorld come mostrato nella figura seguente.
   
   

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

Quello che ti serve:

• Un dispositivo Android, ad esempio uno smartphone o un tablet.
• Un cavo dati USB per collegare il dispositivo Android al computer tramite la porta USB.
• Se utilizzi un sistema Linux o Windows, potresti dover eseguire passaggi aggiuntivi. Consulta la documentazione Eseguire app su un dispositivo hardware. Potresti anche dover installare il driver USB appropriato per il tuo dispositivo. Per i driver USB basati su Windows, vedi Installare i 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 delle Opzioni sviluppatore del dispositivo.

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

1. Sul tuo dispositivo, apri Impostazioni, cerca Informazioni sullo smartphone, tocca Informazioni sullo smartphone e tocca Numero build sette volte.
2. Torna alla pagina precedente (Impostazioni / Sistema). Opzioni sviluppatore viene visualizzata nell'elenco. Tocca Opzioni sviluppatore.
3. Seleziona Debug USB.

Passaggio 2: esegui l'app sul dispositivo Android

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

1. Collega il dispositivo Android alla macchina di sviluppo con un cavo USB. Sul dispositivo dovrebbe essere visualizzata una finestra di dialogo che chiede di consentire il debug USB.
   
   
   
2. Seleziona l'opzione Consenti sempre per memorizzare questo computer. Tocca Ok.
3. Sul computer, nella barra degli strumenti di Android Studio, fai clic sul pulsante Esegui . Si apre la finestra di dialogo Seleziona destinazione di deployment con l'elenco degli emulatori disponibili e dei dispositivi connessi. Dovresti vedere il tuo dispositivo fisico insieme a tutti 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, prova a eseguire le seguenti operazioni:

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

Se il computer continua a non trovare il dispositivo o lo dichiara "non autorizzato", segui questi passaggi:

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

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

Nota:tutte le sfide di programmazione sono facoltative.

Sfida: ora che hai completato la configurazione e hai familiarità con il flusso di lavoro di sviluppo di base, fai quanto segue:

1. Crea un nuovo progetto in Android Studio.
2. Cambia il saluto "Hello World" in "Happy Birthday to " e il nome di una persona che ha festeggiato il compleanno di recente.

• Per installare Android Studio, vai alla pagina 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 delle schede verticali. Poi seleziona Android nel menu a discesa in alto.
• Quando devi aggiungere nuove dipendenze al tuo progetto o modificare le versioni delle dipendenze, modifica il file build.gradle(Module:app).
• Tutto il codice e le risorse di un'app si trovano nelle 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 per Android, modifica il file AndroidManifest.xml. Tutti i componenti dell'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 Gestione AVD.
• Per eseguire l'app su un dispositivo Android fisico utilizzando Android Studio, attiva il debug USB sul dispositivo. Per farlo, apri Impostazioni > Informazioni sullo smartphone e tocca Numero build sette volte. Poi apri Impostazioni > Opzioni sviluppatore e seleziona Debug USB.

Corso Udacity:

• Sviluppo di app per Android con Kotlin

Documentazione di Android Studio:

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

Altro:

• Sito Gradle
• Pagina di Wikipedia su Gradle

Questa sezione elenca i possibili compiti a casa per gli studenti che seguono questo codelab nell'ambito di un corso guidato da un insegnante. Spetta all'insegnante:

• Assegna i compiti, se richiesto.
• Comunica agli studenti come inviare i compiti.
• Valuta i compiti a casa.

Gli insegnanti possono utilizzare questi suggerimenti nella misura che ritengono opportuna e sono liberi di assegnare qualsiasi altro compito a casa che ritengono appropriato.

Se stai seguendo questo codelab in autonomia, sentiti libero di utilizzare questi compiti per casa 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, scegli come target la versione di Android che preferisci 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?

• Android Device Monitor
• Gestione AVD
• SDK Manager
• Editor di temi

Inviare l'app per la classificazione

Verifica che l'app disponga di quanto segue:

• Un Activity che mostra "Hello World" sullo schermo.
• Una barra del titolo con la scritta "Il mio lanciatore di dadi".

Inizia la lezione successiva: 1.2: Anatomia di base di un'app

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