iOS Disk Management and Cleanup Strategies for App Development

This article provides a comprehensive guide to disk management in iOS app development, focusing on the iOS sandbox environment and cleanup strategies.

1. iOS Sandbox System Overview

The iOS sandbox is a security mechanism where each app has an independent file system. The sandbox contains four main directories: MyApp.app (read-only, contains the app bundle), Documents (user-generated content, backed up to iCloud), Library (non-user data, contains Caches and Application Support subdirectories), and tmp (temporary files, not backed up to iCloud).

2. File Storage Specifications

The article details proper usage of each directory. Documents should only contain files meant to be exposed to users. Library/Caches stores regeneratable data like image caches and is not backed up to iCloud. Library/Application Support stores configuration and data files. tmp should only store temporary data that can be deleted after use.

3. Directory Access APIs

The article provides code examples for accessing sandbox directories:

// Get sandbox home directory
NSString *homeDir = NSHomeDirectory();
// Get Documents directory
NSString *docDir = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];
// Get Library directory
NSString *libDir = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) lastObject];
// Get Caches directory
NSString *cachesDir = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) firstObject];
// Get tmp directory
NSString *tmpDir = NSTemporaryDirectory();

4. Disk Size Calculation

To calculate actual disk space usage, the st_blocks from stat.h is used:

+ (unsigned long long)fileSizeOnDisk:(nonnull NSString *)filePath {
struct stat fileStat;
int res = stat([filePath cStringUsingEncoding:NSUTF8StringEncoding], &fileStat);
if (-1 == res) {
return 0;
}
long long fileSize = fileStat.st_blocks / 8 * fileStat.st_blksize;
return fileSize ;
}

5. iCloud Backup Configuration

To exclude files from iCloud backup, developers can use NSURLIsExcludedFromBackupKey:

NSURL *pathurl = [NSURL fileURLWithPath:path];
BOOL success = NO;
success = [pathurl setResourceValue:@(YES) forKey:NSURLIsExcludedFromBackupKey error:nil];

6. Disk Cleanup Strategies

Automatic Cleanup: Implements business quotas and disk level monitoring (Normal, Warning, Critical). Triggers cleanup based on disk level changes, app version upgrades, or time intervals.

Manual Cleanup: Provides user interface for manual cleanup and user asset management (downloaded files like videos, images, PDFs).

System Cache Cleanup:

tmp directory: Contains CFNetworkDownload_*.tmp, WKWebFileUpload-*, NSIRD_*, and WebKit cache files

WKWebView cleanup: Uses WKWebsiteDataStore to clean cookies, localStorage, disk cache, etc.

dyld cache: iOS 13 and earlier versions create cache in tmp/com.apple.dyld that needs manual cleanup

The article concludes that a combination of automatic and manual cleanup mechanisms, along with proper understanding of iOS file system behavior, provides the best disk management solution for comprehensive apps.