Outras APIs React Native

  • 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 a migração.

Saiba mais sobre linhas do tempo e alternativas de suporte.

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 no LogCat no Android. Use a setLogLevel API para habilitar o registro em log adicional durante a depuração. O nível padrão é LogLevel.ASSERT para o ambiente de App Store do iOS e builds de versão 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 para a inicialização do aplicativo, use as APIs nativas do SetLogLevel 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 SoLoader.init no onCreate retorno de chamada no 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 de 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 de 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 runtime

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 encaminhará 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 é persistente no armazenamento do dispositivo entre 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 pela preocupação do usuário, você pode não permitir 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 marcar 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é AppCenter ser iniciado na plataforma Android. Ele retornará o último valor definido usando setNetworkRequestsAllowed ou true se o valor não tiver sido alterado antes do AppCenter ser iniciado.

Alterar o estado do serviço em runtime

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 marcar se o App Center estiver habilitado ou não.

const enabled = await AppCenter.isEnabled();

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

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

AppCenter.getSdkVersion();