SDLLogConfiguration Class Reference

modules

Any custom logging modules used by the developer’s code. Defaults to none.

Objective-C

@property (nonatomic, copy) NSSet<SDLLogFileModule *> *_Nonnull modules;

Swift

var modules: Set<AnyHashable> { get set }

targets

Where the logs will attempt to output. Defaults to Console.

Objective-C

@property (nonatomic, copy) NSSet<id<SDLLogTarget>> *_Nonnull targets;

Swift

var targets: Set<AnyHashable> { get set }

filters

What log filters will run over this session. Defaults to none.

Objective-C

@property (nonatomic, copy) NSSet<SDLLogFilter *> *_Nonnull filters;

Swift

var filters: Set<SDLLogFilter> { get set }

formatType

How detailed of logs will be output. Defaults to Default.

Objective-C

@property (nonatomic) SDLLogFormatType formatType;

Swift

var formatType: SDLLogFormatType { get set }

asynchronous

Whether or not logs will be run on a separate queue, asynchronously, allowing the following code to run before the log completes. Or if it will occur synchronously, which will prevent logs from being missed, but will slow down surrounding code. Defaults to YES.

Objective-C

@property (nonatomic, assign, unsafe_unretained, readwrite,
          getter=isAsynchronous) BOOL asynchronous;

Swift

var isAsynchronous: Bool { get set }

errorsAsynchronous

Whether or not error logs will be dispatched to loggers asynchronously. Defaults to NO.

Objective-C

@property (nonatomic, assign, unsafe_unretained, readwrite,
          getter=areErrorsAsynchronous) BOOL errorsAsynchronous;

Swift

var areErrorsAsynchronous: Bool { get set }

disableAssertions

Whether or not assert logs will fire assertions in DEBUG mode. Assertions are always disabled in RELEASE builds. If assertions are disabled, only an error log will fire instead. Defaults to NO.

Objective-C

@property (nonatomic, assign, unsafe_unretained, readwrite,
          getter=areAssertionsDisabled) BOOL disableAssertions;

Swift

var areAssertionsDisabled: Bool { get set }

globalLogLevel

Any modules that do not have an explicitly specified level will by default use the global log level. Defaults to Error. Do not specify Default for this parameter.

Objective-C

@property (nonatomic) SDLLogLevel globalLogLevel;

Swift

var globalLogLevel: SDLLogLevel { get set }

+defaultConfiguration

A default logger for production. This sets the format type to Default, the log level to Error, and the target to SDLLogTargetOSLog.

Objective-C

+ (nonnull instancetype)defaultConfiguration;

Swift

class func `default`() -> Self

+debugConfiguration

A debug logger for use in development. This sets the format type to Detailed, the log level to Debug, and enables the Console and ASL loggers.

Objective-C

+ (nonnull instancetype)debugConfiguration;

Swift

class func debug() -> Self