Sviluppo di codice iterativo

In qualità di sviluppatore mobile, spesso sviluppi l'interfaccia utente della tua app passo dopo passo anziché tutto contemporaneamente. Android Studio adotta questo approccio con Jetpack Compose fornendo strumenti che non richiedono una compilazione completa per ispezionare, modificare i valori e verificare il risultato finale.

Live Edit

La modifica in tempo reale è una funzionalità che ti consente di aggiornare i composabili in emulatori e dispositivi fisici in tempo reale. Questa funzionalità riduce al minimo i cambi di contesto tra la scrittura e la creazione dell'app, consentendoti di concentrarti sulla scrittura del codice per più tempo senza interruzioni.

La modifica in tempo reale ha tre modalità:

• Manuale: le modifiche al codice vengono applicate quando vengono inviate manualmente utilizzando Control+' (Comando+' su macOS)
• Manuale al salvataggio: le modifiche al codice vengono applicate quando vengono salvate manualmente utilizzando Ctrl+S (Cmd+S su macOS).
• Automatico: le modifiche vengono applicate sul dispositivo o nell'emulatore quando aggiorni una funzione componibile.

La funzionalità di modifica in tempo reale si concentra sulle modifiche al codice relative a UI e UX. La modifica in tempo reale non supporta modifiche come aggiornamenti della firma dei metodi, aggiunta di nuovi metodi o modifiche alla gerarchia delle classi. Per ulteriori informazioni, consulta l'elenco delle limitazioni di Live Edit.

Questa funzionalità non sostituisce la compilazione e l'esecuzione dell'app o Applica modifiche. È invece progettato per ottimizzare il tuo flussi di lavoro durante la creazione, il deployment e l'iterazione per lo sviluppo dell'interfaccia utente di Compose.

Il flusso di lavoro delle best practice è il seguente:

1. Configura l'applicazione in modo che possa essere eseguita.
2. Utilizza la modifica in tempo reale il più possibile finché non devi apportare una modifica non supportata da questa funzionalità, ad esempio l'aggiunta di nuovi metodi mentre l'app è in esecuzione.
3. Dopo aver apportato una modifica non supportata, fai clic su Esegui per riavviare la tua app e riprendere la modifica in tempo reale.

Iniziare a utilizzare la modifica in tempo reale

Per iniziare, segui questi passaggi per creare un'attività di composizione vuota, attivare la modifica in tempo reale per il tuo progetto e apportare modifiche con questa funzionalità.

Configurare il nuovo progetto

1. Prima di iniziare, assicurati di avere installato Android Studio Giraffe o versioni successive e che il livello API del tuo dispositivo fisico o dell'emulatore sia almeno 30.

2. Apri Android Studio e seleziona Nuovo progetto nella finestra di dialogo Ti diamo il benvenuto in Android Studio. Se hai già un progetto aperto, puoi crearne uno nuovo andando su File > Nuovo > Nuovo progetto.

3. Scegli il modello Attività di composizione vuota per Smartphone e tablet e poi fai clic su Avanti.

   

4. Completa la finestra di dialogo Nuovo progetto con le informazioni richieste: nome, nome del pacchetto, posizione di salvataggio, SDK minimo e linguaggio di configurazione di compilazione.

   .

5. Fai clic su Fine.

Attivare la modifica in tempo reale

1. Vai alle impostazioni per attivare la modifica in tempo reale.

   • Su Windows o Linux, vai a File > Impostazioni > Editor > Modifica in tempo reale.
   • Su macOS, vai a Android Studio > Impostazioni > Editor > Live Edit.

2. Seleziona l'opzione Modifica dal vivo e la modalità da eseguire dalle impostazioni.

   In modalità manuale, le modifiche al codice vengono applicate ogni volta che premi CTRL + " (Comando + " su macOS). In modalità manuale al salvataggio, le modifiche al codice vengono applicate ogni volta che salvi manualmente utilizzando Control+S (Command+S su macOS). In modalità automatica, le modifiche al codice vengono applicate nel dispositivo o nell'emulatore man mano che le apporti.

   

3. Nell'editor, apri il file MainActivity, che è il punto di contatto per la tua app.

4. Fai clic su Esegui per eseguire il deployment dell'app.

5. Dopo aver attivato la modifica in tempo reale, viene visualizzato il segno di spunta verde Aggiornato in alto a destra nella finestra dello strumento Dispositivi in esecuzione:

   

Apportare e rivedere le modifiche

Man mano che apporti le modifiche supportate nell'editor, il dispositivo di test virtuale o fisico si aggiorna automaticamente.

Ad esempio, modifica il metodo Greeting esistente in MainActivity in quanto segue:

@Composable
fun Greeting(name: String) {
    Text(
        text = "Hello $name!",
        Modifier
            .padding(80.dp) // Outer padding; outside background
            .background(color = Color.Cyan) // Solid element background color
            .padding(16.dp) // Inner padding; inside background, around text)
    )
}
IterativeDevelopmentSnippets.kt

Le modifiche vengono visualizzate istantaneamente sul dispositivo di test, come mostrato nella figura 4.

Risolvere i problemi relativi a Live Edit

Se non vedi le modifiche sul dispositivo di test, è possibile che Android Studio non sia riuscito a aggiornarle. Controlla se l'indicatore di modifica in tempo reale indica Out Of Date (Non aggiornato), come mostrato nella figura 5, il che indica un errore di compilazione. Per informazioni sull'errore e suggerimenti su come risolverlo, fai clic sull'indicatore.

Limitazioni di Live Edit

Di seguito è riportato un elenco delle limitazioni attuali.

