Удаление устаревших журналов

Удаляйте сохранённые журналы старше указанного числа дней или созданные до заданной даты.

Предварительные условия

• Активный сервис журналирования использует постоянное хранилище.
• При удалении по возрасту значение maxAge больше нуля.

API Reference

Framework

AIBudsLog.xcframework

Declaration

Swift

Swift

/// Purges log messages older than the specified maximum age.
/// - Parameters:
///   - maxAge: Retention age in days.
///   - completion: Called with an error, or `nil` on success.
func purgeOldLogsWithMaxAge(_ maxAge: Int, completion: ((_ error: NSError?) -> Void)?)

/// Purges log messages earlier than the specified timestamp.
/// - Parameters:
///   - timestamp: The exclusive cutoff date for retained logs.
///   - completion: Called with an error, or `nil` on success.
func purgeOldLogsBefore(_ timestamp: Date, completion: ((_ error: NSError?) -> Void)?)

Objective-C

Objective-C

/// Purges log messages older than the specified maximum age.
- (void)purgeOldLogsWithMaxAge:(NSInteger)maxAge
                    completion:(void (^ _Nullable)(NSError * _Nullable))completion;

/// Purges log messages earlier than the specified timestamp.
- (void)purgeOldLogsBefore:(NSDate * _Nonnull)timestamp
                completion:(void (^ _Nullable)(NSError * _Nullable))completion;

См. purgeOldLogsWithMaxAge и purgeOldLogsBefore.

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

Swift

Swift

let retentionDays = 7

AIBudsLogSDK.logService.purgeOldLogsWithMaxAge(retentionDays) { error in
    DispatchQueue.main.async {
        if let error {
            statusLabel.text = "Cleanup failed: \(error.localizedDescription)"
            return
        }
        statusLabel.text = "Logs older than \(retentionDays) days were deleted"
    }
}

Удаление по заданной граничной дате:

Swift

let cutoff = Calendar.current.date(byAdding: .day, value: -7, to: Date())!
AIBudsLogSDK.logService.purgeOldLogsBefore(cutoff) { error in
    if let error { print(error.localizedDescription) }
}

Objective-C

Objective-C

NSInteger retentionDays = 7;

[AIBudsLogSDK.logService
    purgeOldLogsWithMaxAge:retentionDays
                completion:^(NSError *error) {
                    dispatch_async(dispatch_get_main_queue(), ^{
                        if (error != nil) {
                            self.statusLabel.text = [NSString
                                stringWithFormat:@"Cleanup failed: %@", error.localizedDescription];
                            return;
                        }
                        self.statusLabel.text = @"Expired logs were deleted";
                    });
                }];

Удаление по заданной граничной дате:

Objective-C

NSDate *cutoff = [[NSCalendar currentCalendar] dateByAddingUnit:NSCalendarUnitDay
                                                          value:-7
                                                         toDate:[NSDate date]
                                                        options:0];
[AIBudsLogSDK.logService purgeOldLogsBefore:cutoff
                                 completion:^(NSError *error) {
                                     if (error != nil) {
                                         NSLog(@"%@", error.localizedDescription);
                                     }
                                 }];

Примечания

• При загрузке плагина AIBudsLogSDK.setXLFacilityPlugin(_:) автоматически удаляет журналы XLFacility согласно текущему logFileMaxAge.
• Изменение logFileMaxAge настраивает срок хранения, но не запускает очистку немедленно. Для немедленного удаления вызовите метод очистки.
• Очистка затрагивает сохранённые данные активного сервиса. Вывод консоли и OS Logger не относится к хранилищам, которыми управляет приложение.
• Определяйте результат по completion callback, а не предполагайте, что фоновая очистка завершилась успешно.