Partilhar via


Solução de problemas do SDK Unity

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.

Os dados do Google Analytics não aparecem no portal

  1. Certifique-se de ter integrado os módulos do SDK corretamente.
  2. Verifique se o projeto está incluído no objeto "App Center" anexado AppCenterBehavior e se os segredos do aplicativo são adicionados aos campos correspondentes na janela do Inspetor. Certifique-se também de marcar as caixas "Usar {serviço}" para cada serviço do App Center que você pretende usar.
  3. Verifique que os logs digam "SDK do App Center configurado com êxito" (no nível de log Verbose) e, em seguida, verifique se consegue ver logs de solicitação HTTPS.
  4. Certifique-se de que o dispositivo está online.
  5. Às vezes, os logs podem levar 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. Verifique se o projeto está incluído no objeto "App Center" anexado AppCenterBehavior e se os segredos do aplicativo são adicionados aos campos correspondentes na janela do Inspetor. Certifique-se também de marcar as caixas "Usar {serviço}" 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 registro de falhas somente depois que ele for reiniciado. O SDK não salvará nenhum log de falhas se você anexar um depurador. Certifique-se de que o depurador não está ligado quando se fizer crash a aplicação.
  4. Verifique que os logs digam "SDK do App Center configurado com êxito" (no nível de log Verbose) e, em seguida, verifique se consegue ver logs de solicitação HTTPS.
  5. Certifique-se de que o dispositivo está online.
  6. Às vezes, os logs podem levar 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.
  9. Certifique-se de que o aplicativo realmente falhou e foi reiniciado: o Unity captura a maioria das exceções não tratadas por padrão, o que significa que o aplicativo não sai e não é considerado uma falha. Se uma falha for detetada pelo Unity, ela será relatada como "Erro" pelo SDK.

Falha na compilação do projeto Android

O módulo Distribute versão 4.1.0 ou posterior tem uma nova tag de manifesto para suportar o Android 11. Se você estiver usando Unity da versão anterior 2019.4 , você deve especificar explicitamente a versão gradle para evitar o erro AAPT: error: unexpected element <queries> found in <manifest>.. Para evitar problemas com a construção do seu projeto, você tem que adicionar mainTemplate.gradle e launcherTemplate.gradle (este arquivo deve ser adicionado apenas se você usar Unity 2019.4) arquivos para especificar explicitamente a versão gradle. Por favor, abra o Project Settings>Player>Android tab>Publishing Settings>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 guia de construção para Android 11 com Unity.

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.