Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Configuração da organização

Se você configurar o Cloud Workstations para uma organização, poderá criar uma configuração de estação de trabalho do usuário com código pré-criado e pré-baixado. Isso permite que os desenvolvedores comecem a trabalhar imediatamente, sem esperar a conclusão do processo de build.

Para criar uma configuração de estação de trabalho de usuário, crie uma estação de trabalho de administrador, execute o processo de build uma vez, crie um snapshot do disco permanente e use esse snapshot para criar uma nova configuração de estação de trabalho.

Criar uma estação de trabalho de administrador

Siga as etapas em Iniciar a estação de trabalho para criar e iniciar uma única estação de trabalho. Essa será sua imagem de base.

Criar os destinos

Na estação de trabalho do administrador, faça o download do código-fonte e crie os destinos. É possível criar os destinos manualmente ou automatizar a criação usando o script fornecido.

Build manual

Antes de executar o script de build, acesse o código conforme descrito em Acesso ao código-fonte. Em seguida, crie manualmente os destinos, conforme descrito em Fazer o download, criar e executar.

Build automatizado

Execute o script setup.sh fornecido no repositório sdv-setup. Esse script automatiza a clonagem do código-fonte do Android e a criação dos destinos.

O script leva várias horas para ser concluído. Ele clona o código-fonte do Android (aproximadamente 30 minutos) e, em seguida, cria os destinos de SDV IVI (2 horas), mídia (30 minutos) e núcleo (10 minutos).

(Opcional) Configurar um projeto do Android Studio para Plataforma

O Android Studio for Platform (ASfP) é um ambiente de desenvolvimento integrado pré-instalado no Cloud Workstation. Se todos os desenvolvedores trabalham no mesmo projeto, é possível configurar um projeto do ASfP no snapshot do disco ou exportar um modelo .asfp-project compartilhável (destino lunch, directories com escopo e other_languages: [rust]) que todos possam importar. Siga as instruções em Criar um projeto de SDV e Modelos de projeto compartilháveis (exportação e importação) para configurar e compartilhar o projeto.

Crie um snapshot de disco

Depois que o build for concluído, crie um snapshot do disco permanente da estação de trabalho de administrador.

Remova a configuração e os cookies do Git para evitar o compartilhamento de credenciais pessoais com outros usuários:
```
rm ~/.gitcookies
rm ~/.gitconfig
```
Remova o repositório sdv-setup para manter a imagem de base limpa:
```
rm -rf ~/sdv-setup
```
Encontre o disco da estação de trabalho do administrador:
1. Mantenha a estação de trabalho do administrador em execução.
2. No console do Google Cloud, digite VM Instances na barra de pesquisa e clique no primeiro resultado.
3. Na barra Filtro, digite workstation_id:work-station. work-station precisa corresponder ao ID da estação de trabalho do administrador. Pressione Enter para filtrar os resultados.
4. Clique na entrada restante.
5. Na página da instância de VM, dois discos diferentes estão listados em Armazenamento. Clique no disco que tem um Tamanho (GB) de 1000 e um Tipo de Disco permanente SSD regional. Esse disco contém o diretório inicial que você quer incluir no snapshot.
Interrompa a estação de trabalho do administrador:
1. Mantenha a página do disco aberta.
2. Em uma nova guia ou janela do navegador, abra o console do Google Cloud e acesse a página do Cloud Workstations. Na barra de pesquisa, digite Cloud Workstations e clique no primeiro resultado.
3. Clique em Estações de trabalho no painel lateral.
4. Clique na estação de trabalho do administrador (com o ID work-station) na tabela.
5. Clique em Parar na barra de ferramentas e aguarde a estação de trabalho parar.
Aviso :se você não interromper a estação de trabalho antes de criar o snapshot do disco, corre o risco de corromper os dados no snapshot.
Crie o snapshot do disco:
1. Volte para a página do disco e clique em Criar snapshot na barra de ferramentas.
2. No campo Nome, use aaos-sdv-dev-snapshot.
3. Não altere os valores dos outros campos.
4. Na parte de baixo da página, clique em Criar.

Depois de um tempo, o snapshot de disco é criado e fica pronto para uso.

Criar a configuração da estação de trabalho do usuário

Crie uma nova configuração de estação de trabalho que use o snapshot como ponto de partida:

Siga as instruções em Definir variáveis de ambiente para iniciar o Cloud Shell e, em seguida, defina as variáveis de ambiente.
Aplique a configuração do Terraform para criar a configuração da estação de trabalho do usuário:
```
cd ~/dev/sdv-setup/tf/user_dev_env
terraform init
terraform apply -auto-approve
```

Criar uma estação de trabalho de usuário

No console do Google Cloud, acesse a página do Cloud Workstations. Digite Cloud Workstations na barra de pesquisa e clique no primeiro resultado.
Clique em Estações de trabalho no painel lateral.
Clique em Criar estação de trabalho na barra de ferramentas.
Insira um ID para a estação de trabalho ou deixe o padrão.
Insira um Nome de exibição para a estação de trabalho. Se você deixar esse campo em branco, o ID será usado.
Selecione user-workstation-config como a Configuração.
Clique em Criar.
Na lista de estações de trabalho, encontre a que você acabou de criar. Clique em Iniciar na coluna Ações rápidas.
Depois que a estação de trabalho for iniciada, clique em Iniciar na coluna Ações rápidas para começar a usá-la.
Abra um explorador de arquivos para verificar se o diretório inicial contém os arquivos do snapshot de disco.

Sua organização agora pode criar estações de trabalho para os desenvolvedores. Para mais informações sobre como configurar o acesso ao Cloud Workstations, consulte Controle de acesso com o IAM.