Partilhar via


Solução de problemas do SDK do Android

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

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

Dependendo dos serviços que você usa, 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 seu aplicativo pelo SDK.

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

Os dados do Google Analytics não aparecem no portal

  1. Certifique-se de ter integrado os módulos do SDK corretamente.

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

  3. Se pretender ver os logs que são enviados para o back-end, altere o nível de log para Detalhado na sua aplicação e o SDK mostrará os logs na consola. 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 de log Info), depois confirme que vê os logs de solicitações HTTPS.

  4. Certifique-se de que o dispositivo está online.

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

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

As falhas não aparecem no portal

  1. Certifique-se de ter integrado os módulos do SDK corretamente.

  2. Certifique-se de que o App Secret correto está incluído junto com a chamada do start() método. 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 pretender ver os logs que são enviados para o back-end, altere o nível de log para Detalhado na sua aplicação e o SDK mostrará os logs na consola. 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 de log Info), depois confirme que vê os logs de solicitações HTTPS.

  5. Certifique-se de que o dispositivo está online.

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

  7. Se quiser verificar se o SDK detetou a falha no próximo início do aplicativo, você pode chamar a API para verificar se o aplicativo falhou na última sessão e mostra um alerta. Ou você pode estender o retorno de chamada de falha para ver se ele foi enviado com êxito para o servidor.

  8. Para verificar se o back-end do App Center recebeu a falha, vá para a seção Fluxo de log no serviço Analytics. Suas falhas de sistema devem aparecer lá, uma vez que o relatório tenha sido enviado.

As atualizações distribuídas 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 no aplicativo habilitadas bloquearão seus testes automatizados de interface do usuário, porque eles tentarão autenticar no back-end do App Center. Recomendamos não habilitar o App Center Distribute 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 seu aplicativo.

Para ilustrar isso, criamos um aplicativo java vazio usando o modelo "aplicativo em branco" do Android Studio. Nós construímos o aplicativo na configuração de lançamento e instalamos o aplicativo em um dispositivo com Android 7.0.

Os testes foram executados sem o Proguard ativado.

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

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

Proteger o valor secreto do App Center

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

Para recuperar dados confidenciais, você precisa 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 seu aplicativo usando uma variável de ambiente para injetar o segredo do aplicativo em seu código. Dessa forma, o segredo não fica visível no seu código.

Migração do jCenter para o Maven Central

Devido ao término do suporte do jCenter , todas as nossas montagens foram movidas para o repositório do Maven Central. Para usar o App Center, você precisa adicionar mavenCentral() ao repositório em seu arquivo Gradle como abaixo:

repositories {
   google()
   mavenCentral()
}