Compartilhar via

Outras APIs nativas do React

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.

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 mostradas no console no iOS e logCat no Android. Utilize a API setLogLevel para ativar logs adicionais durante a depuração. O nível padrão é LogLevel.ASSERT para o ambiente da App Store do iOS e compilações de lançamento do Android. Caso contrário, ele será 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 para o código de inicialização do aplicativo, antes que o JavaScript seja carregado.

Se você quiser aumentar o registro em log da inicialização do aplicativo, use as APIs de setLogLevel nativas do App Center.

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

No Android, chame AppCenter.setLogLevel(android.util.Log.VERBOSE); antes de SoLoader.init no retorno de chamada onCreate dentro de MainApplication.java.

Identificar instalações

O SDK do App Center cria uma 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 dá suporte à configuração de uma ID de usuário usada para aumentar os relatórios de falha. Para usar essa funcionalidade:

  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 uma ID de usuário, você pode usar o recurso de pesquisa do App Center para pesquisar relatórios de falha específicos para a ID. Saiba mais na documentação de pesquisa do App Center.

Observação

O valor da ID do usuário é limitado a 256 caracteres. Ele será mostrado com seus relatórios de falha, mas não usado para agregação ou contagens de usuários afetados. Caso você defina a ID do usuário várias vezes, somente a última ID de usuário será usada. Você precisa definir a ID de usuário por conta própria antes da inicialização de cada aplicativo, pois esse valor não é armazenado pelo SDK entre inicializações.

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

Se você quiser desabilitar todos os serviços do App Center de uma só vez, use a setEnabled() API. Quando desabilitado, o SDK não encaminha nenhuma informação para o App Center.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

Para habilitar todos os serviços mais uma vez, use a mesma API, mas passe true como um parâmetro.

await AppCenter.setEnabled(true);

O estado é mantido no armazenamento do dispositivo entre as inicializações do aplicativo.

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 coletados pelo SDK do App Center por solicitação do usuário, você pode desativar o envio automático de dados.

await AppCenter.setNetworkRequestsAllowed(false);

Nesse caso, o SDK do App Center continua coletando dados, mas ele será enviado somente quando as solicitações de rede forem permitidas.

await AppCenter.setNetworkRequestsAllowed(true);

Observação

Esse valor é mantido 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 armazenado no SharedPreferences é desconsiderado até que AppCenter seja iniciado na plataforma Android. Ele retornará o último conjunto de valores usando setNetworkRequestsAllowed ou true se o valor não foi alterado antes de o AppCenter ser iniciado.

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

Você pode habilitar ou desabilitar o serviço no runtime com o seguinte código:

await AppCenter.Analytics.setEnabled(false);

Verificar se o App Center está habilitado

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

const enabled = await AppCenter.isEnabled();

Verificar a versão do SDK do App Center em runtime

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

AppCenter.getSdkVersion();
  • Last updated on