Android Kotlin Fundamentals 01.4: scopri come aiutarti

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, scoprirai le risorse utili per gli sviluppatori Kotlin Android, inclusi i modelli, la documentazione, i video e le app di esempio.

Informazioni importanti

• Il flusso di lavoro di base di Android Studio.
• Come utilizzare l'Editor di layout in Android Studio.

Obiettivi didattici

• Dove trovare informazioni e risorse per gli sviluppatori Kotlin e Android.
• Come cambiare l'icona in Avvio app.
• Come cercare assistenza per la creazione di app Android con Kotlin.

In questo lab proverai a:

• Scopri alcune delle risorse disponibili per gli sviluppatori Android Kotlin di tutti i livelli.
• Scarica ed esplora un'app di esempio Android di Kotlin.
• Modifica l'icona in Avvio applicazioni di un'app.

In questo codelab, scopri i modelli, gli esempi, la documentazione e le altre risorse disponibili per gli sviluppatori Android di Kotlin.

Innanzitutto, crea un'app semplice da un modello di Android Studio e modificala, poi scarichi ed esplora l'app di esempio di Sunflower di Android. Sostituisci l'icona in Avvio applicazioni di esempio (un girasole) con un asset immagine clip art disponibile in Android Studio (una faccina sorridente).

Android Studio fornisce modelli per la progettazione di app e attività comuni e consigliate. I modelli integrati ti consentono di risparmiare tempo e ti aiutano a seguire le best practice di progettazione.

Ogni modello include un'attività degli scheletri e un'interfaccia utente. Hai già utilizzato il modello di attività vuota in questo corso. Il modello Attività di base offre più funzionalità e incorpora funzionalità consigliate per le app, come il menu Opzioni che viene visualizzato nella barra dell'app sui dispositivi Android.

Passaggio 1: esplora l'architettura dell'attività di base

1. Crea un progetto in Android Studio.
2. Nella finestra di dialogo Scegli il tuo progetto, seleziona il modello Attività di base e fai clic su Avanti.
3. Nella finestra di dialogo Configura il progetto, assegna all'app il nome che preferisci. Seleziona Kotlin per la lingua e seleziona la casella di controllo Use AndroidX artefatti (Utilizza artefatti AndroidX). Fai clic su Fine.
4. Crea l'app ed eseguila su un emulatore o un dispositivo Android.
5. Identifica le parti etichettate nella figura e nella tabella riportate di seguito. Trova gli equivalenti sul dispositivo o sull'emulatore. Esamina il codice Kotlin corrispondente e i file XML descritti nella tabella.

Conoscere il codice sorgente e i file XML di Kotlin ti aiuterà a estendere e personalizzare il modello di attività di base in base alle tue esigenze.

Architettura del modello Attività di base

#	Descrizione dell'interfaccia utente	Riferimento codice
1	Barra di stato, fornita e controllata dal sistema Android.	Non è visibile nel codice del modello, ma puoi accedere alla barra di stato delle attività. Ad esempio, puoi aggiungere codice in MainActivity.kt per nascondere la barra di stato, se necessario.
2	La barra dell'app, chiamata anche barra delle azioni, offre struttura visiva, elementi visivi standardizzati e navigazione.	In activity_main.xml, cerca Barra degli strumenti. all'interno dell'elemento AppBarLayout. Per garantire la compatibilità con le versioni precedenti, AppBarLayout nel modello incorpora un Toolbar che ha le stesse funzionalità di una ActionBar. Per cambiare l'aspetto della barra delle app, modifica gli attributi della barra degli strumenti. Per i tutorial sulla barra delle app, vedi Aggiungere la barra dell'app.
3	Il nome dell'app deriva inizialmente dal nome del pacchetto, ma puoi modificarlo come preferisci.	Cerca AndroidManifest.xml in android:label="@string/app_name". Specifica la stringa app_name in strings.xml.
4	Il pulsante di overflow del menu opzioni contiene le voci di menu dell'attività. Il pulsante di overflow contiene anche opzioni di menu globali come Ricerca e Impostazioni per l'app. Le voci del menu dell'app vengono aggiunte a questo menu.	Nel MainActivity.kt, Il metodo onOptionsItemSelected() implementa ciò che accade quando l'utente seleziona un elemento del menu. Per visualizzare le voci del menu opzioni, apri res/menu/menu_main.xml . In questo modello è specificata solo la voce di menu Settings (Impostazioni).
5	CoordinatorLayout ViewGroup è un layout che fornisce meccanismi per l'interazione degli elementi dell'interfaccia utente. L'interfaccia utente della tua app viene inserita nel file content_main.xml, che è incluso in questo ViewGroup.	Cerca l'istruzione include layout in activity_main.xml. In questo layout non sono specificate visualizzazioni; invece, il layout include il layout content_main, in cui sono specificate le viste dell'app. Le visualizzazioni di sistema vengono mantenute separate da quelle univoche della tua app.
6	Il modello utilizza una proprietà TextView per visualizzare "Hello World". Sostituisci questo TextView con gli elementi UI della tua app.	La visualizzazione di testo "Hello World" è nel file content_main.xml. In questo file devono essere definiti tutti gli elementi dell'interfaccia utente dell'app.
7	Pulsante di azione mobile (FAB)	In activity_main.xml, cerca l'elemento FloatingActionButton. Il FAB è definito come un elemento UI che utilizza un'icona di clip art. MainActivity.kt include un stub in onCreate() che imposta un listener onClick() per il FAB.

