Compartilhar via


Solução de problemas do SDK do macOS

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.

Problemas durante a instalação

  1. No console, procure um log do Assert com a mensagem : "SDK do App Center configurado com êxito". Isso verifica se o SDK foi configurado com êxito.
  2. Se você estiver usando Cocoapods para integrar o App Center em seu aplicativo macOS e encontrar um erro com a mensagem - CocoaPods - Unable to find a specification for AppCenter, execute pod repo update para atualizar o repositório local do Cocoapods e então execute pod install novamente.
  3. Se você estiver integrando os binários do SDK manualmente, verifique se os módulos estão habilitados para seu projeto.

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 o Segredo do Aplicativo correto esteja incluído na chamada do método start:withServices:. Você pode copiar o código exato start:withServices:abrindo o aplicativo no portal e navegando até a página Introdução .

  3. Se você quiser ver os logs enviados para o back-end, altere o nível de log para Detalhado em seu aplicativo e o SDK imprimirá os logs no Console. Insira a seguinte chamada antes do início do SDK:

    [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
    
    AppCenter.logLevel = .verbose
    

    Certifique-se de que "SDK do App Center configurado com êxito" aparece nos logs (no nível de log INFO), então verifique se você observa os logs de solicitação HTTPS.

  4. Verifique se o dispositivo está online e se o aplicativo tem acesso à Internet.

    Observação

    Se o aplicativo estiver usando a Área Restrita do Aplicativo, você deverá definir a funcionalidade para permitir conexões de entrada (Servidor) e saída (Cliente) para permitir que o aplicativo tenha acesso à Internet. O Xcode 9 habilita a Área Restrita do Aplicativo por padrão, mas os recursos para conexões de entrada e saída precisam ser definidos explicitamente.

    Selecione seu projeto no navegador do projeto, selecione a guia Recursos e, se o aplicativo estiver usando a área restrita, adicione os recursos para conexões de entrada e saída.

  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 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 correto do aplicativo está incluído junto com a chamada de método start:withServices:. Você pode copiar o código exato start:withServices: abrindo o aplicativo no portal e navegando até a página Introdução .

  3. Reinicie o aplicativo após uma falha. App Center Crashes só irá encaminhar o log de falhas após o aplicativo ser reiniciado. Além disso, o SDK não encaminha nenhum log de falha se você estiver conectado ao depurador. Verifique se o depurador não está anexado quando você trava o aplicativo.

  4. Se você quiser ver os logs enviados para o back-end, altere o nível de log para Detalhado em seu aplicativo e o SDK imprimirá os logs no Console. Insira a seguinte chamada antes do início do SDK:

    [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
    
    AppCenter.logLevel = .verbose
    

    Certifique-se de que "SDK do App Center configurado com êxito" aparece nos logs (no nível de log INFO), então verifique se você observa os logs de solicitação HTTPS.

  5. Não use nenhuma outra biblioteca que forneça a funcionalidade de Relatório de Falhas. Você só pode ter um SDK de relatórios de falha integrado em seu aplicativo.

  6. Verifique se o dispositivo está online e se o aplicativo tem acesso à Internet.

    Observação

    Se o aplicativo estiver usando a Área Restrita do Aplicativo, você deverá definir a funcionalidade para permitir conexões de entrada (Servidor) e saída (Cliente) para permitir que o aplicativo tenha acesso à Internet. O Xcode 9 habilita a Área Restrita do Aplicativo por padrão, mas os recursos para conexões de entrada e saída precisam ser definidos explicitamente.

    Selecione seu projeto no navegador do projeto, selecione a guia Recursos e, se o aplicativo estiver usando a área restrita, habilite conexões de entrada e saída.

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

  8. 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 retorno de chamada de falha didSucceedSendingErrorReport para ver se ele foi enviado com êxito ao servidor.

  9. 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.

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.