Работа с файловой системой в Swift: основы для начинающих

Работа с файловой системой в Swift: для начинающих

Работа с файловой системой — одна из ключевых задач при разработке приложений под iOS и macOS. Будь то сохранение пользовательских данных, кэширование изображений или экспорт документов, вам неизбежно придётся взаимодействовать с файлами и папками. В этой статье мы разберём основные инструменты Swift для работы с файловой системой, включая FileManager, пути к директориям, создание, чтение, запись и удаление файлов. Материал ориентирован на начинающих разработчиков, поэтому все примеры будут максимально простыми и понятными.

Основы: FileManager и пути

Главный класс для работы с файловой системой в Swift — FileManager. Это обёртка над стандартными системными вызовами, которая предоставляет удобный интерфейс для управления файлами и папками. Чаще всего используется его синглтон:

let fileManager = FileManager.default

Поскольку приложения в iOS и macOS работают в изолированной среде (песочнице), вам нужно знать, куда можно сохранять данные. Основные директории, к которым у приложения есть доступ:

• Documents — для пользовательских документов и данных, которые должны сохраняться между запусками.
• Caches — для временных файлов, которые система может удалить для освобождения места.
• Temporary — для временных файлов, которые гарантированно будут удалены при следующей перезагрузке устройства.
• Library/Application Support — для данных, которые не должны быть доступны пользователю напрямую, но должны сохраняться.

Получить путь к нужной директории можно с помощью метода urls(for:in:):

// Получаем путь к папке Documents
let documentsURL = fileManager.urls(for: .documentDirectory, in: .userDomainMask).first!
print("Documents path: \(documentsURL.path)")

// Получаем путь к папке Caches
let cachesURL = fileManager.urls(for: .cachesDirectory, in: .userDomainMask).first!
print("Caches path: \(cachesURL.path)")

// Получаем путь к временной папке
let tempURL = fileManager.temporaryDirectory
print("Temp path: \(tempURL.path)")

Обратите внимание: метод возвращает массив URL (на случай, если существует несколько путей), но для пользовательских директорий обычно берётся первый элемент. В современном Swift рекомендуется использовать URL, а не строковые пути, так как это безопаснее и удобнее.

Создание и запись файлов

Теперь, когда мы знаем, куда можно сохранять файлы, давайте научимся их создавать и записывать в них данные. Для записи текстовых данных проще всего использовать метод write(to:atomically:encoding:) класса String:

// Создаём путь к файлу в папке Documents
let fileURL = documentsURL.appendingPathComponent("myFile.txt")

// Текст для записи
let content = "Привет, мир! Это мой первый файл на Swift."

do {
    // Записываем строку в файл
    try content.write(to: fileURL, atomically: true, encoding: .utf8)
    print("Файл успешно создан: \(fileURL.path)")
} catch {
    print("Ошибка записи файла: \(error.localizedDescription)")
}

Параметр atomically: true означает, что данные сначала будут записаны во временный файл, а затем переименованы в целевой. Это защищает от повреждения файла в случае сбоя. Для бинарных данных (например, изображений) можно использовать Data:

// Создаём бинарные данные (например, массив байтов)
let data = Data([0x48, 0x65, 0x6C, 0x6C, 0x6F]) // "Hello" в ASCII

let binaryFileURL = documentsURL.appendingPathComponent("data.bin")

do {
    try data.write(to: binaryFileURL, options: .atomic)
    print("Бинарный файл создан")
} catch {
    print("Ошибка: \(error)")
}

Чтение файлов и проверка существования

Чтобы прочитать файл, нужно сначала проверить, существует ли он, а затем загрузить его содержимое. Для чтения текста используем инициализатор String(contentsOf:encoding:):

let fileURL = documentsURL.appendingPathComponent("myFile.txt")

// Проверяем, существует ли файл
if fileManager.fileExists(atPath: fileURL.path) {
    do {
        let text = try String(contentsOf: fileURL, encoding: .utf8)
        print("Содержимое файла: \(text)")
    } catch {
        print("Ошибка чтения файла: \(error)")
    }
} else {
    print("Файл не найден")
}

Для бинарных данных используем Data(contentsOf:):

let binaryFileURL = documentsURL.appendingPathComponent("data.bin")

if fileManager.fileExists(atPath: binaryFileURL.path) {
    do {
        let binaryData = try Data(contentsOf: binaryFileURL)
        print("Прочитано \(binaryData.count) байт")
        // Преобразуем обратно в строку для демонстрации
        if let str = String(data: binaryData, encoding: .utf8) {
            print("Как текст: \(str)")
        }
    } catch {
        print("Ошибка чтения: \(error)")
    }
}

Обратите внимание: чтение больших файлов синхронно может заблокировать главный поток, что приведёт к зависанию интерфейса. Для серьёзных проектов используйте асинхронные методы или фоновые очереди (например, DispatchQueue.global()).

Управление директориями и удаление файлов

Помимо работы с отдельными файлами, часто требуется создавать папки, перемещать файлы или удалять их. Рассмотрим основные операции.

Создание директории

let newDirURL = documentsURL.appendingPathComponent("MyFolder")

do {
    try fileManager.createDirectory(at: newDirURL, withIntermediateDirectories: true, attributes: nil)
    print("Папка создана: \(newDirURL.path)")
} catch {
    print("Ошибка создания папки: \(error)")
}

Параметр withIntermediateDirectories: true означает, что если в пути не хватает каких-то промежуточных папок, они будут созданы автоматически.

Перемещение и копирование файлов

let sourceURL = documentsURL.appendingPathComponent("myFile.txt")
let destinationURL = newDirURL.appendingPathComponent("myFile.txt")

// Перемещаем файл
do {
    try fileManager.moveItem(at: sourceURL, to: destinationURL)
    print("Файл перемещён")
} catch {
    print("Ошибка перемещения: \(error)")
}

//