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 cronogramas e alternativas de suporte.

Para criar seu primeiro aplicativo Android, siga estas etapas:

  1. Conecte-se à sua conta de serviço de repositório (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Selecione um repositório e uma ramificação em que seu aplicativo reside.
  3. Escolha o projeto Android que você quer 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 recente desligamento do JCenter, determinados aplicativos podem apresentar falhas na 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 de jcenter() podem ser removidas do build.gradle arquivo e substituídas por jcenter { url "http://jcenter.bintray.com/"}. Leia mais sobre o desligamento do JCenter aqui.

1. Vinculando seu repositório

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

2. Selecionando uma filial

Depois de selecionar um repositório, selecione o branch que deseja criar. Por padrão, todas as ramificações ativas serão listadas.

3. Configurando sua primeira compilação

Antes da primeira compilação, o projeto Android precisa ser configurado.

3.1. Gatilhos de compilação

Por padrão, um novo build é disparado sempre que um desenvolvedor envia por push para um branch configurado. Isso é chamado de "Integração Contínua". Se preferir disparar uma nova compilação manualmente, você pode alterar essa configuração no painel de configuração.

3.2. Variante de compilação

As variantes de build disponíveis serão preenchidas a partir dos tipos de build e das variações 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 uma das Variações de Produto declaradas 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 Android App Bundle é um formato de distribuição enviado para a Play Store e usado para gerar APKs otimizados para dispositivos específicos. Você pode descobrir mais sobre o Android App Bundle na documentação oficial do Android.

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

3.4. Incrementar o número da versão

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

3.5. Assinatura de código

Uma compilação bem-sucedida produzirá um .apk arquivo e um arquivo adicional .aab , se ativado. 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 as compilações produzidas a partir de uma ramificação, ative a assinatura de código no painel de configuração, faça upload do armazenamento de chaves para o repositório e forneça as credenciais relevantes no painel de configuração. Você pode ler mais sobre 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 app é iniciado em um dispositivo real. Isso adiciona aproximadamente mais 10 minutos ao tempo total de compilação. Leia mais sobre como configurar testes de inicialização.

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

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

3.8. Distribuir a compilação

Você pode configurar cada build bem-sucedido de uma ramificação para ser distribuído para um grupo de distribuição criado anteriormente ou um destino de armazenamento. Você pode adicionar um novo grupo de distribuição ou configurar uma conexão de armazenamento de dentro do serviço Distribuir. Sempre há 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 Android App Bundle (.aab) é preferível e será distribuído se ativado. Para grupos de distribuição do App Center e destinos de repositório do Intune, um regular .apk será usado mesmo que um .aab também seja gerado.

4. Crie resultados

Depois que uma compilação é disparada, ela pode estar nestes estados:

  • enfileirado - o build está em uma fila aguardando a liberação de recursos.
  • Construindo - O aplicativo está criando e executando tarefas relacionadas.
  • succeeded - a compilação foi concluída com êxito.
  • Falha - a compilação foi concluída, mas falhou. Você pode baixar e inspecionar o log de compilação para solução de problemas.
  • Cancelado - A compilação foi cancelada pela ação do usuário ou atingiu o tempo limite.

4.1. Logs de build

Para uma compilação concluída (bem-sucedida ou com falha), baixe os logs para entender mais sobre como foi a compilação. 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 compilação (localizados no diretório build/ do arquivo) são úteis para solucionar problemas e entender em qual etapa e por que a compilação falhou.

4.2. O pacote do aplicativo (APK)

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

4.3. Como criar vários APKs

Se a configuração do app criar vários APKs, você também precisará criar um APK universal. Nosso sistema de compilação funciona com um arquivo APK principal e ignora todos os APKs específicos de uma determinada ABI da CPU ou densidade de tela. Para saber mais sobre as divisões de APK e a criação de um APK universal, leia o guia de divisão da ABI.

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

O mapping.txt arquivo contém informações sobre como mapear rastreamentos de pilha ofuscados para o aplicativo de volta para os nomes originais de classe e 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 o R8 para reduzir e ofuscar o binário do aplicativo, o serviço de relatório de falhas exigirá esse mapping.txt arquivo para um build para exibir relatórios de falhas legíveis por humanos (desofuscados).
  • 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 falhas legíveis.

5. Versões e requisitos suportados

A versão mínima compatível com a criação de apps Android é a 7.0 (API de nível 24). Os apps Android podem ter um nível mínimo de API mais baixo necessário para serem executados, mas precisam ter como destino pelo menos o nível 24.

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

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