Проверка типов загружаемых файлов iOS на облачном Mac

Проверка типов загружаемых файлов iOS на облачном Mac

Проверка типов загружаемых файлов iOS на облачном Mac

API загрузки в iOS сообщает об успехе, но вложение не открывается в окне предпросмотра. Иногда вместо файла приходит страница ошибки после истечения сеанса, иногда сервер помечает любое содержимое как универсальные двоичные данные, а иногда файл скачивается лишь наполовину. Чтобы воспроизвести такие проблемы на облачном Mac, необязательно сразу подключать реальный сервис. Сначала разделите три вопроса: какой тип заявлен, на какой формат похожи данные и удаётся ли полностью их разобрать. Настройте эти три уровня проверки на фиксированном наборе образцов, а затем подключите их к процессу загрузки.

Сначала определите допустимые форматы

Предположим, что точка приёма вложений допускает только PNG, JPEG и PDF. Правила должны определяться разрешённым списком форматов для конкретной задачи, а не догадками по имени файла. Имя можно показывать пользователю, но нельзя использовать для выбора парсера и тем более напрямую включать в путь сохранения на диск.

Порядок проверки такой: убедиться, что HTTP-статус соответствует контракту API, ограничить фактически принимаемый объём данных, сопоставить MIME-тип ответа с сигнатурой файла и лишь затем выполнить разбор средствами соответствующего формата. Content-Length — только одно из оснований для досрочного отказа. Ни отсутствие этого заголовка, ни заниженное значение не отменяют ограничение на суммарное число полученных байтов.

Совпадение сигнатуры означает лишь, что файл «похож на этот формат». Оно не подтверждает ни целостность, ни безопасность. Файл, содержащий только сигнатуру PNG, всё равно невозможно отобразить.

Если API явно возвращает универсальный двоичный MIME-тип, для этой точки входа можно настроить исключение. Не распространяйте такое послабление на все загрузки. В реализации ниже используется строгий режим: отсутствие MIME-типа или противоречие между ним и сигнатурой приводит к отказу.

Вынесите определение типа в чистую функцию

В терминале удалённого Mac создайте файл type-check.swift и сохраните в нём следующий код. Функция получает только начальные байты и MIME-тип, не обращается к сети и не читает пользовательский каталог. Благодаря этому её будет легко перенести в тестовый таргет приложения. Образцы в коде проверяют только правила классификации и не выдаются за корректные изображения или документы.

import Foundation

enum FileKind: String {
    case png, jpeg, pdf

    var mime: String {
        switch self {
        case .png: return "image/png"
        case .jpeg: return "image/jpeg"
        case .pdf: return "application/pdf"
        }
    }
}

enum TypeFailure: Error {
    case unknownHeader
    case missingMIME
    case conflictingMIME
}

func classify(
    prefix: Data,
    declaredMIME: String?
) throws -> FileKind {
    let bytes = Array(prefix.prefix(8))
    let kind: FileKind

    if bytes.starts(with: [137, 80, 78, 71, 13, 10, 26, 10]) {
        kind = .png
    } else if bytes.starts(with: [255, 216, 255]) {
        kind = .jpeg
    } else if bytes.starts(with: Array("%PDF-".utf8)) {
        kind = .pdf
    } else {
        throw TypeFailure.unknownHeader
    }

    guard let declaredMIME else {
        throw TypeFailure.missingMIME
    }

    let mime = declaredMIME
        .split(separator: ";", omittingEmptySubsequences: false)[0]
        .trimmingCharacters(in: .whitespacesAndNewlines)
        .lowercased()

    guard mime == kind.mime else {
        throw TypeFailure.conflictingMIME
    }
    return kind
}

struct Fixture {
    let head: [UInt8]
    let mime: String?
    let expected: FileKind?
}

let fixtures: [Fixture] = [
    .init(
        head: [137, 80, 78, 71, 13, 10, 26, 10],
        mime: "IMAGE/PNG; charset=binary",
        expected: .png
    ),
    .init(head: [255, 216, 255], mime: "image/jpeg", expected: .jpeg),
    .init(
        head: Array("%PDF-1.7".utf8),
        mime: "application/pdf",
        expected: .pdf
    ),
    .init(
        head: Array("<html>error".utf8),
        mime: "application/pdf",
        expected: nil
    ),
    .init(head: [137, 80, 78], mime: "image/png", expected: nil),
    .init(head: [255, 216, 255], mime: "image/png", expected: nil),
    .init(head: [255, 216, 255], mime: nil, expected: nil)
]

for (index, fixture) in fixtures.enumerated() {
    let actual = try? classify(
        prefix: Data(fixture.head),
        declaredMIME: fixture.mime
    )
    guard actual == fixture.expected else {
        fatalError("Fixture mismatch at index \(index)")
    }
}