Passaggio 2: personalizza l'app prodotta dal modello

Modificare l'aspetto dell'app prodotta dal modello Attività di base. Ad esempio, puoi cambiare il colore della barra dell'app in modo che corrisponda a quella della barra di stato. Su alcuni dispositivi, la barra di stato è in un colore più scuro dello stesso colore principale utilizzato dalla barra dell'app.

1. Cambiare il nome dell'app visualizzata dalla barra dell'app. Per farlo, cambia la risorsa della stringa app_name nel file res > values > string.xml come segue:

<string name="app_name">New Application</string>

2. Cambia il colore della barra dell'app (Toolbar) nel file res > layout > activity_main.xml modificando l'attributo android:background in "?attr/colorPrimaryDark". Questo valore imposta il colore della barra dell'app su un colore principale più scuro che corrisponde a quello della barra di stato:

android:background="?attr/colorPrimaryDark"

3. Esegui l'app. Il nuovo nome dell'app viene visualizzato nella barra di stato e il colore di sfondo della barra è più scuro e corrisponde al colore della barra. Quando fai clic su FAB, nella barra degli screenshot viene visualizzato uno snackbar che viene mostrato come 1.
   
4. Modifica il testo dello snackbar. Per farlo, apri MainActivity e cerca il codice stub in onCreate() che imposta un listener onClick() per il pulsante. Cambia "Replace with your own action" in un altro. Ad esempio:

fab.setOnClickListener { view ->
   Snackbar.make(view, "This FAB needs an action!", Snackbar.LENGTH_LONG)
       .setAction("Action", null).show()
}

5. Il FAB utilizza il colore di contrasto dell'app, quindi un modo per cambiarlo è cambiare il colore di accento. Per cambiare il colore di contrasto, apri il file res > values >color.xml e modifica l'attributo colorAccent come mostrato di seguito. Per assistenza sulla scelta dei colori, consulta il sistema di colori Material Design.

<color name="colorAccent">#1DE9B6</color>

6. Esegui l'app. Il FAB utilizza il nuovo colore e il testo dello snackbar è cambiato.
   
   

Suggerimento: per informazioni dettagliate sulla sintassi XML per l'accesso alle risorse, consulta l'articolo Accedere alle risorse dell'app.

Passaggio 3: scopri come aggiungere attività usando i modelli

Per quanto riguarda i codelab di questo corso, finora hai utilizzato i modelli Attività vuota e Attività di base per avviare nuovi progetti. Puoi usare i modelli di attività anche quando crei attività dopo la creazione del progetto.

1. Crea un progetto per l'app o scegline uno esistente.
2. Nel riquadro Progetto ≫ Android, fai clic con il pulsante destro del mouse sulla cartella java.
3. Seleziona Nuova > attività > galleria.
4. Aggiungi un'attività all'app selezionando uno dei modelli di Activity. Ad esempio, seleziona Attività del riquadro di navigazione a scomparsa per aggiungere un Activity con un riquadro di navigazione a scomparsa.
5. Per visualizzare l'attività nell'editor di layout, fai doppio clic sul file di layout dell'attività (ad esempio activity_main2.xml). Utilizza la scheda Design e la scheda Testo per spostarti tra l'anteprima del layout dell'attività e il codice di layout.

I repository di Google Samples su GitHub forniscono esempi di codice Kotlin Android che puoi studiare, copiare e incorporare nei tuoi progetti.

Passaggio 1: scarica ed esegui un esempio di codice Android Kotlin

1. In un browser, vai a github.com/googlesamples.
2. Per Lingua, seleziona Kotlin.
3. Seleziona un'app di esempio Kotlin Android che è stata modificata di recente e scarica il codice del progetto dell'app. Per questo esempio, scarica il file ZIP dell'app android-sunflower, che illustra alcuni dei componenti di Android Jetpack.
4. In Android Studio, apri il progetto android-sunflower-master.
5. Accetta gli eventuali aggiornamenti consigliati da Android Studio, quindi esegui l'app su un emulatore o un dispositivo Android.
   

Nota: gli esempi contenuti nel repository di Google Esempi su GitHub sono intesi come punto di partenza per ulteriori sviluppi. Ti invitiamo a progettare e sviluppare le tue idee in questi campioni.

Passaggio 2: esplora un esempio di codice Kotlin Android

Ora che hai aperto l'app di esempio Android Sunflower in Android Studio, scopri di più sull'app ed esplora i relativi file di progetto.

1. Per informazioni sulla dimostrazione di un'app di esempio, visita il file README dell'app in GitHub. Per questo esempio, vedi LEGGERO di girasole Android.
2. In Android Studio, apri uno dei file delle attività di Kotlin nell'app, ad esempio GardenActivity.kt.
   
3. In GardenActivity.kt, trova un corso, un tipo o una procedura che non conosci e cercalo nella documentazione per gli sviluppatori Android. Ad esempio, per saperne di più sul metodo setContentView(), cerca su setContentView() su developers.android.com.

Passaggio 3: modifica l'icona in Avvio applicazioni

In questo passaggio, cambi l'icona in Avvio applicazioni per l'app Android Sunflower di esempio. Aggiungi un'immagine clip art e la utilizzi per sostituire l'icona attuale di Android Sunflower.

Icone di avvio

Ogni app creata con Android Studio inizia con un'icona in Avvio applicazioni predefinita che rappresenta l'app. A volte le icone in Avvio applicazioni sono chiamate icone di app o icone di prodotto.

Se pubblichi un'app su Google Play, l'icona in Avvio applicazioni viene visualizzata nella scheda dell'app e nei risultati di ricerca nel Google Play Store.

Dopo aver installato un'app su un dispositivo Android, l'icona in Avvio applicazioni dell'app viene visualizzata nella schermata Home del dispositivo e altrove sul dispositivo. Ad esempio, l'icona in Avvio applicazioni dell'app Sunflower di Android viene visualizzata nella finestra App di ricerca del dispositivo, come mostrato nello screenshot di seguito. L'icona in Avvio applicazioni predefinita, mostrata di seguito 2, viene utilizzata inizialmente per tutti i progetti di app creati in Android Studio.

Modificare l'icona in Avvio applicazioni

Il processo di modifica dell'icona in Avvio app ti introduce le funzionalità degli asset immagine di Android Studio.

In Android Studio, ecco come cambiare l'icona in Avvio applicazioni dell'app Sunflower di Android:

1. Nel riquadro Progetto, fai clic con il pulsante destro del mouse sulla cartella Res. Seleziona Nuovo > asset immagine. Viene visualizzata la finestra di dialogo Configura asset immagine.

