Rilascio di funzionalità Android Studio Narwhal 3 | 2025.1.3

Android Studio è l'IDE ufficiale per lo sviluppo per Android e include tutto il necessario per creare app per Android.

Questa pagina elenca le nuove funzionalità e i miglioramenti dell'ultima versione nel canale stabile, il rilascio di funzionalità di Android Studio Narwhal 3. Puoi scaricarlo qui o aggiornarlo in Android Studio facendo clic su Guida > Controlla aggiornamenti (Android Studio > Controlla aggiornamenti su macOS)

Questa è una release stabile di Android Studio. Tieni presente che le patch potrebbero contenere nuove funzionalità secondarie e correzioni di bug. Consulta Nomi delle release di Android Studio per comprendere la denominazione delle versioni di Android Studio.

Per vedere quali problemi sono stati risolti in questa versione di Android Studio, consulta l'elenco dei problemi risolti.

Per visualizzare le note di rilascio delle versioni precedenti di Android Studio, consulta Versioni precedenti.

Per accedere in anteprima alle funzionalità e ai miglioramenti in arrivo, consulta le versioni di anteprima di Android Studio.

Se riscontri problemi in Android Studio, consulta la pagina Problemi noti o Risoluzione dei problemi.

Compatibilità del plug-in Android per Gradle e di Android Studio

Il sistema di compilazione di Android Studio si basa su Gradle e il plug-in Android per Gradle (AGP) aggiunge diverse funzionalità specifiche per la creazione di app per Android. La tabella seguente elenca la versione di AGP richiesta per ogni versione di Android Studio.

Versione di Android Studio	Versione AGP richiesta
Rilascio di funzionalità Narvalo 3 | 2025.1.3	4,0-8,13
Rilascio di funzionalità Narvalo | 2025.1.2	4,0-8,12
Narvalo | 2025.1.1	3,2-8,11
Rilascio di funzionalità Meerkat | 2024.3.2	3,2-8,10
Meerkat | 2024.3.1	3,2-8,9
Rilascio di funzionalità Ladybug | 2024.2.2	3,2-8,8
Ladybug | 2024.2.1	3,2-8,7
Rilascio di funzionalità Koala | 2024.1.2	3,2-8,6
Koala | 2024.1.1	3,2-8,5
Jellyfish | 2023.3.1	3,2-8,4
Iguana | 2023.2.1	3,2-8,3
Riccio | 2023.1.1	3,2-8,2
Giraffa | 1° marzo 2022	3,2-8,1
Flamingo | 2022.2.1	3,2-8,0

Per informazioni sulle novità del plug-in Android per Gradle, consulta le note di rilascio del plug-in Android per Gradle.

Versioni minime degli strumenti per il livello API Android

Esistono versioni minime di Android Studio e AGP che supportano un livello API specifico. L'utilizzo di versioni precedenti di Android Studio o AGP rispetto a quelle richieste da targetSdk o compileSdk del progetto potrebbe causare problemi imprevisti. Ti consigliamo di utilizzare l'ultima versione di anteprima di Android Studio e AGP per lavorare su progetti che hanno come target le versioni di anteprima del sistema operativo Android. Puoi installare le versioni di anteprima di Android Studio insieme a una versione stabile.

Le versioni minime di Android Studio e AGP sono le seguenti:

Livello API	Versione minima di Android Studio	Versione minima di AGP
36,0	Suricato | 2024.3.1 Patch 1	8.9.1
35	Rilascio di funzionalità Koala | 2024.2.1	8.6.0
34	Riccio | 2023.1.1	8.1.1
33	Flamingo | 2022.2.1	7.2

Compatibilità di Android Studio e dei servizi cloud

Android Studio include integrazioni di servizi che aiutano te e il tuo team a fare progressi più rapidi durante lo sviluppo, il rilascio e la manutenzione delle app per Android. Ciò include i servizi cloud come Gemini in Android Studio, Play Vitals e Firebase Crashlytics. I servizi cloud sono disponibili solo nell'ultima versione del canale stabile di Android Studio, nelle tre versioni principali precedenti più recenti e nelle patch associate a queste versioni. Quando una versione non rientra in questo intervallo di compatibilità, le integrazioni dei servizi vengono disattivate e devi aggiornare Android Studio.

