Partilhar via

Outras APIs nativas do React

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.

Ajustar o nível de log

Você pode controlar a quantidade de mensagens de log que aparecem no App Center. As mensagens de log são exibidas no console no iOS e no LogCat no Android. Use a setLogLevel API para ativar o registo adicional durante a depuração. O nível padrão é LogLevel.ASSERT para o ambiente do iOS App Store e para as compilações de versão do Android. Caso contrário, é definido como LogLevel.WARNING.

Para gerar todas as mensagens de log, use LogLevel.VERBOSE.

import AppCenter from 'appcenter';

await AppCenter.setLogLevel(AppCenter.LogLevel.VERBOSE);

Observação

A API JavaScript setLogLevel não pode aumentar o registro em log do código de inicialização do aplicativo antes que o JavaScript seja carregado.

Se deseja aumentar o registo em log para a inicialização da aplicação, utilize as APIs nativas App Center setLogLevel.

No iOS, chame [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; antes de qualquer chamada a [AppCenterReactNative register]; (ou AppCenterReactNativeAnalytics ou AppCenterReactNativeCrashes ou AppCenterReactNativePush) no AppDelegate.m do projeto. Você deve adicionar @import AppCenter; caso esteja faltando nesse arquivo.

No caso do Android, chame AppCenter.setLogLevel(android.util.Log.VERBOSE); antes de SoLoader.init no callback de onCreate em MainApplication.java.

Identificar instalações

O SDK do App Center cria um UUID para cada dispositivo depois que o aplicativo é instalado. Esse identificador permanece o mesmo para um dispositivo quando o aplicativo é atualizado e um novo é gerado somente quando o aplicativo é reinstalado ou o usuário exclui manualmente todos os dados do aplicativo no Android. A API a seguir é útil para fins de depuração.

import AppCenter from 'appcenter';

const installId = await AppCenter.getInstallId();   // Returned as a string

Identificar usuários

O SDK do App Center suporta a definição de um ID de usuário que é usado para aumentar os relatórios de falhas. Para usar esse recurso:

  1. Configure o SDK do App Center conforme descrito no Guia de introdução do SDK do App Center.
  2. Defina um userID no SDK usando o seguinte código:
AppCenter.setUserId("your-user-id");

Depois de definir um ID de usuário, você pode usar o recurso de pesquisa do App Center para procurar relatórios de falhas específicos para o ID. Saiba mais na documentação de pesquisa do App Center.

Observação

O valor para o ID do usuário é limitado a 256 caracteres. Ele será mostrado com seus relatórios de falhas, mas não será usado para agregação ou contagens de usuários afetados. No caso de definir o ID de utilizador várias vezes, apenas o último ID de utilizador será utilizado. Você mesmo precisa definir o ID do usuário antes de cada inicialização do aplicativo, porque esse valor não é armazenado pelo SDK entre as iniciações.

Desativar todos os serviços em tempo de execução

Se quiser desativar todos os serviços do App Center de uma só vez, use a setEnabled() API. Quando desativado, o SDK não encaminhará nenhuma informação para o App Center.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

Para habilitar todos os serviços novamente, use a mesma API, mas passe true como parâmetro.

await AppCenter.setEnabled(true);

O estado é persistido no armazenamento do dispositivo em todas as inicializações de aplicativos.

Não permitir solicitações de rede

No SDK do App Center, as solicitações de rede são permitidas por padrão. Se você quiser enviar dados que o SDK do App Center coleta quando solicitado pelo usuário, pode desativar o envio automático de dados.

await AppCenter.setNetworkRequestsAllowed(false);

Nesse caso, o SDK do App Center continua a coletar dados, mas eles serão enviados somente quando as solicitações de rede forem permitidas.

await AppCenter.setNetworkRequestsAllowed(true);

Observação

Esse valor é retido entre as partidas.

A qualquer momento, você pode verificar se o envio de dados no SDK do App Center é permitido ou não.

await AppCenter.isNetworkRequestsAllowed();

Observação

O valor salvo em SharedPreferences é ignorado até que AppCenter seja iniciado na plataforma Android. Ele retornará o último valor definido usando setNetworkRequestsAllowed ou true se o valor não foi alterado antes do início do AppCenter.

Alterar o estado do serviço em tempo de execução

Você pode habilitar ou desabilitar o serviço no tempo de execução com o seguinte código:

await AppCenter.Analytics.setEnabled(false);

Verifique se o App Center está ativado

Você também pode verificar se o App Center está habilitado ou não.

const enabled = await AppCenter.isEnabled();

Verifique a versão do SDK do App Center em tempo de execução

Você pode obter a versão do SDK do App Center que está usando no momento.

AppCenter.getSdkVersion();
  • Last updated on