Способы вывода

Выберите минимальный уровень сообщений и единственное место вывода для стандартного журнала AIBuds.

API Reference

Framework

AIBudsLog.xcframework

Declaration

Swift

Swift

/// The current log configuration.
static var logConfiguration: LogConfiguration { get }

/// Configures log storage, rotation, and output behavior.
final class LogConfiguration: NSObject {
    /// The severity threshold. Defaults to `.info`.
    var level: LogLevel

    /// The active output destination. Defaults to `.xlfacility`.
    var destination: LogDestination

    /// Relative log directory under Documents. Defaults to `.aibuds/logs`.
    var logsDirectory: String

    /// Maximum single file size. Defaults to 10 MB.
    var maxFileSize: UInt64

    /// Maximum retained age in days. Defaults to 3.
    var logFileMaxAge: Int
}

Objective-C

Objective-C

/// The current log configuration.
@property(nonatomic, class, readonly, strong) AIBudsLogConfiguration *logConfiguration;

/// Configures log storage, rotation, and output behavior.
@interface AIBudsLogConfiguration : NSObject
/// The severity threshold. Defaults to `AIBudsLogLevelInfo`.
@property(nonatomic) AIBudsLogLevel level;

/// The active output destination. Defaults to XLFacility.
@property(nonatomic) AIBudsLogDestination destination;

/// Relative log directory under Documents. Defaults to `.aibuds/logs`.
@property(nonatomic, copy) NSString *logsDirectory;

/// Maximum single file size. Defaults to 10 MB.
@property(nonatomic) uint64_t maxFileSize;

/// Maximum retained age in days. Defaults to 3.
@property(nonatomic) NSInteger logFileMaxAge;
@end

См. logConfiguration, LogLevel и LogDestination.

Уровни журналирования

level задаёт минимальную записываемую важность. Сообщения более низких уровней отбрасываются.

Уровень	Назначение
.verbose	Подробная трассировка выполнения.
.debug	Диагностика во время разработки.
.info	Обычный ход работы и служебная информация.
.warn	Состояние, которое может потребовать внимания.
.error	Ошибка, после которой приложение может продолжить работу.
.fatal	Критическая ошибка, способная завершить приложение.
.mute	Полностью отключить вывод журналов.

Места вывода

Место	Вывод	Экспорт
.console	Консоль отладчика Xcode	Нет
.oslogger	Единая система журналирования Apple через os_log	Нет
.file	Файлы в настроенном каталоге относительно Documents	Да
.xlfacility	Плагин хранения AIBudsXLFacility	Да, если плагин установлен

Примеры использования

Swift

Swift

import AIBudsLog
import AIBudsXLFacility

let configuration = AIBudsLogSDK.logConfiguration
configuration.level = .debug
configuration.destination = .xlfacility
configuration.logFileMaxAge = 7

AIBudsLogSDK.setXLFacilityPlugin(XLFacilitySDK.shared)

AIBudsLogSDK.logService.info(
    "SDK configured",
    subsystem: "com.example.app",
    category: "startup"
)

Objective-C

Objective-C

#import <AIBudsLog/AIBudsLog-Swift.h>
#import <AIBudsXLFacility/AIBudsXLFacility-Swift.h>

AIBudsLogConfiguration *configuration = AIBudsLogSDK.logConfiguration;
configuration.level = AIBudsLogLevelDebug;
configuration.destination = AIBudsLogDestinationXlfacility;
configuration.logFileMaxAge = 7;

[AIBudsLogSDK setXLFacilityPlugin:AIBudsXLFacilitySDK.shared];

[AIBudsLogSDK.logService info:@"SDK configured" subsystem:@"com.example.app" category:@"startup"];

Примечания

• Место вывода задаётся для всего процесса и заменяет предыдущее; это не набор одновременно активных выходов.
• logsDirectory принимает путь относительно Documents. SDK удаляет начальный символ косой черты.
• Значения maxFileSize и logFileMaxAge, меньшие либо равные нулю, игнорируются.
• Публичный SDK не предоставляет настройку удалённого сервера журналов и переключатели категорий.