Выполните xcrun swift type-check.swift. Если все результаты совпадут с ожидаемыми, программа завершится без вывода; при провале проверки она вернёт ненулевой код завершения. Здесь значения заголовка используются напрямую, чтобы проверить обработку регистра и параметров. Если приложение получает уже нормализованный MIME-тип, сохраняйте и исходный заголовок ответа для диагностики, но не записывайте в журнал поля аутентификации.

При подключении к загрузке не читайте файл целиком в память

При использовании задачи загрузки сначала проверьте ошибку задачи, статус ответа и наличие временного файла. Затем прочитайте через FileHandle не более восьми байтов и передайте их функции определения типа. Закройте файловый дескриптор с помощью defer. Не загружайте весь файл через Data(contentsOf:) только ради чтения сигнатуры: на больших вложениях простая проверка обернётся пиковым потреблением памяти.

При потоковом приёме накапливайте первые восемь байтов. Нельзя рассчитывать, что первый вызов обработчика уже содержит полную сигнатуру: границы поступающих фрагментов никак не связаны с границами структур формата. Если данных для определения типа пока недостаточно, дождитесь восьми байтов или окончания передачи и только затем делайте вывод.

Временный файл, предоставленный задачей загрузки, нужно своевременно переместить в промежуточный каталог, контролируемый приложением. Сгенерируйте внутреннее имя файла и переносите его в окончательное расположение только после успешной проверки. При сбое на любом этапе удаляйте промежуточный файл. Имя, заданное пользователем, допустимо использовать лишь для отображения после соответствующей обработки.

Добавьте второй набор образцов для проверки полного разбора

После успешного определения типа для изображения нужно создать источник через ImageIO и действительно получить из него изображение. Возможность прочитать размеры или создать источник ещё не гарантирует успешного декодирования. Сначала ограничьте ширину, высоту, общее число пикселей и количество кадров, затем запустите декодирование нужных кадров. Это не даст небольшому сжатому файлу развернуться в огромный объект в памяти.

Для PDF можно попробовать создать документ через PDFKit, проверить количество страниц, состояние шифрования и доступность нужных страниц. Если приложение должно формировать предпросмотр, действительно отрисуйте целевые страницы. Успешное создание объекта документа не означает, что каждая его страница отобразится корректно.

Подготовьте настоящие корректные файлы, а также их копии, в которых оставлена только сигнатура, обрезан конец или изменены байты в середине. Не все усечённые образцы обязательно будут отвергнуты низкоуровневым парсером: некоторые парсеры допускают ошибки. Поэтому тесты должны проверять, удаётся ли выполнить требуемую приложению операцию, а не исходить из предположения, что любое изменение байтов обязано приводить к отказу.

Фиксируйте причины отказа так, чтобы их можно было локализовать

После подключения к тестовому таргету проекта отдельно сообщайте о сбое передачи, неизвестном формате, противоречии в объявленном типе, превышении квоты и ошибке разбора. Не сводите всё к сообщению «файл повреждён», иначе ошибка настройки MIME на сервере смешается с проблемой декодирования на клиенте.

При каждом регрессионном прогоне сохраняйте идентификатор образца, фактическое число байтов, нормализованный MIME-тип, предполагаемый тип файла и этап обработки. По возможности используйте искусственно созданные файлы без конфиденциального содержимого. Если проблемное вложение содержит рабочие данные, оно не должно автоматически отправляться вместе с отчётом о тестировании.

В конце проверьте три вещи: страницы ошибок не попадают в просмотрщик, усечённые образцы не считаются файлами с подтверждённой целостностью, а после неудачных операций в окончательном расположении не остаются вложения. Облачный Mac используется для запуска фиксированного набора образцов и сценария в симуляторе; потребление памяти при работе с большими файлами на реальном устройстве по-прежнему требует отдельной проверки. Фиксируйте эти результаты раздельно, чтобы точно понимать, что именно подтверждает этот контроль.

Часто задаваемые вопросы

Нужно ли автоматически исправлять несовпадение MIME и сигнатуры?

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

Доказывает ли правильная сигнатура целостность файла?

Нет. Усечённый файл может сохранить сигнатуру. Для изображений нужна проверка полного декодирования, для PDF — разбор и необходимые приложению проверки страниц.

Пусть ваш проект решит, какой Mac арендовать

Для нативной сборки и отладки в симуляторе арендуйте выделенный Mac с Apple Silicon и проверьте проект. Если вы разрабатываете постоянно и работаете в одном месте, сравните аренду с покупкой. Аренда на день даёт больше гибкости, а при длительном использовании рассмотрите оплату за месяц или квартал.

Арендовать удалённый Mac

Следующий шаг — выберите тариф под этап проекта

Сначала изучите модели, сроки аренды и способы подключения, а затем решите, подходит ли вам аренда.