• [Si applica solo ad Android Studio Giraffe e versioni successive] La modifica in tempo reale richiede Compose Runtime 1.3.0 o versioni successive. Se il tuo progetto utilizza una versione precedente di Scrivi, la funzionalità di modifica in tempo reale è disabilitata.

• [Si applica solo ad Android Studio Giraffe e versioni successive] La modifica in tempo reale richiede AGP 8.1.0-alpha05 o versioni successive. Se il tuo progetto utilizza una versione precedente di AGP, la modifica in tempo reale è disabilitata.

• La modifica in tempo reale richiede un dispositivo fisico o un emulatore con livello API 30 o versioni successive.

• La modifica in tempo reale supporta solo la modifica del corpo di una funzione, il che significa che non puoi cambiare il nome o la firma della funzione, aggiungere o rimuovere una funzione o modificare i campi non funzione.

• La modifica in tempo reale reimposta lo stato dell'app la prima volta che modifichi una funzione Componi in un file. Questo accade solo dopo la prima modifica del codice: lo stato dell'app non viene reimpostato dalle modifiche al codice successive apportate alle funzioni di composizione in quel file.

• Le classi modificate con la funzionalità Modifica in tempo reale potrebbero subire una penalizzazione delle prestazioni. Esegui la tua app e utilizza una release build pulita se vuoi valutare il suo rendimento.

• Devi eseguire un'esecuzione completa affinché il debugger possa operare sulle classi che hai modificato con la modifica in tempo reale.

• Un'app in esecuzione potrebbe avere un arresto anomalo quando la modifichi con la funzionalità Modifica in tempo reale. In questo caso, puoi eseguire nuovamente il deployment dell'app con il pulsante Esegui .

• La modifica in tempo reale non esegue alcuna manipolazione del bytecode definita nel file di compilazione del progetto, ad esempio la manipolazione del bytecode che verrebbe applicata durante la compilazione del progetto utilizzando le opzioni del menu Compila o facendo clic sui pulsanti Compila o Esegui.

• Le funzioni non componibili vengono aggiornate in tempo reale sul dispositivo o sull'emulatore e viene attivata una nuova composizione completa. La ricostituzione completa potrebbe non richiamare la funzione aggiornata. Per le funzioni non componibili, devi attivare le funzioni appena aggiornate o eseguire di nuovo l'app.

• La modifica in tempo reale non riprende al riavvio dell'app. Devi eseguire di nuovo l'app.

• La modifica in tempo reale supporta solo le procedure di debug.

• La modifica in tempo reale non supporta i progetti che utilizzano valori personalizzati per moduleName in kotlinOptions nella configurazione di compilazione.

• La modifica in tempo reale non funziona con i deployment con più implementazioni. Ciò significa che non puoi eseguire il deployment su un dispositivo e poi su un altro. La modifica in tempo reale è attiva solo sull'ultimo insieme di dispositivi su cui è stato eseguito il deployment dell'app.

• La modifica in tempo reale funziona con i deployment su più dispositivi (deployment su più dispositivi creati tramite Seleziona più dispositivi nel menu a discesa del dispositivo di destinazione). Tuttavia, non è ufficialmente supportato e potrebbero verificarsi problemi. Se riscontri problemi, segnalali.

• Applica modifiche/Applica modifiche al codice non sono compatibili con la modifica in tempo reale e richiedono il riavvio dell'app in esecuzione.

• Al momento, la modifica in tempo reale non supporta i progetti Android Automotive.

Domande frequenti su Modifica in tempo reale

• Qual è lo stato attuale di Live Edit?

  La modifica in tempo reale è disponibile in Android Studio Giraffe. Per attivarla, vai a File > Impostazioni > Editor > Live Edit (Android Studio > Impostazioni > Editor > Live Edit su macOS).

• Quando devo utilizzare Live Edit?

  Utilizza la modifica in tempo reale quando vuoi vedere rapidamente l'effetto degli aggiornamenti agli elementi UX (ad esempio aggiornamenti dei modificatori e animazioni) sull'esperienza complessiva dell'app.

• Quando è preferibile evitare di utilizzare la funzionalità Live Edit?

  La funzionalità di modifica in tempo reale si concentra sulle modifiche al codice relative a UI e UX. Non supporta modifiche come aggiornamenti delle firme dei metodi, aggiunta di nuovi metodi o modifiche alla gerarchia delle classi. Per ulteriori informazioni, consulta Limitazioni di Live Edit.

• Quando devo utilizzare Anteprima composizione?

  Utilizza l'anteprima di Compose quando sviluppi singoli composabili. L'anteprima visualizza gli elementi di composizione e si aggiorna automaticamente per mostrare l'effetto delle modifiche al codice. L'anteprima supporta anche la visualizzazione degli elementi dell'interfaccia utente in configurazioni e stati diversi, ad esempio tema scuro, lingue e scala dei caratteri.

Modifica in tempo reale dei literal (non più supportata)

Android Studio può aggiornare in tempo reale alcune costanti letterali utilizzate nei composabili all'interno di anteprime, emulatore e dispositivo fisico. Ecco alcuni tipi supportati:

• Int
• String
• Color
• Dp
• Boolean

Puoi visualizzare i valori letterali costanti che attivano gli aggiornamenti in tempo reale senza il passaggio di compilazione attivando le decorazioni dei valori letterali tramite l'indicatore dell'interfaccia utente di modifica in tempo reale dei valori letterali:

Applica modifiche

Applica modifiche ti consente di aggiornare il codice e le risorse senza dover eseguire nuovamente il deployment dell'app su un emulatore o un dispositivo fisico (con alcune limitazioni).

Ogni volta che aggiungi, modifichi o elimini composabili, puoi aggiornare l'app senza doverla eseguire di nuovo facendo clic sul pulsante Applica modifiche al codice: