Configure SDK logging

try mobileCredentialHolder.initialize(
    loggerConfiguration: LoggerConfiguration( 
        logLevel: .Info, 
        callbackLogLevel: .Warning 
    ) 
)

• logLevel: Sets the minimum level for writing log entries to the log file. Defaults to .Off.
• callbackLogLevel: Sets the minimum level for invoking the callback closure. Defaults to .Off.

Refer to the LoggerConfiguration reference documentation for additional details.

mobileCredentialHolder.initialize(
    loggerConfiguration = Logger.LoggerConfiguration(
        logLevel = Logger.LogLevel.INFO,
        callbackLogLevel = Logger.LogLevel.WARN
    ),
    // ...
)

• logLevel: Sets the minimum level for writing log entries to the log file and Logcat. Defaults to Logger.LogLevel.OFF.
• callbackLogLevel: Sets the minimum level for invoking the callback function. Defaults to Logger.LogLevel.OFF.
• logDir: Optional. Specifies a local directory to store log files. If not provided, logs won't be stored to file.

Refer to the Logger.LoggerConfiguration reference documentation for additional details.

import { LogLevel } from "@mattrglobal/mobile-credential-holder-react-native"

const initializeResult = await mobileCredentialHolder.initialize({
    loggerConfiguration: { 
        logLevel: LogLevel.Info, 
        callbackLogLevel: LogLevel.Warn, 
    }, 
})
if (initializeResult.isErr()) {
    const { error } = initializeResult
    // handle error scenarios
    return
}

• logLevel: Sets the minimum level for writing log entries to the log file and console. Defaults to LogLevel.Off.
• callbackLogLevel: Sets the minimum level for invoking the callback function. Defaults to LogLevel.Off.
• logDir: Optional. Specifies a directory to store log files. On iOS, a default directory is used. On Android, logs won't be stored to file if not provided.

Refer to the LoggerConfiguration reference documentation for additional details.

try mobileCredentialHolder.initialize(
    loggerConfiguration: LoggerConfiguration(
        logLevel: .Info,
        callbackLogLevel: .Warning,
        callback: { logEvent in
            print("[\(logEvent.level)] \(logEvent.message)") 
        } 
    )
)

The callback receives a LogEvent object with the following properties:

• level: The LogLevel of the event.
• message: A string describing the log event.

mobileCredentialHolder.initialize(
    loggerConfiguration = Logger.LoggerConfiguration(
        logLevel = Logger.LogLevel.INFO,
        callbackLogLevel = Logger.LogLevel.WARN,
        callback = { priority, tag, message, throwable ->
            Log.d("HolderSDK", "[$tag] $message") 
        } 
    ),
    // ...
)

The callback function receives the following parameters:

• priority: An integer representing the log priority level.
• tag: An optional string tag identifying the log source.
• message: A string describing the log event.
• throwable: An optional Throwable associated with the log event (for error-level logs).

import { LogLevel } from "@mattrglobal/mobile-credential-holder-react-native"

const initializeResult = await mobileCredentialHolder.initialize({
    loggerConfiguration: {
        logLevel: LogLevel.Info,
        callbackLogLevel: LogLevel.Warn,
        callback: (log) => { 
            console.log(`[${log.logLevel}] ${log.tag ?? ""}: ${log.message ?? ""}`) 
        }, 
    },
})
if (initializeResult.isErr()) {
    const { error } = initializeResult
    // handle error scenarios
    return
}

The callback receives a log object with the following properties:

• logLevel: The LogLevel of the event.
• message: An optional string describing the log event.
• tag: An optional string tag identifying the log source.

let logFilePath = mobileCredentialHolder.getCurrentLogFilePath()

// If using an app group (e.g. for app extensions):
let logFilePath = mobileCredentialHolder.getCurrentLogFilePath(appGroup: "group.com.yourcompany.app")

The getCurrentLogFilePath method returns the file path as a string, or nil if no log file is available.

• appGroup: Optional. Specify an application group to retrieve logs generated by the SDK in an app extension. If not provided, the SDK returns the log file from the default location.

To access the log contents, read the file at the returned path into Data, then decode that data into a [String], where each element represents a single log message.

val logFilePath = mobileCredentialHolder.getLog()

The getLog method returns the full path of the log file (with a .log extension), or null if no log file is available.

The file contains log entries from the previous two calendar days.

const logFilePath = await mobileCredentialHolder.getCurrentLogFilePath()

// If using an app group (iOS only):
const logFilePath = await mobileCredentialHolder.getCurrentLogFilePath({
    appGroup: "group.com.yourcompany.app",
})

The getCurrentLogFilePath method returns a Promise resolving to the log file path string, or null if no log file is available.

• appGroup: Optional (iOS only). Specify an application group to retrieve logs generated by the SDK in an app extension.