A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Configurazione dell'organizzazione

Se configuri Cloud Workstations per un'organizzazione, puoi creare una configurazione della workstation utente con codice pre-scaricato e pre-creato. In questo modo, gli sviluppatori possono iniziare a lavorare immediatamente senza attendere il completamento del processo di build.

Per creare una configurazione della workstation utente, devi creare una workstation di amministrazione, eseguire il processo di build una volta, creare uno snapshot del disco permanente e quindi utilizzare lo snapshot per creare una nuova configurazione della workstation.

Creazione di una workstation di amministrazione

Segui i passaggi descritti in Avvia la workstation per creare e avviare una singola workstation. Questa sarà l'immagine di base.

Crea i target

Nella workstation di amministrazione, scarica il codice sorgente e crea i target. Puoi creare manualmente i target o automatizzare la creazione utilizzando lo script fornito.

Build manuale

Prima di eseguire lo script di build, accedi al codice come descritto in Accesso al codice sorgente. Poi crea manualmente i target come descritto in Scarica, crea ed esegui.

Build automatizzata

Esegui lo script setup.sh fornito nel repository sdv-setup. Questo script automatizza la clonazione del codice sorgente Android e la creazione dei target.

Il completamento dello script richiede diverse ore. Clona il codice sorgente Android (circa 30 minuti), quindi crea i target SDV IVI (2 ore), Media (30 minuti) e Core (10 minuti).

(Facoltativo) Configura un progetto Android Studio for Platform

Android Studio for Platform (ASfP) è un IDE preinstallato sulla workstation Cloud. Se i tuoi sviluppatori lavorano tutti allo stesso progetto, puoi configurare un progetto ASfP nello snapshot del disco o esportare un modello .asfp-project condivisibile (destinazione lunch, directories con ambito e other_languages: [rust]) che tutti possono importare. Segui le istruzioni riportate in Crea un progetto SDV e Modelli di progetto condivisibili (esportazione e importazione) per configurare e condividere il progetto.

Crea uno snapshot del disco

Al termine della build, crea uno snapshot del Persistent Disk della workstation di amministrazione.

Rimuovi la configurazione e i cookie di Git per evitare di condividere le credenziali personali con altri utenti:
```
rm ~/.gitcookies
rm ~/.gitconfig
```
Rimuovi il repository sdv-setup per mantenere pulita l'immagine di base:
```
rm -rf ~/sdv-setup
```
Trova il disco della workstation di amministrazione:
1. Mantieni la workstation di amministrazione in esecuzione.
2. Nella console Google Cloud, inserisci VM Instances nella barra di ricerca, quindi fai clic sul risultato in alto.
3. Nella barra Filtro, inserisci workstation_id:work-station. work-station deve corrispondere all'ID della tua workstation di amministrazione. Premi Invio per filtrare i risultati.
4. Fai clic sulla voce rimanente.
5. Nella pagina dell'istanza VM, in Spazio di archiviazione sono elencati due dischi diversi. Fai clic sul disco con Dimensioni (GB) pari a 1000 e Tipo pari a Disco permanente SSD a livello di regione. Questo disco contiene la home directory di cui vuoi creare lo snapshot.
Arresta la workstation di amministrazione:
1. Tieni aperta la pagina del disco.
2. In una nuova scheda o finestra del browser, apri la console Google Cloud e vai alla pagina Cloud Workstations. Nella barra di ricerca, inserisci Cloud Workstations, quindi fai clic sul primo risultato.
3. Fai clic su Workstation nel riquadro laterale.
4. Fai clic sulla workstation di amministrazione (con ID workstation work-station) nella tabella.
5. Fai clic su Arresta nella barra degli strumenti, quindi attendi che la workstation si arresti.
Avviso: se non interrompi la workstation prima di creare lo snapshot del disco, rischi di danneggiare i dati nello snapshot.
Crea lo snapshot del disco:
1. Torna alla pagina del disco, quindi fai clic su Crea snapshot nella barra degli strumenti.
2. Nel campo Nome, inserisci aaos-sdv-dev-snapshot.
3. Lascia invariati i valori predefiniti dei restanti campi.
4. Nella parte inferiore della pagina, fai clic su Crea.

Dopo un breve periodo di tempo, lo snapshot del disco viene creato ed è pronto per l'uso.

Crea la configurazione della workstation utente

Crea una nuova configurazione della workstation che utilizzi lo snapshot come punto di partenza:

Segui le istruzioni riportate in Imposta le variabili di ambiente per avviare Cloud Shell, quindi imposta le variabili di ambiente.
Applica la configurazione Terraform per creare la configurazione della workstation utente:
```
cd ~/dev/sdv-setup/tf/user_dev_env
terraform init
terraform apply -auto-approve
```

Crea una workstation utente

Nella console Google Cloud, vai alla pagina Cloud Workstations. Inserisci Cloud Workstations nella barra di ricerca, quindi fai clic sul primo risultato.
Fai clic su Workstation nel riquadro laterale.
Fai clic su Crea workstation nella barra degli strumenti.
Inserisci un ID per la workstation o lascia quello predefinito.
Inserisci un nome visualizzato per la workstation. Se lasci vuoto questo campo, viene utilizzato l'ID.
Seleziona user-workstation-config come Configurazione.
Fai clic su Crea.
Nell'elenco delle workstation, trova quella che hai appena creato. Fai clic su Avvia nella colonna Azioni rapide.
Dopo l'avvio della workstation, fai clic su Avvia nella colonna Azioni rapide per iniziare a utilizzarla.
Apri un esplora file per verificare che la home directory contenga i file dello snapshot del disco.

La tua organizzazione ora può creare workstation per i suoi sviluppatori. Per saperne di più sulla configurazione dell'accesso a Cloud Workstations, consulta Controllo degli accessi con IAM.