Versioni di Android Studio attualmente compatibili con i servizi cloud

A partire dal rilascio del canale stabile di Android Studio Meerkat Feature Drop, tutte le versioni di Studio sono compatibili con i servizi cloud. L'applicazione inizierà con il rilascio di funzionalità di Android Studio Narwhal.

Studio Labs

Studio Labs ti consente di provare le ultime funzionalità sperimentali di AI in una versione stabile di Android Studio, in modo da poter integrare più rapidamente le nostre offerte di assistenza AI nel tuo flusso di lavoro di sviluppo. Per ulteriori informazioni, vedi Studio Labs.

Di seguito sono riportate le funzionalità attualmente disponibili in Studio Labs.

Funzionalità	Descrizione	Documenti
Crea generazione di anteprima	Gemini può generare automaticamente anteprime di Compose, inclusi dati simulati per i parametri di anteprima, per un composable specifico o per tutti i composable in un file.	Generare anteprime di Composizione
UI di trasformazione	Utilizza il linguaggio naturale per aggiornare l'interfaccia utente dell'app direttamente dal riquadro di anteprima di Compose.	UI di trasformazione

Di seguito sono riportate le nuove funzionalità del Feature Drop di Android Studio Narwhal 3.

Anteprime di Compose ridimensionabili

L'anteprima di Compose ora supporta il ridimensionamento dinamico per fornirti un feedback visivo immediato su come la tua UI si adatta a schermi di dimensioni diverse.

Per utilizzare la funzionalità, attiva la modalità Focus nell'anteprima di composizione modificando l'opzione di visualizzazione sulla barra degli strumenti:

Ora puoi ridimensionare la finestra di anteprima trascinandone i bordi:

In alternativa, puoi utilizzare la barra degli strumenti di ridimensionamento, che viene visualizzata dopo il ridimensionamento dell'anteprima:

Se vuoi salvare la nuova dimensione come nuova annotazione Preview, utilizza il menu di scelta rapida:

La funzionalità di ridimensionamento dinamico ti aiuta a creare UI che hanno un aspetto ottimale su schermi di qualsiasi dimensione.

Impostazione della visualizzazione Android per mostrare i file di build nei moduli corrispondenti

È presente una nuova impostazione per visualizzare i file di build nel modulo corrispondente nella visualizzazione Android. Questa visualizzazione può essere utile quando lavori a progetti con molti moduli. Per attivare la visualizzazione, apri il menu Opzioni disponibile accanto alla visualizzazione Android. Poi seleziona Aspetto > Visualizza file di build nel modulo.

Approfondimenti sulle norme di Google Play in Android Studio

Android Studio ora include approfondimenti e indicazioni più dettagliati sulle norme di Google Play che potrebbero influire sulla tua app. Queste informazioni ti aiutano a creare app più sicure fin dall'inizio, evitando problemi che potrebbero interrompere la procedura di lancio e richiedere più tempo e risorse per la risoluzione in un secondo momento.

A partire da Android Studio Narwhal 3 Feature Drop, puoi visualizzare gli approfondimenti sulle norme di Play come controlli lint. Questi controlli lint presentano le seguenti informazioni:

• Una panoramica delle norme.
• Cose da fare e da non fare per evitare gli errori più comuni.
• Link alle pagine delle norme di Google Play, dove puoi trovare le norme formali complete e ulteriori informazioni e risorse utili.

Questa funzionalità ha lo scopo di fornire indicazioni utili prima della revisione, in modo da semplificare l'invio delle app. Non copre tutte le norme e non fornisce decisioni definitive relative alle revisioni delle app. Consulta sempre la versione integrale delle norme nel Centro norme per ricevere indicazioni. Stiamo inoltre sviluppando e migliorando attivamente questa integrazione. Se hai feedback, segnalalo.

Per verificare se sono presenti approfondimenti sulle norme di Play per il tuo progetto, vai a Codice > Ispeziona per approfondimenti sulle norme di Play… Gli approfondimenti verranno elencati nella finestra degli strumenti "Problemi" e verranno visualizzati anche come avvisi Lint nei file corrispondenti.

Testare e sviluppare con il backup e il ripristino delle app