2. Nel campo Tipo di icona seleziona Icone Avvio app (adattivo e precedente) se non è già selezionato. Fai clic sulla scheda Livello in primo piano.
3. Per Tipo di risorsa, seleziona Clip art, come mostrato nello screenshot di seguito.
   
   
4. Fai clic sull'icona del robot nel campo Clip Art, mostrato come 2 nello screenshot in alto. Viene visualizzata la finestra di dialogo Seleziona icona che mostra l'insieme di icone di Material Design.
5. Sfoglia la finestra di dialogo Seleziona icona o cerca un'icona in base al nome. Seleziona un'icona, ad esempio l'icona del mood per indicare un buon umore. Fai clic su OK.

6. Nella finestra di dialogo Configura asset immagine, fai clic sulla scheda Livello sfondo. In Tipo di risorsa, seleziona Colore. Fai clic sul chip di colore e seleziona un colore da utilizzare come livello di sfondo per l'icona.
7. Fai clic sulla scheda Precedente e rivedi le impostazioni predefinite. Conferma di voler generare le icone precedenti, rotonde e Google Play Store. Fai clic su Avanti.
8. Viene visualizzata la finestra di dialogo Conferma percorso icona, che mostra dove vengono aggiunti e sovrascritti i file delle icone. Fai clic su Fine.
9. Esegui l'app su un emulatore AVD o un dispositivo Android.

Android Studio aggiunge automaticamente le immagini di Avvio app alle directory mipmap per le diverse densità dello schermo. L'app Android Sunflower utilizza ora la nuova icona della clip art come icona di lancio.

Suggerimento: per informazioni sulla progettazione di icone di Avvio applicazioni efficaci, consulta la guida Icone dei prodotti di Material Design.

4. Esegui di nuovo l'app. Assicurati che la nuova icona in Avvio applicazioni venga visualizzata nella schermata App di ricerca.

Passaggio 1: esplora la documentazione ufficiale di Android

Esplora alcuni dei siti di documentazione Android più utili e impara a conoscere i componenti disponibili:

1. Vai alla pagina developer.android.com. Questa documentazione ufficiale per gli sviluppatori Android viene aggiornata da Google.
2. Vai alla pagina developer.android.com/design/. Questo sito fornisce le linee guida per progettare l'aspetto e le funzionalità delle app Android di alta qualità.
3. Vai a material.io, un sito su Material Design. Material Design è una filosofia di progettazione concettuale che definisce le modalità di visualizzazione e di funzionamento di tutte le app, non solo delle app Android, sui dispositivi mobili. Utilizza i link per scoprire di più su Material Design. Ad esempio, per avere informazioni sull'utilizzo del colore, fai clic sulla scheda Design e seleziona Colore.
4. Vai all'indirizzo developer.android.com/docs/ per trovare informazioni sull'API, documentazione di riferimento, tutorial, guide degli strumenti ed esempi di codice.
5. Visita la pagina developer.android.com/distribute/ per trovare informazioni sulla pubblicazione di un'app su Google Play. Google Play è il sistema di distribuzione digitale di Google per le app sviluppate con l'SDK Android. Utilizza Google Play Console per ampliare la tua base utenti e iniziare a guadagnare.

Passaggio 2: esplora i contenuti del team Android e della Ricerca Google

1. Esplora il canale YouTube per sviluppatori Android, un'ottima fonte di tutorial e suggerimenti.
2. Visita il blog ufficiale di Android in cui il team di Android pubblica notizie e suggerimenti.
3. Inserisci una domanda nella Ricerca Google e il motore di ricerca Google raccoglierà i risultati pertinenti da varie risorse. Ad esempio, utilizza la Ricerca Google per fare la domanda "Qual è la versione più usata del sistema operativo Android in India?" Puoi anche inserire messaggi di errore nella Ricerca Google.

Passaggio 3: esegui ricerche su Stack Overflow

Stack Overflow è una community di programmatori che si aiutano a vicenda. Se riscontri un problema, è probabile che qualcuno abbia già pubblicato una risposta.

1. Vai a Stack Overflow.
2. Nella casella di ricerca, inserisci una domanda del tipo "Come si configura e utilizzo ADB tramite Wi-Fi?&quot". Puoi cercare su Stack Overflow senza registrarti, ma se vuoi pubblicare una nuova domanda o rispondere a una domanda, devi registrarti.
3. Nella casella di ricerca, inserisci [android]. Le parentesi [] indicano che vuoi cercare i post contrassegnati come Android.
4. Puoi combinare tag e termini di ricerca per rendere la ricerca più specifica. Prova queste ricerche:

