Android Academy · Lezione

Struttura del progetto e manifest

Comprendere la struttura di un progetto Android, il ruolo di build.gradle e delle risorse e il file AndroidManifest.xml, che dichiara l'app al sistema operativo.

Struttura del progetto e manifest è una lezione Android Academy gratuita su CoddyKit. Questa è la lezione 1 di 7. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Android Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Android Academy include 7 lezioni in totale.

Il primo progetto Android

Quando crea un nuovo progetto Android in Android Studio, viene generata una struttura di cartelle specifica. Comprendere questa struttura è il primo passo per sviluppare app Android in modo produttivo.

Ogni app Android ha la stessa struttura di primo livello: esploriamola.

Struttura di primo livello

Un progetto Android ha due moduli principali:

app/ — il modulo dell'app (codice, risorse, manifest)
File Gradle — configurazione del sistema di build

All'interno di app/src/main/ trascorrerà la maggior parte del tempo:

java/ (o kotlin/) — i file sorgente Kotlin
res/ — layout, immagini, stringhe
AndroidManifest.xml — il file di configurazione dell'app

La directory res/

La cartella res/ contiene tutte le risorse non costituite da codice:

res/layout/ — layout XML delle schermate
res/drawable/ — immagini e icone
res/values/strings.xml — stringhe di testo
res/values/colors.xml — definizioni dei colori
res/mipmap/ — icone di avvio dell'app

Android genera una classe chiamata R per consentire di fare riferimento alle risorse nel codice.

AndroidManifest.xml

AndroidManifest.xml è il file di configurazione più importante. Indica ad Android:

Il nome del package dell'app (identificatore univoco)
Quali Activity esistono
Quale Activity è la schermata di avvio
Le autorizzazioni richieste dall'app (fotocamera, Internet ecc.)
I livelli API Android minimo e di destinazione

Struttura del manifest

Un AndroidManifest.xml minimale ha il seguente aspetto:

<!-- AndroidManifest.xml -->
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission
        android:name="android.permission.INTERNET" />

    <application
        android:label="@string/app_name"
        android:icon="@mipmap/ic_launcher">

        <activity android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <!-- This is the launch activity -->
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

    </application>
</manifest>

File build.gradle

Gradle è il sistema di build. Esistono due file build.gradle:

A livello di progetto — impostazioni globali, configurazione dei repository
A livello di app (app/build.gradle) — dipendenze dell'app, versioni dell'SDK, plugin

Qui aggiunge le librerie: implementation "com.google.code.gson:gson:2.10.1"

Campi principali di app/build.gradle

I campi più importanti in app/build.gradle sono:

compileSdk — l'API Android con cui compilare
minSdk — la versione Android meno recente supportata
targetSdk — la versione Android rispetto alla quale è stata testata l'app
versionCode — intero incrementato a ogni release
versionName — versione leggibile dall'utente (ad esempio "1.2.0")

La classe R

Android genera automaticamente una classe R che associa ogni risorsa a un ID intero:

R.layout.activity_main — il layout XML
R.id.tvTitle — una view all'interno di un layout
R.string.app_name — una risorsa stringa
R.drawable.ic_logo — un'immagine

È così che il codice Kotlin si collega alle risorse XML.

strings.xml per la localizzazione

Inserisca sempre il testo visibile all'utente in res/values/strings.xml invece di scriverlo direttamente nel codice. In questo modo abilita la localizzazione: Android seleziona automaticamente la stringa nella lingua corretta in base alle impostazioni locali del dispositivo.

Esempio: crei res/values-tr/strings.xml per le traduzioni in turco.

Verifica rapida

Dove si dichiara quale Activity viene mostrata quando l'app viene avviata per la prima volta?

Riepilogo: struttura del progetto

Ora comprende l'anatomia di un progetto Android:

app/src/main/kotlin/ — il codice
app/src/main/res/ — layout, immagini, stringhe
AndroidManifest.xml — autorizzazioni, Activity, configurazione di avvio
build.gradle — dipendenze e versioni dell'SDK
La classe R — collega il codice alle risorse

Prossimo argomento: il cuore di ogni schermata Android, ovvero le Activity e il loro ciclo di vita.

Domande Frequenti

La lezione «Struttura del progetto e manifest» è gratuita?

Sì — il testo completo di «Struttura del progetto e manifest» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Android Academy, passa a CoddyKit PRO. Il corso Android Academy include 7 lezioni in totale.

Cosa imparerò in «Struttura del progetto e manifest»?

Comprendere la struttura di un progetto Android, il ruolo di build.gradle e delle risorse e il file AndroidManifest.xml, che dichiara l'app al sistema operativo. Eserciti Android Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Android Academy?

Non è richiesta alcuna esperienza precedente. Android Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 7.

Quanto tempo richiede la lezione «Struttura del progetto e manifest»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Android Academy?

Sì. Ogni lezione Android Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Android Academy