Logging para Swift: biblioteca SwiftyBeaver

O que é SwiftyBeaver e para que serve?

SwiftyBeaver é uma biblioteca de logging poderosa e flexível para aplicações em Swift (iOS, macOS, tvOS, watchOS). Ao contrário do print() padrão, que é não estruturado e inconveniente para análise, o SwiftyBeaver fornece saída colorida no console, gravação em arquivos, sincronização em nuvem e integração com serviços populares de análise. O objetivo principal é tornar a depuração e o monitoramento de aplicações o mais transparentes e eficientes possível.

Como instalar

A instalação via Swift Package Manager (SPM) é a maneira mais simples:

1. No Xcode, selecione File → Add Packages.
2. Insira a URL: https://github.com/SwiftyBeaver/SwiftyBeaver.git.
3. Escolha a versão (recomenda-se a última estável).
4. Adicione o pacote ao seu target.

A instalação também está disponível via CocoaPods ou Carthage.

Funcionalidades principais

• Saída colorida no console — diferentes níveis de logging (debug, info, warning, error) são destacados com cores para filtragem visual rápida.
• Gravação em arquivos — salvamento automático de logs no dispositivo com rotação por tamanho/data.
• Logging em nuvem — envio de logs para o servidor SwiftyBeaver Cloud para monitoramento remoto.
• Formatação — configuração de data, hora, nome do arquivo, linha de código.
• Filtragem — ativação/desativação de logs por nível mínimo ou por nome do módulo.

Exemplo de código em Swift

import SwiftyBeaver

let log = SwiftyBeaver.self

// Configuraçãolet console = ConsoleDestination()  // saída no consolelet file = FileDestination()        // gravação em arquivo

// Configuração do formatoconsole.format = "$DHH:mm:ss$d $L: $M"file.format = "$DHH:mm:ss$d $L: $M"

// Adicionando destinationslog.addDestination(console)log.addDestination(file)

// Usolog.debug("Aplicação iniciada")      // mensagem de depuraçãolog.info("Usuário autenticado")      // informativalog.warning("Bateria baixa")         // avisolog.error("Erro de rede")            // erro

Quando usar

SwiftyBeaver é ideal para projetos de qualquer tamanho — desde pequenas aplicações até soluções enterprise. É especialmente útil ao:

• Depurar processos de negócio complexos.
• Monitorar versões de produção através da plataforma em nuvem.
• Desenvolvimento em equipe, onde é necessário armazenamento centralizado de logs.
• Criar relatórios personalizados de erros.

A biblioteca é ativamente mantida, possui código aberto e uma grande comunidade. Se você precisar de mais de 10.000 linhas de logs por dia — considere o plano pago SwiftyBeaver Cloud.