Adicionar módulo para um dispositivo novo

Os módulos oferecem um contêiner para o código-fonte, os arquivos de recursos e as configurações do app, como o arquivo de compilação do módulo e o arquivo de manifesto do Android. Cada módulo pode ser individualmente compilado, testado e depurado.

O Android Studio usa módulos para facilitar a adição de novos dispositivos ao projeto. Basta seguir algumas etapas simples no Android Studio para criar um módulo que contém código específico de um tipo de dispositivo, como Wear OS ou Android TV. O Android Studio cria automaticamente diretórios de módulos, como diretórios de origem e recursos, e um arquivo build.gradle padrão adequado para o tipo de dispositivo. Além disso, o Android Studio cria módulos de dispositivos com as configurações recomendadas de compilação, como o uso da biblioteca Leanback para módulos do Android TV.

Esta página descreve como adicionar um novo módulo para um dispositivo específico.

O Android Studio também facilita a adição de uma biblioteca ou de um módulo do Google Cloud ao projeto. Para saber detalhes sobre como criar um módulo de biblioteca, acesse Criar um módulo de biblioteca.

Criar um novo módulo

Para adicionar um novo módulo no projeto para um novo dispositivo, faça o seguinte:

  1. Clique em File > New > New Module.
  2. Na janela Create New Module, o Android Studio oferece os seguintes módulos de dispositivos:
    • Módulo de smartphone e tablet
    • Módulo de Wear OS
    • Módulo de Android TV
    • Módulo de Glass
    Selecione o módulo para o dispositivo que você quer usar e clique em Next.
  3. No formulário Configure your new module, insira os seguintes detalhes:
    • Application Name: esse nome é usado como o título do ícone na tela de início do app para o novo módulo.
    • Module Name: esse texto é usado como o nome da pasta em que os arquivos de código-fonte e de recursos são visíveis.
    • Package Name: é o namespace Java para o código no seu módulo. Esse namespace é adicionado ao atributo package no arquivo de manifesto do Android do módulo.
    • Minimum SDK: essa configuração indica a versão mínima da plataforma Android que é compatível com o módulo do app. Esse valor define o atributo minSdkVersion no arquivo build.gradle, que pode ser editado posteriormente.

    Em seguida, clique em Next.

  4. Dependendo do módulo de dispositivo selecionado, a página a seguir exibe uma seleção dos modelos de código adequados que você pode escolher para usar como atividade principal. Clique em um modelo de atividade com que você quer iniciar e depois em Next. Se você não precisa de uma atividade, clique em Add No Activity e em Finish para concluir.
  5. Se você escolher um modelo de atividade, insira as configurações dela na página Customize the Activity. A maioria dos modelos precisa de um Activity Name, Layout Name, Title e Source Language, mas cada modelo tem configurações específicas de atividade. Clique em Finish. Quando você cria um módulo de app com um modelo de atividade, pode executar e testar imediatamente o módulo no dispositivo.

O Android Studio cria todos os arquivos necessários para o novo módulo e sincroniza o projeto com os arquivos do Gradle do novo módulo. A adição de um módulo a um novo dispositivo também adiciona todas as dependências necessárias para o dispositivo de destino ao arquivo de compilação do módulo.

Quando a sincronização do projeto do Gradle for concluída, o novo módulo será exibido na janela Project à esquerda. Caso você não veja a pasta do novo módulo, verifique se a janela está exibindo a visualização Android.

Importar um módulo

Para importar um módulo existente para o projeto, faça o seguinte:

  1. Clique em File > New > Import Module.
  2. Na caixa Source directory, digite ou selecione o diretório dos módulos que você quer importar:
    • Se você está importando um módulo, indique o diretório raiz.
    • Se você está importando vários módulos de um projeto, indique a pasta do projeto. Para cada módulo dentro da pasta, uma caixa é exibida, indicando Source location e Module name. Verifique se a caixa Import está marcada para cada módulo que você quer importar.
    Se os módulos tiverem outras dependências, elas estarão listadas para importação em Additional required modules.
  3. Digite os nomes dos módulos a serem usados nos campos Module name.
  4. Clique em Finish.

Depois da importação do módulo, ele é exibido na janela Project à esquerda.

Próximas etapas

Depois de adicionar um novo módulo, você pode modificar o código e os recursos dele, definir as configurações de compilação e compilá-lo. Também é possível executar e depurar o módulo como qualquer outro app.

Você também pode adicionar código e recursos para oferecer compatibilidade com o novo dispositivo. Para ver mais informações sobre como desenvolver módulos de app para tipos de dispositivo diferentes, consulte a documentação correspondente:

À medida que você desenvolve um novo módulo, pode criar um código independente de dispositivo que já está duplicado em um módulo de app diferente. Em vez de manter o código duplicado, mova o código compartilhado para um módulo de biblioteca e adicione essa biblioteca como uma dependência aos módulos de app. Para ver mais informações sobre como criar um módulo de biblioteca e adicioná-lo como dependência, consulte Criar uma biblioteca Android.