Registro - Flutter SDK
Nesta página
Você pode definir ou alterar o nível de registro do seu aplicativo ao desenvolver ou depurar seu aplicativo. Talvez você queira alterar o nível de registro para registrar diferentes quantidades de dados, dependendo de suas necessidades de desenvolvimento. Você pode especificar diferentes níveis de registro ou registradores personalizados por isolamento.
Dica
Veja também:
Esta página mostra como definir um registrador do Realm, que foi adicionado no Realm Flutter SDK v1.1.0. Isso substitui a configuração do nível de registro do cliente de sincronização em versões anteriores do Realm Flutter SDK. Para obter informações sobre como definir o nível de registro do cliente Sync em uma versão anterior, consulte Definir o nível de registro do cliente - Flutter SDK.
Definir ou alterar o nível de registro do domínio
Você pode definir o nível de detalhes relatado pelo Realm Flutter SDK por isolamento. Para configurar o nível de registro, defina a propriedade estática Realm.logger.level a uma das constantes fornecidas por RealmLogLevel.
Realm.logger.level = RealmLogLevel.trace;
Você pode definir diferentes níveis de registro para diferentes isolamentos ou alterar o nível de registro para aumentar ou diminuir a verbosidade em diferentes pontos do seu código. Esse comportamento difere do nível de registro do cliente de sincronização obsoleto, que tinha que ser definido antes de abrir um Realm sincronizado e não pode ser alterado.
// Set a default log level that's not too verbose Realm.logger.level = RealmLogLevel.info; executeAppCode(); // Later, change the log level to debug an issue when running specific code Realm.logger.level = RealmLogLevel.trace; executeComplexCodeToDebug();
Personalizar o registrador
O SDK do Realm Flutter pode usar um registrador personalizado que esteja em conformidade com a classe Dart Logger.
Para definir um logger personalizado, crie um Logger
e defina-o usando o Realm.logger propriedade estática do primeiro isolamento:
Realm.logger = Logger.detached("custom logger");
Isso define o registrador para registro do Realm neste isolado. Se você não fornecer um registrador, o isolado obterá uma instância de registrador por padrão. Você pode anexar para ouvir o registrador padrão usando Realm.logger.onRecord.listen
:
Realm.logger.onRecord.listen((event) { // Do something with the log event - for example, print to console print("Realm log message: '$event'"); });
Somente o primeiro isolado que está usando o Realm imprime as mensagens de registro. Quaisquer novos isolados gerados que funcionem com o Realm obtêm uma nova instância Realm.logger
, mas não print
por padrão.
O nível de log padrão é RealmLogLevel.info. Você pode alterar o nível de registro por isolamento.
Desativar registro
Você pode desativar o registro definindo o nível de registro como RealmLogLevel.off
:
Realm.logger.level = RealmLogLevel.off;
Ou você pode limpar todos os ouvintes Realm.logger
:
Realm.logger.clearListeners();
Se você desativar o registro a partir do primeiro isolamento, isso interromperá o registrador de impressão padrão.