• [android] and [layout]
• [android] "hello world"

Suggerimento: per scoprire di più sui tanti modi in cui puoi eseguire ricerche su Stack Overflow, visita il Centro assistenza Stack Overflow.

Passaggio 4: utilizza l'SDK Manager per installare la documentazione offline

Quando installi Android Studio, vengono installati anche i componenti essenziali dell'SDK Android. Per installare altre librerie e documentazione disponibili, utilizza SDK Manager.

Per esplorare SDK Manager e scaricare la documentazione relativa all'SDK, segui questi passaggi:

1. In Android Studio, seleziona Strumenti > SDK Manager. Si apre SDK Manager.
2. Nella colonna a sinistra di SDK Manager, seleziona Android SDK (1 nello screenshot di seguito).
3. Nota il percorso nel campo Posizione SDK Android (2 nello screenshot di seguito). Potrai utilizzare questo percorso in un secondo momento per trovare ciò che installi.
   
4. In SDK Manager, fai clic sulla scheda Piattaforme SDK. Da qui puoi installare altre versioni del sistema Android.
5. Fai clic sulla scheda Strumenti SDK. Da qui puoi installare strumenti per sviluppatori SDK che non sono installati per impostazione predefinita. Puoi anche installare una versione offline della documentazione per gli sviluppatori Android.
6. Fai clic sulla scheda Siti di aggiornamento SDK. Android Studio controlla regolarmente la presenza di aggiornamenti nei siti elencati e selezionati.
7. Torna alla scheda Strumenti SDK e seleziona la casella di controllo Documentazione per SDK Android, se non è già selezionata. Fai clic su Applica.
   
   Si apre una finestra di dialogo di conferma che mostra la quantità di spazio su disco richiesta dal download. Fai clic su OK.
8. Al termine dell'installazione, fai clic su Fine.

Per trovare la documentazione installata, segui questi passaggi:

1. Sul computer, vai alla directory Android/sdk/. Per trovare il percorso della directory, vedi il campo Android SDK Location (Posizione dell'SDK Android), mostrato come 2 nello screenshot in alto.
2. Apri la directory docs/.
3. Individua il file index.html e aprilo in un browser.

• La documentazione ufficiale per gli sviluppatori Android è disponibile all'indirizzo developer.android.com.
• Material Design è una filosofia di progettazione concettuale che definisce l'aspetto e il funzionamento delle app sui dispositivi mobili. Material Design non è solo per le app Android. Le linee guida su Material Design sono disponibili all'indirizzo material.io.
• Android Studio fornisce modelli per la progettazione di app e attività comuni e consigliate. Questi modelli offrono un codice di lavoro per i casi d'uso comuni.
• Quando crei un progetto, puoi scegliere un modello per la tua prima attività.
• Durante lo sviluppo dell'app, puoi creare attività e altri componenti da modelli integrati.
• Gli esempi di Google contengono campioni di codice che puoi studiare, copiare e incorporare nei tuoi progetti.

Corso Udacity:

• Sviluppo di app Android con Kotlin

Documentazione di Android Studio:

• Android Studio
• Nozioni di base sul flusso di lavoro degli sviluppatori

Documentazione per gli sviluppatori Android:

• Sito per sviluppatori Android
• Sito di formazione Google Developers
• Layout
• Panoramica delle risorse dell'app
• Menu
• TextView
• Risorse delle stringhe
• Panoramica del file manifest dell'app

Esempi di codice:

• Codice sorgente per i corsi di formazione di Google Developers su GitHub
• Campioni di Google
• Esempi di codice Android per gli sviluppatori

Video:

• Canale YouTube di Android Developers
• Corsi online Udacity

Altre risorse:

• Blog ufficiale di Android
• Blog per sviluppatori Android
• Codelab di Google Developers
• Overflow dello stack
• Glossario del vocabolario Android

Inizia la lezione successiva: 2.1: Layout lineare utilizzando l'editor di layout

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