Solução de problemas do MAUI e Xamarin SDK

Coleta de logs detalhados

Para obter instruções sobre como ajustar o nível de log para VERBOSE, consulte a seção Outras APIs .
Você pode encontrar os logs detalhados na janela Debug>Windows>Output .

Problemas durante a configuração

1. Para um aplicativo Xamarin.Forms, verifique se os pacotes estão instalados em todos os projetos que fazem referência a quaisquer bibliotecas. Caso contrário, você verá erros.
2. Se você vir esse erro ao criar para o Xamarin.iOS: MTOUCH: Error MT3001: Could not AOT the assembly 'obj/**/Build/Microsoft.AppCenter.**.iOS.Bindings.dll' (MT3001) será necessário atualizar o componente Xamarin.iOS para a versão 10.4.0.128 ou posterior.
3. Se vir este erro ao compilar para o Xamarin.iOS: MTOUCH: Error MT5210: Native linking failed, undefined symbol: _OBJC_METACLASS_$_MS{SomeSdkClassName}. Please verify that all the necessary frameworks have been referenced and native libraries are properly linked in. (MT5210) ou um erro semelhante (código MT5211 com uma mensagem semelhante mencionando o App Center), certifique-se de chamar AppCenter.Start antes de usar as APIs de um serviço específico. Se você estiver ligando Start , mas tiver esse problema, precisará atualizar o componente Xamarin.iOS para a versão 10.4.0.128 ou mais recente.
4. 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.

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 Start() método. Você pode copiar o código exato Start() abrindo o aplicativo no portal e navegando até a página Introdução.

3. Se pretender ver os logs que são enviados para o back-end, altere o nível de log para Detalhado na sua aplicação e o SDK mostrará os logs na consola. Chame a API abaixo antes de iniciar o SDK.

   AppCenter.LogLevel = LogLevel.Verbose;
   

   Verifique se os logs dizem "SDK do App Center configurado com êxito" (no nível de log Info), depois confirme que vê os logs de solicitações HTTPS.

4. Certifique-se de que o dispositivo está online.

5. Às vezes, os logs podem demorar 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 App Secret correto está incluído junto com a chamada do Start() método. Você pode copiar o código exato Start() 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 ele for reiniciado. Além disso, no Xamarin.iOS e no Xamarin.Mac, o SDK não registará nenhum log de falhas se anexar um depurador. Verifique se o depurador não está conectado quando você trava o aplicativo iOS. No Xamarin.Android, você pode falhar ao ter o depurador anexado, mas precisa continuar a execução depois de invadir a exceção não tratada.

4. Se pretender ver os logs que são enviados para o back-end, altere o nível de log para Detalhado na sua aplicação e o SDK mostrará os logs na consola. Chame a API abaixo antes de iniciar o SDK.

   AppCenter.LogLevel = LogLevel.Verbose;
   

   Verifique se os logs dizem "SDK do App Center configurado com êxito" (no nível de log Info), depois confirme que vê os logs de solicitações HTTPS.

5. Não use nenhuma outra biblioteca que forneça a funcionalidade de Relatório de Falhas, como o Xamarin Insights ou o HockeyApp. Você só pode ter um SDK de relatório de falhas integrado.

6. Certifique-se de que o dispositivo está online.

7. Às vezes, os logs podem demorar 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 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.

As atualizações distribuídas e no aplicativo estão bloqueando meus testes automatizados de interface do usuário

Se você estiver executando testes automatizados de interface do usuário, as atualizações no aplicativo habilitadas bloquearão seus testes automatizados de interface do usuário, pois eles tentarão se autenticar no back-end do App Center. Recomendamos não habilitar o App Center Distribute para seus testes de interface do usuário.

Google Play rejeita o aplicativo depois de adicionar DistributePlay

O Google Play rejeita aplicativos que usam o Distribute módulo porque ele contém implementação de atualização no aplicativo. Para evitar essa situação, o SDK do App Center tem DistributePlay módulo, que contém stubs para o módulo principal. Ele substitui a montagem principal pela montagem stubbed, que imita a Distribute API. Nenhuma alteração adicional é necessária no aplicativo cliente. O DistributePlay não tem nenhum código relacionado à atualização no aplicativo. Se depois de substituir Distribute o módulo pelo DistributePlay seu aplicativo ainda for rejeitado, siga as etapas abaixo para verificar se o Distribute módulo foi substituído corretamente:

• Certifique-se de que substituiu Distribute por DistributePlay em todas as suas versões para todos os seus grupos de publicação no Google Play Console.
• Se utilizar Xamarin.Forms, certifique-se de adicionar o módulo DistributePlay aos projetos Xamarin.Android e compartilhados.
• Verifique se o arquivo de saída não contém o Microsoft.AppCenter.Distribute.Android.Bindings.dll assembly. Você pode usar o APK Analyzer para verificá-lo.

Mensagens no console que indicam que o banco de dados não pôde ser aberto no iOS

O App Center usa o SQLite para persistir os logs antes que eles sejam enviados para o back-end. Se você estiver agrupando seu aplicativo com sua própria biblioteca SQLite em vez de usar a fornecida pelo sistema operacional, poderá ver erros como este no console [AppCenter] ERROR: -[MSACDBStorage executeSelectionQuery:]/147 Failed to open database e não verá nenhuma análise ou informações de falha no back-end. Atualize o SDK para a versão 0.16.0 ou posterior.

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.