Compartilhar via


Solução de problemas do SDK do Android

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

Quais permissões do Android são necessárias?

Dependendo dos serviços usados, as seguintes permissões são necessárias:

  • Todos os serviços: INTERNET, ACCESS_NETWORK_STATE
  • Distribuir: REQUEST_INSTALL_PACKAGES, DOWNLOAD_WITHOUT_NOTIFICATION

As permissões necessárias são mescladas automaticamente no manifesto do aplicativo pelo SDK.

Nenhuma dessas permissões requer aprovação do usuário no runtime, todas elas são permissões de tempo de instalação.

Os dados de análise não aparecem no portal

  1. Verifique se você integrou os módulos do SDK corretamente.

  2. Verifique se o Segredo do Aplicativo correto está incluído junto com a chamada do método start(). Você pode copiar o código exato start() abrindo o aplicativo no portal e navegando até a página Introdução.

  3. Se você quiser ver os logs que são enviados para o back-end, altere o nível de log para Verbose em seu aplicativo e o SDK imprimirá logs no console. Chame a API abaixo antes de iniciar o SDK.

    AppCenter.setLogLevel(Log.VERBOSE);
    
    AppCenter.setLogLevel(Log.VERBOSE)
    

    Verifique se os logs dizem "SDK do App Center configurado com êxito" (no nível do log de informações) e verifique se você vê logs de solicitação HTTPS.

  4. Verifique se o dispositivo está online.

  5. Às vezes, os logs podem levar alguns minutos para serem exibidos no portal. Aguarde algum tempo se esse for o caso.

  6. Para verificar se o back-end do App Center recebeu seus dados, vá para a seção Fluxo de logs no serviço de análise. Seus eventos devem aparecer assim que forem enviados.

Falhas não aparecem no portal

  1. Verifique se você integrou os módulos do SDK corretamente.

  2. Verifique se o Segredo do Aplicativo correto está incluído junto com a chamada do método start(). Você pode copiar o código exato start() abrindo o aplicativo no portal e navegando até a página Introdução.

  3. Reinicie o aplicativo após uma falha. Nosso SDK encaminhará o log de falhas somente depois que ele for reiniciado.

  4. Se você quiser ver os logs que são enviados para o back-end, altere o nível de log para Verbose em seu aplicativo e o SDK imprimirá logs no console. Chame a API abaixo antes de iniciar o SDK.

    AppCenter.setLogLevel(Log.VERBOSE);
    
    AppCenter.setLogLevel(Log.VERBOSE)
    

    Verifique se os logs dizem "SDK do App Center configurado com êxito" (no nível do log de informações) e verifique se você vê logs de solicitação HTTPS.

  5. Verifique se o dispositivo está online.

  6. Às vezes, os logs podem levar alguns minutos para serem exibidos no portal. Aguarde algum tempo se esse for o caso.

  7. Se você quiser verificar se o SDK detectou a falha na próxima inicialização do aplicativo, você pode chamar a API para verificar se o aplicativo falhou na última sessão e mostrar um alerta. Ou você pode estender o callback de erro para verificar se foi enviado com êxito ao servidor.

  8. Para verificar se o back-end do App Center recebeu a falha, vá para a seção Fluxo de Logs no serviço de análise. Seus acidentes devem aparecer lá, assim que forem enviados.

As atualizações de distribuição e no aplicativo estão bloqueando meus testes automatizados de interface do usuário

Se você estiver executando testes automatizados de interface do usuário, as atualizações habilitadas no aplicativo bloquearão seus testes de interface do usuário automatizados, pois tentarão se autenticar no back-end do App Center. Recomendamos não habilitar a Distribuição do App Center para seus testes de interface do usuário.

Qual é o impacto do SDK do App Center no tamanho do meu aplicativo Android?

O SDK do App Center foi projetado para ter um impacto mínimo no tamanho da instalação do aplicativo.

Para ilustrar isso, criamos um aplicativo java vazio usando o modelo de "aplicativo em branco" do Android Studio. Criamos o aplicativo na configuração de versão e instalamos o aplicativo em um dispositivo que executa o Android 7.0.

Os testes foram executados sem o Proguard habilitado.

Os números abaixo podem variar e depender das configurações de build, portanto, considere-os um guia aproximado. O impacto do SDK em seu aplicativo será ainda menor se você usar o Proguard.

Módulos do App Center usados Tamanho do APK exportado Tamanho da instalação (conforme relatado pelo dispositivo)
Nenhum (aplicativo em branco) 1,3 MB 3,43 MB
Análise do App Center 1,4 MB 3,63 MB
Falha no App Center 1,4 MB 3,70 MB
Distribuição do App Center 1,4 MB 3,71 MB
Todos os módulos do App Center 1,4 MB 3,82 MB

Proteger o valor do segredo do App Center

O app_secret é um identificador do seu aplicativo, é necessário saber a qual aplicativo o tráfego se aplica e ele não pode ser usado para recuperar ou editar dados existentes. Se o seu app_secret estiver exposto, o maior risco é enviar dados incorretos para seu aplicativo, mas isso não terá impacto na segurança dos dados.

Para recuperar dados confidenciais, você precisaria fornecer um token de aplicativo/usuário, que é gerado no lado do cliente. Não há como tornar os dados do lado do cliente completamente seguros.

Você pode melhorar a segurança do aplicativo usando uma variável de ambiente para injetar o segredo do aplicativo em seu código. Dessa forma, o segredo não está visível em seu código.

Migração do jCenter para o Maven Central

Devido ao encerramento do suporte do jCenter , todos os nossos assemblies foram movidos para o repositório Maven Central. Para usar o App Center, você precisa adicionar mavenCentral() ao repositório em seu arquivo Gradle, como abaixo:

repositories {
   google()
   mavenCentral()
}