Assicurarsi che il backup e il ripristino di Android funzioni correttamente per la tua app è un aspetto fondamentale per garantire che gli utenti continuino a interagire con la tua app dopo il passaggio a un nuovo dispositivo o il ripristino dal cloud. Tuttavia, testare se il backup e il ripristino dei dati funzionano per la tua app può essere difficile.

Il rilascio di funzionalità di Android Studio Narwhal 3 offre modi per generare un backup per la tua app e ripristinarlo su un altro dispositivo. Può essere utile per verificare se la tua app si comporta come previsto durante il ripristino dei dati dell'app da dispositivo a dispositivo o da un backup sul cloud oppure se vuoi un modo più rapido per configurare un dispositivo di test con i dati necessari per sviluppare ed eseguire il debug dell'app.

Genera un backup

Per generare un file di backup:

1. Eseguire il deployment di una versione di debug dell'app su un dispositivo connesso
2. Utilizza una delle seguenti azioni per generare un backup:
   • Nella finestra Running Device, fai clic sull'azione Backup App Data dalla barra degli strumenti.
   • Seleziona Esegui > Backup dati app dalla barra dei menu principale.
   • Nella scheda Esplora dispositivi > Processi, fai clic con il tasto destro del mouse sul processo dell'app e seleziona Backup dati app.
3. Nella finestra di dialogo visualizzata, procedi nel seguente modo:
   • Conferma l'ID applicazione dell'app per cui vuoi generare un backup
     • Seleziona se vuoi generare un backup Da dispositivo a dispositivo, Cloud o Cloud (non criptato).
   • Conferma il nome e la posizione del backup che vuoi salvare. Per impostazione predefinita, il backup viene salvato nella directory principale del progetto Android Studio corrente.

     

4. Fai clic su Ok quando Android Studio ti chiede se può arrestare l'app. Per generare il backup, Android Studio deve arrestare il processo dell'app.

Puoi visualizzare i backup che generi nella finestra dello strumento Project > Android sotto il nodo Backup Files.

Tipi di backup

Puoi generare diversi tipi di backup per la tua app. Quando generi un backup, seleziona il tipo di backup relativo allo scenario che vuoi testare:

• Da dispositivo a dispositivo:genera un backup dell'app, simile a quello creato durante il trasferimento da dispositivo a dispositivo. Nei trasferimenti da dispositivo a dispositivo, i dati di backup dell'app vengono inviati direttamente a un altro dispositivo, ad esempio tramite USB o Wi-Fi.
• Cloud:genera un backup dell'app, simile a quello salvato nello spazio di archiviazione dell'Account Google dell'utente. Quando un utente configura un nuovo dispositivo, può scegliere di eseguire il ripristino da un backup sul cloud.
• Cloud (non criptato): genera un backup dell'app, simile a quello salvato nello spazio di archiviazione dell'Account Google dell'utente su un dispositivo su cui non è attivata la crittografia lato client.

Nota: quando utilizzi la funzionalità per testare Cloud, Cloud (non criptato) o Backup da dispositivo a dispositivo, il backup generato non viene inviato a Cloud o a un altro dispositivo, a differenza del flusso di backup effettivo. Genera il backup dell'app come se dovesse essere salvato sul cloud o inviato a un altro dispositivo. I backup generati per qualsiasi tipo di backup possono essere visualizzati in File di backup nella finestra degli strumenti Progetto > Android.

Ripristinare i dati delle app

Per ripristinare i dati delle app:

1. Esegui il deployment dell'app sul dispositivo connesso. L'app deve avere lo stesso ID applicazione del file di backup che vuoi ripristinare sul dispositivo.
2. Vai a una delle seguenti azioni e fai clic:
   • Nella finestra Dispositivo in esecuzione, fai clic sull'azione Ripristina dati app dalla barra degli strumenti e seleziona un file di backup dalla cronologia recente o fai clic su Sfoglia.
   • Vai a Esegui > Ripristina dati app dalla barra dei menu principale.
   • Nella scheda Esplora dispositivi > Processi, fai clic con il tasto destro del mouse sul processo dell'app e seleziona Ripristina dati app.
   • Nella finestra degli strumenti Progetto > Android, fai clic con il tasto destro del mouse su un backup nel nodo File di backup e seleziona Ripristina dati app.
