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.

Configurar um ambiente de desenvolvimento integrado para desenvolvimento de SDV

O Android Studio for Platform (ASfP) é o ambiente de desenvolvimento integrado recomendado (IDE, na sigla em inglês) para desenvolver a plataforma Android, incluindo projetos de veículos definidos por software (SDV, na sigla em inglês) do Android Automotive OS (AAOS) . O ASfP oferece um conjunto avançado de ferramentas para edição, criação, depuração e teste de código, incluindo:

Assistência com tecnologia de IA (Gemini)
Suporte às linguagens Rust, C ou C++ e Java
Integrações úteis para o desenvolvimento de SDV do AAOS (por exemplo, suporte ao emulador Cuttlefish e à linguagem VSIDL)

Instalar o Android Studio for Platform

Para instalar o ASfP:

Faça o download do Android Studio for Platform.
Escolha a versão que melhor atende às suas necessidades:
- Estável:a versão de produção mais recente, recomendada para a maioria dos usuários
- Canary:builds de acesso antecipado com os recursos mais recentes, mas potencialmente menos estáveis
Siga as instruções de instalação fornecidas na página de download.

Configurar um projeto de SDV do AAOS

Para configurar um projeto de SDV do AAOS:

Verifique se você tem acesso ao repositório de código-fonte do SDV do AAOS e se inicializou e sincronizou seu checkout local. Consulte Fazer o download, criar e executar para mais detalhes sobre como acessar a origem e inicializar o repositório.
Inicie o Android Studio for Platform.
Se você estiver usando pela primeira vez, siga o assistente de configuração para personalizar o ambiente de desenvolvimento.
Crie um novo projeto:
- Se você não tiver um projeto aberto, clique em New na tela de boas-vindas.
- Se você já tiver um projeto aberto, clique em Open ou selecione ASfP > Project > Import ASfP Project no menu.
Preencha os detalhes de configuração do projeto no assistente:
- Repo checkout:especifique o caminho absoluto para a raiz do checkout do código-fonte do SDV do AAOS local (por exemplo, /path/to/sdv_source).
- lunch target:insira o destino de inicialização apropriado para o desenvolvimento de SDV do AAOS no Cuttlefish, por exemplo, sdv_core_cf-aosp_current-userdebug. Consulte Escolher um destino para mais destinos disponíveis.
- Project sources:liste os diretórios ou módulos iniciais que você quer incluir no projeto ou clique no ícone de pasta para abrir o navegador do sistema de arquivos e selecionar os diretórios. A seleção de muitos diretórios ou módulos afeta o desempenho de indexação e pesquisa do IDE. Portanto, inclua apenas diretórios ou módulos relevantes.
- Language support:selecione Rust e C++ como linguagens compatíveis.
- Project name:dê um nome descritivo ao projeto.
- Finish setup:clique em Finish. O ASfP cria a estrutura do projeto e o arquivo de configuração .asfp-project.

O ASfP inicia automaticamente um processo de sincronização inicial. O ASfP analisa o código-fonte, resolve dependências usando o sistema de build Soong e cria as informações necessárias para os recursos de inteligência de código. Isso pode levar um tempo significativo, especialmente para a primeira sincronização.

Personalizar o projeto

O arquivo .asfp-project na raiz do projeto permite mais personalização. Você pode editar esse arquivo para:

Adicionar ou remover diretórios e módulos.
Ativar o suporte a outras linguagens, como C++ ou Rust (Java e Kotlin são padrão).
Configurar flags de build.

Para fazer mudanças no arquivo de configuração, selecione ASfP > Project > Open Config. Consulte Visão geral dos projetos para conferir as opções de configuração disponíveis.

Depurar e testar

Para depurar e testar o código no ASfP, consulte Depurar código da plataforma e Testar código da plataforma com o atest.

Integrações disponíveis

O ASfP vem com algumas integrações úteis para o desenvolvimento de SDV do AAOS, incluindo suporte ao Cuttlefish e ao Language Server Protocol (LSP) no VSIDL.

Plug-in do Cuttlefish

O plug-in do Cuttlefish permite que os usuários criem e executem dispositivos Cuttlefish locais diretamente do ASfP.

Instalar o plug-in

O plug-in do Cuttlefish é pré-instalado com o ASfP e não requer configuração. O plug-in exige que as ferramentas do Cuttlefish sejam instaladas no dispositivo. Siga as instruções para instalar as ferramentas do Cuttlefish, se necessário.

Criar dispositivo Cuttlefish

Para criar um novo dispositivo:

