Adicionar módulo para um novo dispositivo

Os módulos oferecem um contêiner para o código-fonte, os arquivos de recursos e configurações do aplicativo, 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 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 de 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 módulo do Google Cloud a um projeto. Para saber mais detalhes sobre a criação de 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 exibida, o Android Studio oferece os seguintes módulos de dispositivos:
    • Módulo de telefones e tablets
    • Módulo de Wear OS
    • Módulo de Android TV
    • Módulo de Glass
    Selecione o módulo para o dispositivo desejado e clique em Next.
  3. No formulário Configure your new module, insira os seguintes detalhes:
    • Application Name: O nome usado como o título do ícone na tela de início do aplicativo para o novo módulo.
    • Module Name: Texto usado como o nome da pasta onde os arquivos de código-fonte e recursos são visíveis.
    • Package Name: Namespace do Java para o código no seu módulo. Esse namespace é adicionado ao atributo package no arquivo de manifesto do Android.
    • Minimum SDK: Configuração que indica a versão mais baixa da plataforma do Android compatível com o módulo do aplicativo. Esse valor define o atributo minSdkVersion no arquivo build.gradle, que você pode editar posteriormente.

    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 selecionar para usar como atividade principal. Clique em um modelo de atividade que você quer iniciar e clique em Next. Se você não precisa de uma atividade, clique em Add No Activity e clique em Finish para concluir.
  5. Se você escolher um modelo de atividade, insira as configurações da atividade na página Customize the Activity. A maioria dos modelos precisa de Activity Name, Layout Name e Title, mas cada modelo tem configurações específicas da atividade. Clique em Finish. Quando você cria um módulo de aplicativo 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.

Após a conclusão da sincronização do projeto do Gradle, o novo módulo é exibido na janela Project à esquerda. Se a pasta do novo módulo não for exibida, verifique se a janela mostra a visualização do Android.

Importar um módulo

Se você quiser 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 do módulo ou dos módulos que deseja importar:
    • Se você está importando um módulo, indique seu 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 e indica Source location e Module name. Verifique se a caixa Import está marcada para cada módulo que você quer importar.
    Se o módulo ou os módulos tiverem outras dependências, elas estarão listadas para importação em Additional required modules.
  3. Digite o nome do módulo ou dos módulos desejados nos campos Module name.
  4. Clique em Finish.

Após a importação do módulo, ele será exibido na janelaProject à esquerda.

Próximas etapas

Após adicionar um novo módulo, você poderá modificar o código e os recursos dele, definir as configurações de compilação e compilá-lo. Você também poderá executar e depurar o módulo como qualquer outro aplicativo.

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

Conforme você desenvolve um novo módulo, pode criar código independente de dispositivo que já está duplicado em um módulo de aplicativo diferente. Em vez de manter código duplicado, considere a movimentação do código compartilhado para um módulo de biblioteca e a adição dessa biblioteca como uma dependência dos módulos de aplicativo. Para obter mais informações sobre a criação de um módulo de biblioteca e sua adição como dependência, consulte Criar uma biblioteca Android.