Solução de problemas do SDK do macOS

  • Artigo

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar migrar.

Saiba mais sobre linhas do tempo e alternativas de suporte.

Problemas durante a instalação

  1. No console, procure um log 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 o Cocoapods para integrar o App Center em seu aplicativo macOS e encontrar um erro com a mensagem , CocoaPods - Unable to find a specification for AppCenterexecute pod repo update para atualizar o repositório cocoapods local e, em seguida, execute pod install novamente.
  3. Se você estiver integrando os binários do SDK manualmente, verifique se os módulos estão habilitados para o projeto.

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

  1. Verifique se você integrou os módulos do SDK corretamente.

  2. Verifique se o Segredo do Aplicativo correto está incluído junto com a chamada de start:withServices: método. Você pode copiar o código exato start:withServices:abrindo o aplicativo no portal e navegando até Introdução página.

  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

    Verifique se "SDK do App Center configurado com êxito" aparece nos logs (no nível do log INFO) e, em seguida, marcar se você vir 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 Funcionalidades 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 marcar 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 depois 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 do aplicativo correto está incluído junto com a chamada de start:withServices: método. Você pode copiar o código exato start:withServices: abrindo o aplicativo no portal e navegando até Introdução página.

  3. Reinicie o aplicativo após uma falha. As falhas do App Center encaminharão o log de falhas somente depois que o aplicativo for reiniciado. Além disso, o SDK não encaminhará nenhum log de falha se você estiver anexado ao depurador. Verifique se o depurador não está anexado quando você falha no 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

    Verifique se "SDK do App Center configurado com êxito" aparece nos logs (no nível do log INFO) e, em seguida, marcar se você vir logs de solicitação HTTPS.

  5. Não use nenhuma outra biblioteca que forneça funcionalidade de Relatório de Falhas. Você só pode ter um SDK de relatório de falhas 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 Funcionalidades 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 marcar se o SDK detectou a falha na próxima inicialização do aplicativo, chame a API para marcar 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 marcar se o back-end do App Center recebeu a falha, vá para a seção Fluxo de log no serviço 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 não pode ser usado para recuperar ou editar dados existentes. Se o app_secret estiver exposto, o maior risco será enviar dados inválidos para seu aplicativo, mas não terá efeito sobre a 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.