Abra a janela de ferramentas do Gerenciador de dispositivos selecionando Tools > Device Manager ou clicando no ícone Running Devices no painel direito, se o Gerenciador de dispositivos já estiver fixado lá.
Clique no ícone + e selecione Create Cuttlefish Device.
Configure o novo dispositivo Cuttlefish. É possível criar dispositivos Cuttlefish de duas maneiras:
- No checkout da árvore de origem do Android local:
  - Selecione o caminho para o destino criado que corresponde à configuração de inicialização (consulte Escolher um destino para mais detalhes).
  - Selecione o caminho do host.
  - Opcionalmente, selecione as configurações de dispositivo disponíveis ou None para a configuração padrão.
- Na configuração canônica (use essa opção para criar vários dispositivos a partir da configuração única):
  - Selecione o caminho para a configuração do dispositivo.
  - Opcionalmente, forneça flags de substituição para substituir as opções de configuração.
Aguarde a criação do dispositivo Cuttlefish e a adição dele à lista de dispositivos em execução no Gerenciador de dispositivos.
Selecione o dispositivo Cuttlefish no menu Running Devices.

É possível iniciar ou parar dispositivos Cuttlefish individuais clicando no ícone de parada ou inicialização ao lado do dispositivo no Gerenciador de dispositivos.

Acessar a página do dispositivo Cuttlefish

O plug-in do Cuttlefish tem uma janela de ferramentas que mostra a página Cuttlefish Device, em que é possível acessar os recursos de espelhamento de tela.

Para abrir a janela de ferramentas do Cuttlefish, clique no ícone ... no painel esquerdo e selecione Cuttlefish. Como alternativa, você pode pesquisar Cuttlefish no item de menu Help > Find Action.

Language Server Protocol no VSIDL

No VSIDL, o LSP oferece um conjunto avançado de recursos do IDE para melhorar o fluxo de trabalho de desenvolvimento ao trabalhar com arquivos VSIDL (com uma extensão .vsidl) no ASfP.

Destaque de sintaxe semântica

O servidor LSP fornece destaque de sintaxe para arquivos VSIDL.

O que ele faz:destaca palavras-chave (service_bundle, publisher), campos (package:, message:) e literais.
Como testar:abra qualquer arquivo VSIDL. O arquivo é codificado por cores para distinguir palavras-chave estruturais de identificadores definidos pelo usuário.

Diagnóstico em tempo real (erros e avisos)

O servidor LSP valida arquivos continuamente e informa problemas em tempo real.

O que ele faz:detecta erros de sintaxe, referências de tipo inválidas e outros erros em todo o catálogo e dependências.
Como testar:introduza um erro de digitação em um nome de mensagem (por exemplo, TiiirePressure). Uma linha ondulada vermelha aparece abaixo do erro de ortografia. Passe o cursor sobre a palavra para ver a mensagem de erro ou confira a lista completa na janela de ferramentas Problems na parte de baixo do IDE.

Navegação e inteligência

Você pode usar recursos de navegação e inteligência para explorar as relações entre diferentes partes do catálogo VSIDL.

Preenchimento automático: pressione Control+Space para conferir sugestões de palavras-chave, mensagens protobuf, serviços RPC, tópicos e canais. As sugestões de palavras-chave incluem explicações curtas e úteis sobre a finalidade delas diretamente no menu de conclusão. O LSP também fornece snippets inteligentes para blocos como publisher ou server para acelerar o fluxo de trabalho.
Acessar uma definição:mantenha Control pressionado e clique (ou pressione Control+B) em uma mensagem, serviço, tópico ou referência de canal para acessar diretamente a definição de origem, mesmo que ela esteja em um arquivo VSIDL ou protobuf diferente.
Encontrar referências:coloque o cursor na palavra-chave publisher, subscriber, server ou client e pressione Alt+Shift+F7 para encontrar todas as ocorrências.
Informações ao passar o cursor:mova o cursor para um tipo ou propriedade (ou pressione Control+Q). Uma dica de ferramenta aparece mostrando os comentários de documentação (se houver).

Recursos estruturais

O servidor LSP ajuda a gerenciar e navegar pela estrutura de arquivos VSIDL grandes:

Símbolos de documento (estrutura de tópicos) : pressione Control+F12 para uma dica de ferramenta de navegação rápida ou abra a janela de ferramentas Structure (Control+Alt+7) para conferir uma visualização em árvore de todos os pacotes e unidades no arquivo.
Intervalos de recolhimento:clique nos ícones > ou V na margem (ao lado dos números de linha) para recolher ou expandir grandes blocos lógicos, como service_bundle ou definições de mapeamento.
Formatação de documentos:pressione Control+Alt+L para reformatar o arquivo automaticamente, criando recuos e espaçamentos consistentes.