EasyLoggingSDK

A Swift logging SDK for iOS that wraps CocoaLumberjack and Swift-log behind a single, batteries-included API.

Features

• Unified Interface — one logger backed by industry-standard frameworks.
• Swift 6 & Concurrency-Safe — builds in the Swift 6 language mode with complete strict-concurrency checking; log delivery is FIFO-ordered through a serializing actor pipeline (await logger.flush() guarantees delivery).
• Zero-Setup Lifecycle — hooks into UIKit automatically; no AppDelegate code needed.
• SwiftUI Ready — .trackScreenTime(screenName:) view modifier and manual tracking helpers.
• Log Categories — tag messages with a subsystem ("auth", "networking", …) for filtering.
• Privacy Redaction — mark metadata values as .auto, .always, or .never redacted; sensitive data is replaced with <REDACTED> in production.
• Network Logging — opt-in URLProtocol interceptor logs every request's method, URL, status, and duration.
• Screen Time Tracking — automatic UIKit swizzling or manual SwiftUI tracking with slow-load warnings.
• In-App Log Viewer — searchable, filterable overlay for QA, fed from the in-memory since-launch buffer.
• Customisable Formats — template-based log formatting with %date, %level, %category, %message, and more.
• Async/Await — every public method has an async variant.

Installation

// Package.swift
dependencies: [
    .package(url: "https://github.com/repfly/EasyLoggingSDK", from: "2.0.0")
]

Or in Xcode: File → Add Package Dependency → paste the URL.

Quick Start

import EasyLoggingSDK

let logger = EasyLogger.shared
logger.info("App launched")
logger.debug("Cache hit", category: "storage")

Requirements

• iOS 15.0+ / macOS 12.0+
• Swift 6.0+ (builds in the Swift 6 language mode)
• Xcode 16.0+

Dependencies

• CocoaLumberjack (3.8.0+)
• Swift-log (1.4.0+)

Documentation

See the Getting Started guide for installation, configuration, and usage of every feature.

Contributing

Contributions welcome — see CONTRIBUTING.md.

License

MIT — see LICENSE.

Changelog

See CHANGELOG.md.