Criar ou importar um projeto

O Android Studio for Platform (ASfP) ajuda você a configurar seu ambiente de desenvolvimento para o Android Open Source Project (AOSP). Criado no modelo de espaço de trabalho do IntelliJ, o ASfP oferece suporte à configuração manual e a modelos de equipe compartilháveis.

Abrir o assistente de configuração do projeto

É possível iniciar o assistente de configuração do projeto de duas maneiras:

  • Na tela inicial: clique em Novo projeto ou Importar projeto do ASfP.
  • Em um projeto aberto: no menu principal, selecione ASfP > Projeto > Novo projeto ou Importar projeto do ASfP.

Importar de um modelo

Se sua equipe compartilhar um arquivo de configuração .asfp-project padrão, você poderá inicializar o espaço de trabalho diretamente desse modelo:

  1. No assistente de configuração do projeto, selecione Importar de modelo.
  2. Procure e selecione o arquivo YAML .asfp-project ou .asfp-template compartilhado.
  3. Depois que o assistente preencher as configurações do projeto com base no modelo, verifique o caminho local do Repo checkout e clique em Finish.

Configurar manualmente

Para criar uma configuração de projeto do zero, faça o seguinte:

  1. No assistente de configuração do projeto, escolha configurar o projeto manualmente e preencha os detalhes do projeto:

    • Checkout do Repo (caminhos de módulos): especifique o caminho absoluto para a raiz do checkout da fonte AOSP local (por exemplo, /path/to/aosp).
    • Destino de build: insira o destino de build que você usa para criar (por exemplo, aosp_cf_x86_64_phone-aosp_current-userdebug).
    • Nome do projeto: dê um nome descritivo ao projeto.
    • Diretórios e módulos: liste os diretórios iniciais ou os módulos do Soong a serem incluídos no projeto (relativos à raiz do repositório, como frameworks/base ou packages/apps/Settings).
    • Linguagens: se o fluxo de trabalho incluir código de plataforma C, C++ ou Rust, selecione C ou C++ ou Rust. Java, Kotlin e Android.bp são incluídos por padrão.
    • Variáveis de ambiente e opções de build: no campo Variáveis de ambiente do assistente, adicione variáveis de ambiente personalizadas, como SOONG_ALLOW_MISSING_DEPENDENCIES=true, e, se quiser, marque a caixa de seleção Compilação parcial do Soong (SOONG_PARTIAL_COMPILE) para builds incrementais mais rápidos.

  2. Clique em Concluir. O ASfP cria a estrutura do projeto, gera o arquivo de configuração .asfp-project na raiz do projeto e executa a sincronização inicial.

Compartilhar ou personalizar a configuração do projeto

Após a configuração inicial, você pode personalizar seu projeto a qualquer momento editando o arquivo .asfp-project (ASfP > Projeto > Abrir configuração):

  • Adicione ou exclua diretórios e módulos Soong.
  • Ative outros idiomas (cpp, rust).
  • Configure flags e variáveis de ambiente personalizadas do Soong.

Para exportar sua configuração para colegas de equipe, clique com o botão direito do mouse na guia .asfp-project e selecione Exportar para modelo.

Para mais informações sobre parâmetros .asfp-project, modos de sincronização e ações Android.bp no editor, consulte Visão geral dos projetos e fluxos de trabalho do Soong.