A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Configurazione dell'organizzazione

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

Per creare una configurazione di workstation utente, crea una workstation di amministrazione, esegui il processo di compilazione una volta, crea uno snapshot del Persistent Disk e poi utilizza questo snapshot per creare una nuova configurazione di workstation.

Creazione di una workstation di amministrazione

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

Creazione dei target

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

Build manuale

Prima di eseguire lo script di build, ottieni l'accesso al codice come descritto in Accesso al codice sorgente. Quindi crea manualmente i target come descritto in Scarica, crea ed esegui.

Build automatica

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

Apri un terminale sulla workstation.

Imposta le credenziali Git:

git config --global user.email "Your email address"
git config --global user.name "Your name"

Autenticati su partner-android.googlesource.com:
1. Accedi a partner-android-review.googlesource.com con il tuo account partner Android.
2. Vai a Impostazioni e seleziona Profilo.
3. Vai alla sezione Credenziali HTTP e fai clic su Ottieni password.
4. Segui le istruzioni sullo schermo e incolla lo script di autenticazione nel terminale della workstation. Viene creato il file ~/.gitcookies, necessario per l'accesso.

Esegui lo script di configurazione completando i seguenti passaggi:

Segui i passaggi di autenticazione descritti in Ottieni l'accesso. In questo modo puoi accedere al repository dello script di configurazione.
Clona il repository sdv-setup ed esegui lo script di configurazione:

# Change directories to the home directory
cd ~/

# Clone the sdv-setup repository
git clone https://sdv.googlesource.com/external/sdv-setup

# Ensure the setup script is executable
chmod +x sdv-setup/setup/setup.sh

# Run the setup script
./sdv-setup/setup/setup.sh

Il completamento dello script richiede diverse ore. Clona il codice sorgente Android (circa 30 minuti) e poi 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 su Cloud Workstations. Se tutti gli sviluppatori lavorano sullo stesso progetto, puoi configurare un progetto ASfP nello snapshot del disco che tutti possono utilizzare. Segui le istruzioni riportate in Configurare un progetto SDV AAOS per configurare il progetto.

Crea uno snapshot del disco

Al termine della build, crea uno snapshot del disco permanente della workstation di amministrazione.

Rimuovi la configurazione e i cookie 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 in esecuzione la workstation di amministrazione.
2. Nella console Google Cloud, inserisci VM Instances nella barra di ricerca e fai clic sul primo risultato.
3. Nella barra Filtra, 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 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. Mantieni 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 e fai clic sul primo risultato.
3. Fai clic su Workstations 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 e attendi l'arresto della workstation.
Avviso: se non arresti 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 e 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 poco tempo, lo snapshot del disco viene creato ed è pronto per l'uso.

Crea la configurazione della workstation utente

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

Segui le istruzioni riportate in Impostare le variabili di ambiente per avviare Cloud Shell e poi 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 e fai clic sul primo risultato.
Fai clic su Workstations nel riquadro laterale.
Fai clic su Crea workstation nella barra degli strumenti.
Inserisci un ID per la workstation o lascia il valore predefinito.
Inserisci un Nome visualizzato per la workstation. Se lasci questo campo vuoto, 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 Esplora file per verificare che la home directory contenga i file dello snapshot del disco.

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