3. Se applicabile, seleziona un backup dalla cronologia recente o fai clic su Sfoglia per selezionare un file di backup da ripristinare dallo spazio di archiviazione locale.

In alternativa, puoi includere un file di backup come parte di una configurazione di esecuzione, in modo che il deployment dell'app ripristini anche i dati dell'app da un file di backup. Per farlo, segui questi passaggi:

1. Vai a Esegui > Modifica configurazioni dalla barra dei menu principale.
2. Seleziona una configurazione di esecuzione dell'app e vai a Opzioni di ripristino.

   

3. Per ripristinare un'app da un backup, seleziona la casella accanto a Ripristina stato app.
4. Seleziona un file di backup dalla cronologia recente oppure sfoglia e seleziona il file di backup dallo spazio di archiviazione locale.
5. Se vuoi ripristinare i dati dell'app solo su una nuova installazione dell'app, seleziona la casella accanto a Ripristina solo su nuova installazione apk. Questa opzione può essere utile se esegui il deployment su un nuovo dispositivo di test e vuoi ripristinare i dati per facilitare il debug e lo sviluppo di app.
6. Fai clic su Ok per salvare la configurazione di esecuzione.
7. Esegui il deployment dell'app utilizzando la configurazione di esecuzione per testare il ripristino dei dati dell'app su un dispositivo connesso.

Ispezioni Proguard

Android Studio ora include ispezioni per evitare regole Proguard realizzate in modo errato o regole che impediscono le ottimizzazioni R8. Regole di conservazione eccessivamente ampie, ad esempio -keep class **.* e configurazioni delle regole Proguard per i consumatori, ad esempio dontshrink e -dontoptimize, ora attivano un avviso nell'IDE Studio. Per creare una buona regola di conservazione che consenta la riduzione del codice, limita l'ambito della regola a un pacchetto specifico e specifica in modo esplicito cosa vuoi conservare.

File AGENT.md per il contesto a livello di progetto

Ora puoi includere file AGENT.md nel tuo progetto. Si tratta di file Markdown che forniscono istruzioni specifiche per il progetto, regole di stile di codifica e altre indicazioni a Gemini come contesto.

Gemini rileva e applica automaticamente le istruzioni di qualsiasi file denominato AGENT.md nel tuo progetto. Se non è presente un file AGENT.md, Gemini cerca invece un file GEMINI.md come fallback.

Nuova impostazione per disattivare la sincronizzazione automatica

Android Studio ora offre un'impostazione per passare dalla modalità di sincronizzazione automatica predefinita (ad es. la sincronizzazione viene eseguita automaticamente quando viene aperto un progetto) a una nuova modalità di sincronizzazione manuale con promemoria. Il comportamento predefinito è ancora la sincronizzazione automatica. Per passare alla sincronizzazione manuale, vai a File (Android Studio su macOS) > Impostazioni > Build, esecuzione, deployment > Strumenti di build e imposta Modalità di sincronizzazione del progetto su Sincronizzazione manuale con promemoria.

Allegato immagine in Gemini

Ora puoi allegare file immagine e fornire informazioni aggiuntive insieme al prompt. Ad esempio, puoi allegare mock-up o screenshot della UI per fornire a Gemini il contesto del layout della tua app. Di conseguenza, Gemini può generare codice di composizione in base a un'immagine fornita o spiegare i componenti componibili e il flusso di dati di uno screenshot dell'interfaccia utente. Per saperne di più, vedi Allegare un'immagine alla query.

@Contesto del file in Gemini

Ora puoi allegare i file di progetto come contesto nelle interazioni di chat con Gemini in Android Studio. In questo modo puoi fare rapidamente riferimento ai file nei tuoi prompt per Gemini. Nel campo di input della chat di Gemini, digita @ per visualizzare un menu di completamento dei file e selezionare i file da allegare. Puoi anche fare clic sul menu a discesa Contesto per vedere quali file sono stati allegati automaticamente da Gemini. In questo modo hai un maggiore controllo sul contesto inviato a Gemini. Per saperne di più, consulta Allegare un file alla richiesta.