Criando aplicativos Java para Android

  • Artigo

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar migrar.

Saiba mais sobre linhas do tempo e alternativas de suporte.

Para criar seu primeiro aplicativo Android, siga estas etapas:

  1. Conecte-se à sua conta de serviço do repositório (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Selecione um repositório e um branch onde seu aplicativo reside.
  3. Escolha o projeto do Android que você deseja criar.
  4. Configure sua primeira compilação.

Observação

Para que o aplicativo seja executado em um dispositivo real, o build precisa ser assinado por código com um certificado válido.

Observação

O App Center rastreia o projeto pesquisando os arquivos de diretório gradle (e gradlew) do projeto Android. Não inclua esses arquivos no projeto .gitignore, pois o Build do App Center não poderá encontrá-los.

Aviso

Devido ao desligamento recente do JCenter, determinados aplicativos podem enfrentar falhas de Tarefa do Gradle ao criar com o App Center. Veja o guia de migração fornecido pelo Gradle. Como solução alternativa, todas as instâncias do jcenter() podem ser removidas do build.gradle arquivo e substituídas jcenter { url "http://jcenter.bintray.com/"}por . Leia mais sobre o Desligamento do JCenter aqui.

1. Vinculando seu repositório

Você deve se conectar à sua conta de serviço do repositório, caso ainda não tenha feito isso. Depois que sua conta estiver conectada, selecione o repositório em que seu projeto Android está localizado. Para configurar um build para um repositório, você precisa de permissão de administrador e pull para ele.

2. Selecionando um branch

Depois de selecionar um repositório, selecione o branch que você deseja criar. Por padrão, todos os branches ativos serão listados.

3. Configurando seu primeiro build

Antes do primeiro build, o projeto Android precisa ser configurado.

3.1. Gatilhos de build

Por padrão, um novo build é disparado sempre que um desenvolvedor envia por push para um branch configurado. Isso é conhecido como "Integração contínua". Se preferir disparar um novo build manualmente, você poderá alterar essa configuração no painel de configuração.

3.2. Variante de build

As variantes de build disponíveis serão preenchidas a partir dos Tipos de Build e dos Tipos de Produto especificados no arquivo build.gradle (nível do aplicativo). Selecione qual variante de build deve ser criada.

Observação

O Build do App Center dá suporte à localização de variantes de build como a combinação de um Tipo de Build (depuração, versão ou definido personalizado) e um dos tipos de produto declarados pelo Gradle. No momento, não há suporte para a detecção de dimensões de sabor (combinações de vários tipos de produto).

3.3. Criar Pacote de Aplicativos Android (.aab)

O Pacote de Aplicativos Android é um formato de distribuição carregado na Play Store e usado para gerar APKs otimizados para dispositivos específicos. Você pode saber mais sobre o Pacote de Aplicativos Android na documentação oficial do Android.

Alterne a opção para o Pacote de Aplicativos Android para produzir um .aab além do .apk. Se o arquivo (nível do build.gradleaplicativo) contiver o android.bundle bloco , essa opção já estará ativada.

3.4. Incrementar número de versão

Quando habilitado, o código de versão no AndroidManifest.xml do aplicativo é incrementado automaticamente para cada build. A alteração ocorre durante o build real e não será confirmada no repositório.

3.5. Assinatura de código

Um build bem-sucedido produzirá um .apk arquivo e um arquivo adicional .aab , se habilitado. Para liberar o build para a Play Store, ele precisa ser assinado com um certificado válido armazenado em um repositório de chaves. Para assinar os builds produzidos de um branch, habilite a assinatura de código no painel de configuração, carregue o repositório de chaves no repositório e forneça as credenciais relevantes no painel de configuração. Você pode ler mais sobre a assinatura de código na documentação de assinatura de código do Android do App Center. O .aab será assinado usando as mesmas credenciais que o .apk.

3.6. Inicie sua compilação bem-sucedida em um dispositivo real

Use o arquivo APK recém-produzido para testar se o aplicativo é iniciado em um dispositivo real. Isso adiciona aproximadamente mais 10 minutos ao tempo total de build. Leia mais sobre como configurar testes de inicialização.

3.7. Configurar do arquivo build.gradle (nível do aplicativo)

Informações específicas sobre seu build serão coletadas do arquivo Gradle, incluindo dependências, versão de ferramentas de build, tipos de build e tipos de produto.

3.8. Distribuir o build

Você pode configurar cada build bem-sucedido de um branch a ser distribuído para um grupo de distribuição criado anteriormente ou um destino de repositório. Você pode adicionar um novo grupo de distribuição ou configurar uma conexão de repositório de dentro do serviço Distribuir. Há sempre um grupo de distribuição padrão chamado "Colaboradores" que inclui todos os usuários que têm acesso ao aplicativo.

Observação

Se estiver distribuindo para a Google Play Store, um Pacote de Aplicativos Android (.aab) será preferencial e será distribuído se habilitado. Para grupos de distribuição do App Center e Intune destinos de loja, um regular .apk será usado mesmo se um .aab também for gerado.

4. Resultados de build

Depois que um build é disparado, ele pode estar nestes estados:

  • enfileirado – o build está em uma fila aguardando a liberação de recursos.
  • compilação – o aplicativo está criando e executando tarefas relacionadas.
  • bem-sucedido – o build foi concluído com êxito.
  • falha – o build foi concluído, mas falhou. Você pode baixar e inspecionar o log de build para solução de problemas.
  • cancelado – o build foi cancelado pela ação do usuário ou atingiu o tempo limite.

4.1. Logs de build

Para obter um build concluído (com êxito ou falha), baixe os logs para entender mais sobre como o build foi. O App Center fornece um arquivo morto com os seguintes arquivos:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1>
    |-- <build-step-2>
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Os logs específicos da etapa de build (localizados no diretório build/do arquivo morto) são úteis para solucionar problemas e entender em qual etapa e por que o build falhou.

4.2. O pacote do aplicativo (APK)

O APK é um pacote que contém o aplicativo e os ativos do Android. Se o build estiver assinado corretamente, o APK poderá ser instalado em um dispositivo real e implantado na Play Store. Se o build não tiver sido assinado, o APK poderá ser executado em um emulador ou usado para outras finalidades.

4.3. Criando várias APKs

Se a configuração do aplicativo criar várias APKs, você também precisará criar um APK universal. Nosso sistema de build funciona com uma main arquivo APK e ignorará todas as APKs específicas para uma determinada ABI de CPU ou densidade de tela. Para saber mais sobre divisões de APK e criação de um APK universal, leia o guia de divisão da ABI.

4.4. O arquivo de mapeamento de desobfuscação (mapping.txt)

O mapping.txt arquivo contém informações sobre como mapear rastreamentos de pilha ofuscados para o aplicativo de volta para a classe original e os nomes de método.

  • Se você já integrou o SDK do App Center em seu aplicativo com o módulo de relatório de falhas habilitado e usa o Proguard ou R8 para minificar e ofuscar o binário do aplicativo, o serviço de relatório de falhas requer esse mapping.txt arquivo para que um build exiba relatórios de falha legíveis por humanos (desobfuscados).
  • Se você já integrou outro SDK para fins de relatório de falhas em seu aplicativo (por exemplo, SDK do HockeyApp), o serviço correspondente exigirá que o mapping.txt arquivo exiba relatórios de falha legíveis.

5. Versões e requisitos com suporte

A versão mínima com suporte para compilar aplicativos Android é 7.0 (nível de API 24). Os aplicativos Android podem ter um nível mínimo de API mais baixo necessário para execução, mas devem ter como destino pelo menos o nível de API 24.

Os aplicativos devem ser compilados com o Gradle e o plug-in do Android Gradle para serem configurados corretamente. Seu repositório precisa incluir um wrapper Gradle.

Consulte também: Informações do Cloud Build Machine