Solução de problemas do SDK do macOS

Problemas durante a configuração

1. No console, procure um log de assert com a mensagem - "App Center SDK configurado com êxito". Isso verifica se o SDK está configurado com êxito.
2. Se você estiver usando o Cocoapods para integrar o App Center ao 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 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 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 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 "App Center SDK configurado com êxito" aparece nos logs (no nível de log INFO ) e, em seguida, verifique se você vê logs de solicitação HTTPS.

4. Certifique-se de que o seu dispositivo está online e que a aplicação tem acesso à Internet.

   Observação

   Se o seu aplicativo estiver usando a Área Restrita do Aplicativo, você deverá definir a capacidade para permitir conexões de entrada (Servidor) e de saída (Cliente) para permitir que o aplicativo tenha acesso à Internet. O Xcode 9 habilita o App Sandbox 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 seu 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 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 segredo correto da aplicação está incluído juntamente 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. O App Center Crashes encaminhará o registro de falhas somente depois que o aplicativo for reiniciado. Além disso, o SDK não encaminhará nenhum log de falhas se você estiver conectado ao depurador. Certifique-se de que o depurador não está ligado quando se fizer crash a aplicação.

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 "App Center SDK configurado com êxito" aparece nos logs (no nível de log INFO ) e, em seguida, verifique se você vê logs de solicitação HTTPS.

5. Não use outras bibliotecas que forneçam a funcionalidade Relatório de falhas. Você só pode ter um SDK de relatório de falhas integrado ao seu aplicativo.

6. Certifique-se de que o seu dispositivo está online e que a aplicação tem acesso à Internet.

   Observação

   Se o seu aplicativo estiver usando a Área Restrita do Aplicativo, você deverá definir a capacidade para permitir conexões de entrada (Servidor) e de saída (Cliente) para permitir que o aplicativo tenha acesso à Internet. O Xcode 9 habilita o App Sandbox 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 seu aplicativo estiver usando a área restrita, habilite as conexões de entrada e saída.

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

8. 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 didSucceedSendingErrorReport para ver se ele foi enviado com êxito para o servidor.

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

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.