A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco 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, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

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

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é-baixado e pré-criado. 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 do 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 é a imagem base.

Criar os destinos

Na estação de trabalho do administrador, faça o download do código-fonte e crie os destinos. Você pode 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. Este script automatiza a clonagem do código-fonte do Android e a criação dos destinos.

Abra um terminal na estação de trabalho.

Defina suas credenciais do Git:

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

Autentique-se no partner-android.googlesource.com:
1. Faça login em partner-android-review.googlesource.com com sua conta de parceiro do Android.
2. Acesse Configurações e selecione Perfil.
3. Acesse a seção Credenciais HTTP e clique em Receber senha.
4. Siga as instruções na tela e cole o script de autenticação no terminal da estação de trabalho. Isso cria o arquivo ~/.gitcookies, que é necessário para o acesso.

Siga estas etapas para executar o script de configuração:

Siga as etapas de autenticação em Receber acesso. Isso dá acesso ao repositório de scripts de configuração.
Clone o repositório sdv-setup e execute o script de configuração:

# 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

O script leva várias horas para ser concluído. Ele clona o código-fonte do Android (aproximadamente 30 minutos) e cria os destinos SDV IVI (2 horas), Media (30 minutos) e Core (10 minutos).

(Opcional) Configurar um projeto do Android Studio para a plataforma

O Android Studio for Platform (ASfP) é um ambiente de desenvolvimento integrado pré-instalado na estação de trabalho em nuvem. Se todos os desenvolvedores trabalharem no mesmo projeto, configure um projeto ASfP no snapshot de disco para que todos possam usar. Siga as instruções em Configurar um projeto SDV do AAOS para configurar o projeto.

Crie um snapshot de disco

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

Remova sua configuração do Git e os cookies 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 de administrador em execução.
2. No console do Google Cloud, digite VM Instances na barra de pesquisa e clique no resultado principal.
3. Na barra Filtro, digite workstation_id:work-station. work-station precisa corresponder ao ID da sua estação de trabalho de administrador. Pressione Enter para filtrar os resultados.
4. Clique na entrada restante.
5. Na página da instância de VM, dois discos diferentes sã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 de administrador:
1. Mantenha a página do disco aberta.
2. Em uma nova guia do navegador ou janela, 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 de administrador (com o ID work-station) na tabela.
5. Clique em Parar na barra de ferramentas e aguarde a estação de trabalho ser interrompida.
Aviso: se você não parar 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. Deixe os campos restantes com os valores padrão.
4. Na parte de baixo da página, clique em Criar.

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

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

Crie uma 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 definir 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 do 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 usar a estação de trabalho.
Abra um gerenciador de arquivos para verificar se o diretório principal contém os arquivos do resumo do disco.

Agora sua organização 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.