आउटपुट के तरीके

Default AIBuds logger के लिए न्यूनतम log level और एक output destination चुनें।

API संदर्भ

Framework

AIBudsLog.xcframework

डिक्लेरेशन

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 record की जाने वाली न्यूनतम severity है। इससे नीचे के levels छोड़ दिए जाते हैं।

Level	उपयोग
.verbose	विस्तृत execution tracing।
.debug	Development diagnostics।
.info	सामान्य progress और operational information।
.warn	ऐसी स्थिति जिस पर ध्यान देना पड़ सकता है।
.error	ऐसी failure जिसके बाद app चल सकता है।
.fatal	गंभीर failure जो app बंद कर सकती है।
.mute	सभी log output बंद करें।

आउटपुट डेस्टिनेशन

डेस्टिनेशन	आउटपुट	एक्सपोर्ट सपोर्ट
.console	Xcode debugger console	नहीं
.oslogger	os_log के जरिए Apple unified logging	नहीं
.file	Configured Documents-relative directory की files	हाँ
.xlfacility	AIBudsXLFacility persistence plugin	हाँ, plugin installed होने पर

उपयोग के उदाहरण

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"];

ध्यान दें

• Destination selection पूरे process पर लागू होती है और पिछली destination बदल देती है; यह एक साथ enabled outputs का set नहीं है।
• logsDirectory Documents-relative path स्वीकार करता है। SDK शुरुआत का slash हटा देता है।
• maxFileSize और logFileMaxAge के लिए शून्य या उससे कम values ignore होती हैं।
• Public SDK remote-server logging configuration या category enable/disable switches उपलब्ध नहीं कराता।