c8fbcfd322
* [ios, macos] Update the logging subsystem to platform agnostic. * [ios, macos] Add coordinate to string function. * [ios, macos] Add BOOL to string function. * [ios, macos] Add tracing logs. * [ios, macos] Add tracing logs to generated style classes. * [ios, macos] Split logging categories accordingly to MGLLoggingLevel. * [ios, macos] Log network requests. * [ios, macos] Migrate NSAssert to MGLAssert. * [ios, macos] Include MGLLoggingConfiguration to filesource-files.txt. * [ios, macos] Fix logger string specifier for the line parameter. * [ios, macos] Add logs to shapes classes. * [ios, macos] Add logs to offline classes. * [ios, macos] Add logs to annotation classes. * [ios, macos] Add logs to foundation classes. * [ios, macos] Fix snapshotter size logging. * [macos] Add logs to map view. * [ios, macos] Fix string from boolean prefix, add custom function for NSCAssert. * Log size test * [ios, macos] Add logging conditional compilation flag. * [ios, macos] Rename function NSStringFromMGLTransition to MGLStringFromMGLTransition. * [ios, macos] Remove verbose logging for release builds. * [ios, macos] Rename NSStringFromCLLocationCoordinate2D to MGLStringFromCLLocationCoordinate2D. * [ios, macos] Clean unnecesary blank lines in MGLLight.mm set methods. * [ios, macos] Fix logging grammar, format, function names. * [ios, macos] Remove compilation flag, rename flags.
95 lines
2.5 KiB
Objective-C
95 lines
2.5 KiB
Objective-C
#import <Foundation/Foundation.h>
|
|
|
|
#import "MGLFoundation.h"
|
|
|
|
#ifndef MGL_LOGGING_DISABLED
|
|
#ifndef MGL_LOGGING_ENABLE_DEBUG
|
|
#ifdef DEBUG
|
|
#define MGL_LOGGING_ENABLE_DEBUG 1
|
|
#endif
|
|
#endif
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/**
|
|
Constants indicating the message's logging level.
|
|
*/
|
|
typedef NS_ENUM(NSInteger, MGLLoggingLevel) {
|
|
/**
|
|
None-level messages are ignored.
|
|
*/
|
|
MGLLoggingLevelNone = 0,
|
|
/**
|
|
Info-level messages contain information that may be helpful for flow tracing
|
|
but is not essential.
|
|
*/
|
|
MGLLoggingLevelInfo,
|
|
#if MGL_LOGGING_ENABLE_DEBUG
|
|
/**
|
|
Debug-level messages contain information that may be helpful for troubleshooting
|
|
specific problems.
|
|
*/
|
|
MGLLoggingLevelDebug,
|
|
#endif
|
|
/**
|
|
Error-level messages contain information that is intended to aid in process-level
|
|
errors.
|
|
*/
|
|
MGLLoggingLevelError,
|
|
/**
|
|
Fault-level messages contain system-level error information.
|
|
*/
|
|
MGLLoggingLevelFault,
|
|
/**
|
|
:nodoc: Any new logging level should be included in the default logging implementation.
|
|
*/
|
|
};
|
|
|
|
/**
|
|
A block to be called once `loggingLevel` is set to a higher value than `MGLLoggingLevelNone`.
|
|
|
|
@param loggingLevel The message logging level.
|
|
@param filePath The description of the file and method for the calling message.
|
|
@param line The line where the message is logged.
|
|
@param message The logging message.
|
|
*/
|
|
typedef void (^MGLLoggingBlockHandler)(MGLLoggingLevel loggingLevel, NSString *filePath, NSUInteger line, NSString *message);
|
|
|
|
/**
|
|
The `MGLLoggingConfiguration` object provides a global way to set this SDK logging levels
|
|
and logging handler.
|
|
*/
|
|
MGL_EXPORT
|
|
@interface MGLLoggingConfiguration : NSObject
|
|
|
|
/**
|
|
The handler this SDK uses to log messages.
|
|
|
|
If this property is set to nil or if no custom handler is provided this property
|
|
is set to the default handler.
|
|
|
|
The default handler uses `os_log` and `NSLog` for iOS 10+ and iOS < 10 respectively.
|
|
*/
|
|
@property (nonatomic, copy, null_resettable) MGLLoggingBlockHandler handler;
|
|
|
|
/**
|
|
The logging level.
|
|
|
|
The default value is `MGLLoggingLevelNone`.
|
|
|
|
Setting this property includes logging levels less than or equal to the setted value.
|
|
*/
|
|
@property (assign, nonatomic) MGLLoggingLevel loggingLevel;
|
|
|
|
/**
|
|
Returns the shared logging object.
|
|
*/
|
|
@property (class, nonatomic, readonly) MGLLoggingConfiguration *sharedConfiguration;
|
|
|
|
- (MGLLoggingBlockHandler)handler UNAVAILABLE_ATTRIBUTE;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|
|
#endif
|