Compartilhar via


Solução de problemas do SDK do Unity

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.

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

  1. Verifique se você integrou os módulos do SDK corretamente.
  2. Certifique-se de que seu projeto inclua o objeto "App Center" com anexo AppCenterBehavior e que os segredos do app sejam adicionados aos campos correspondentes na janela do Inspetor. Certifique-se também de marcar as caixas "Usar {service}" para cada serviço do App Center que você pretende usar.
  3. Verifique se os logs indicam "SDK do App Center configurado com êxito" (no nível de log detalhado), depois, verifique se há 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 log 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. Certifique-se de que seu projeto inclua o objeto "App Center" com anexo AppCenterBehavior e que os segredos do app sejam adicionados aos campos correspondentes na janela do Inspetor. Certifique-se também de marcar as caixas "Usar {service}" para cada serviço do App Center que você pretende usar.
  3. Reinicie o aplicativo após uma falha. O App Center Crashes encaminhará o log de falhas somente após ser reiniciado. O SDK não salvará nenhum log de falhas se você anexou um depurador. Verifique se o depurador não está anexado quando você trava o aplicativo.
  4. Verifique se os logs indicam "SDK do App Center configurado com êxito" (no nível de log detalhado), depois, verifique se há 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 o erro, vá para a seção Fluxo de log no serviço de análise. Seus acidentes devem aparecer lá, assim que forem enviados.
  9. Verifique se o aplicativo realmente falhou e foi reiniciado: o Unity captura a maioria das exceções sem tratamento por padrão, o que significa que o aplicativo não sai e não é considerado uma falha. Se uma falha for detectada pelo Unity, ela será relatada como "Erro" pelo SDK.

Falha na compilação do projeto do Android

O módulo Distribuir versão 4.1.0 ou posterior tem uma nova tag de manifesto para dar suporte ao Android 11. Se você estiver usando o Unity da versão anterior 2019.4 , especifique explicitamente a versão do gradle para evitar o erro AAPT: error: unexpected element <queries> found in <manifest>.. Para evitar problemas com a criação do projeto, você precisa adicionar mainTemplate.gradle e launcherTemplate.gradle (esse arquivo deve ser adicionado somente se você usar arquivos do Unity 2019.4) para especificar explicitamente a versão de gradle. Abra Configurações do Projeto>Jogador>aba Android>Configurações de Publicação> e Build e selecione Custom Main Gradle Template e Custom Launcher Gradle Template. Depois de gerar arquivos, insira as seguintes linhas na parte superior dos arquivos:

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.4.3'
    }
}

allprojects {
   repositories {
      google()
      mavenCentral()
      flatDir {
        dirs 'libs'
      }
   }
}

Leia mais sobre o build para Android 11 com diretrizes do Unity .

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.